iaik.apps.util.passphrase

Class NewPassphraseConsoleDialog

java.lang.Object

iaik.apps.util.passphrase.NewPassphraseConsoleDialog

All Implemented Interfaces:

NewPassphrasePrompt, PassphraseInterfacce

public class NewPassphraseConsoleDialog
extends java.lang.Object
implements NewPassphrasePrompt

A dialog for prompting a new passphrase via the console.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	cancelAllowed_ Indicates if this passphrase dialog can be canceled by the user with entering a password
protected java.io.BufferedReader	input_ The stream to read the user input from.
static java.lang.String	LINE_SEPARATOR
protected java.lang.String	message_ Message in this dialog
protected boolean	oldPassphraseRequired_ Indicates if the old passphrase is required.
protected java.io.PrintWriter	output_ The stream the write the prompt messages to.
protected java.lang.Object	protectedResourceInfo_ Object specifying the protected resource; e.g.
protected static java.util.ResourceBundle	res_ Used to read strings from (internationalization)
protected java.lang.String	title_ Title of this dialog

Constructor Summary

Constructors

Constructor and Description
NewPassphraseConsoleDialog() default constructor

Method Summary

Modifier and Type	Method and Description
boolean	isCancelAllowed() True, if this prompt can be canceled by the user; i.e.
char[][]	promptNewPassphrase() Prompt the new passphrase and the old passphrase if required from the user.
void	setCancelAllowed(boolean allowCancel) Set this prompt object to allow cancelling or not.
void	setMessage(java.lang.Object promptMessageObject) Set the prompt object that should be presented to the user as information what passphrase is required.
void	setOldPassphraseRequired(boolean oldPassphraseRequired) Set if the use must enter the old passphrase in addition to the new.
void	setProtectedResourceInfo(java.lang.Object protectedResourceInfo) Set the object that specifies the protectd resource; i.e.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LINE_SEPARATOR

public static final java.lang.String LINE_SEPARATOR

res_

protected static java.util.ResourceBundle res_

Used to read strings from (internationalization)

title_

protected java.lang.String title_

Title of this dialog

message_

protected java.lang.String message_

Message in this dialog

protectedResourceInfo_

protected java.lang.Object protectedResourceInfo_

Object specifying the protected resource; e.g. smart card

cancelAllowed_

protected boolean cancelAllowed_

Indicates if this passphrase dialog can be canceled by the user with entering a password

oldPassphraseRequired_

protected boolean oldPassphraseRequired_

Indicates if the old passphrase is required.

output_

protected java.io.PrintWriter output_

The stream the write the prompt messages to.

input_

protected java.io.BufferedReader input_

The stream to read the user input from.

Constructor Detail

NewPassphraseConsoleDialog

public NewPassphraseConsoleDialog()

default constructor

Method Detail

setOldPassphraseRequired

public void setOldPassphraseRequired(boolean oldPassphraseRequired)

Description copied from interface: NewPassphrasePrompt

Set if the use must enter the old passphrase in addition to the new.

Specified by:

setOldPassphraseRequired in interface NewPassphrasePrompt

Parameters:

oldPassphraseRequired - True, the use must enter the old passphrase in addition to the new.

promptNewPassphrase

public char[][] promptNewPassphrase()

Description copied from interface: NewPassphrasePrompt

Prompt the new passphrase and the old passphrase if required from the user. Display the prompt message to him. Block, until user has finished. If user is allowed to cancel the dialog, and the user cancels the dialog, then return null.

Specified by:

promptNewPassphrase in interface NewPassphrasePrompt

Returns:

An arrray of two char arrays. The first array is the old passphrase or null, if this has not been requested. The second is the new passphrase. This is null, if the user canceled the input.

isCancelAllowed

public boolean isCancelAllowed()

True, if this prompt can be canceled by the user; i.e. the user need not enter a passphrase.

Specified by:

isCancelAllowed in interface PassphraseInterfacce

Returns:

True, if this prompt can be canceled without entering a passphrase.

Postconditions:

((result == false) implies (promptPassphrase() <> null))

setCancelAllowed

public void setCancelAllowed(boolean allowCancel)

Set this prompt object to allow cancelling or not.

Specified by:

setCancelAllowed in interface PassphraseInterfacce

Parameters:

allowCancel - If true, canceling the prompt is allowed.

Postconditions:

(allowedCancel == false) implies (promptPassphrase() <> null)

setMessage

public void setMessage(java.lang.Object promptMessageObject)

Set the prompt object that should be presented to the user as information what passphrase is required. It is recommended that the toString() method of this object provides a telling output for the user. If the implementation knows the concrete class of the object it may use different means to create a message from the given object.

Specified by:

setMessage in interface PassphraseInterfacce

Parameters:

promptMessageObject - The object from which the implementation can get a human readable string that gives information what passphrase the user should enter.

setProtectedResourceInfo

public void setProtectedResourceInfo(java.lang.Object protectedResourceInfo)

Set the object that specifies the protectd resource; i.e. the resource to which the user needs to authenticate; e.g. the name of the smart card for which a PIN is required. The PKCS#11 provider may provide a TokenInfo object.

Specified by:

setProtectedResourceInfo in interface PassphraseInterfacce

Parameters:

protectedResourceInfo - The object that specifies the protected resource in more detail; e.g. the smart card. The PKCS#11 provider may provide a TokenInfo object.