org.openuat.apps
Class OpenUATtoolkit.TempHandler

java.lang.Object
  org.openuat.apps.OpenUATtoolkit.TempHandler

All Implemented Interfaces:

AuthenticationProgressHandler, KeyManager.VerificationHandler

Enclosing class:

OpenUATtoolkit

protected static class OpenUATtoolkit.TempHandler
extends java.lang.Object
implements AuthenticationProgressHandler, KeyManager.VerificationHandler

Handles the authentication steps

Method Summary

void	AuthenticationFailure(java.lang.Object sender, java.lang.Object remote, java.lang.Exception e, java.lang.String msg) Upon authentication failure, an exception might have been thrown and a message might have been created.
void	AuthenticationProgress(java.lang.Object sender, java.lang.Object remote, int cur, int max, java.lang.String msg) This event is raised during the authentication protocol to indicate progress.
boolean	AuthenticationStarted(java.lang.Object sender, java.lang.Object remote) This event is raised when the authentication protocol is started, to indicate that further events might follow.
void	AuthenticationSuccess(java.lang.Object sender, java.lang.Object remote, java.lang.Object result) When the key exchange algorithm has finished, the key verification phase using an out-of-band channel starts.
void	startVerification(byte[] sharedAuthenticationKey, java.lang.String optionalParam, RemoteConnection toRemote) Starts the key verification process using our of band channels.

Methods inherited from class java.lang.Object

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

Method Detail

AuthenticationFailure

public void AuthenticationFailure(java.lang.Object sender,
                                  java.lang.Object remote,
                                  java.lang.Exception e,
                                  java.lang.String msg)

Description copied from interface: AuthenticationProgressHandler

Upon authentication failure, an exception might have been thrown and a message might have been created.

Specified by:

AuthenticationFailure in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

e - Reason for the failue, can be null.

msg - Reaseon for the failue, can be null

AuthenticationProgress

public void AuthenticationProgress(java.lang.Object sender,
                                   java.lang.Object remote,
                                   int cur,
                                   int max,
                                   java.lang.String msg)

Description copied from interface: AuthenticationProgressHandler

This event is raised during the authentication protocol to indicate progress.

Specified by:

AuthenticationProgress in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed.

cur - The current stage in the authentication.

max - The maximum number of stages.

msg - If not null, a message describing the last successful stage.

AuthenticationStarted

public boolean AuthenticationStarted(java.lang.Object sender,
                                     java.lang.Object remote)

Description copied from interface: AuthenticationProgressHandler

This event is raised when the authentication protocol is started, to indicate that further events might follow.

Specified by:

AuthenticationStarted in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed. Depends on the sender of the event.

Returns:

true if the handler accepts this authentication to be started, false to "veto" it. If any of the registered handlers (which are called in the order in which they were registered) returns false, the (incoming or outgoing) authentication is aborted.

AuthenticationSuccess

public void AuthenticationSuccess(java.lang.Object sender,
                                  java.lang.Object remote,
                                  java.lang.Object result)

When the key exchange algorithm has finished, the key verification phase using an out-of-band channel starts. This method implements the verification for several channels: audio, visual, and manual verification of melody and sentence. The hash of the established session key is computed. For verification only the first bytes are used.

Specified by:

AuthenticationSuccess in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed. Depends on the sender of the event.

result - The result, if any, of the successful authentication. This can e.g. be a shared key or a set of keys or can even be null if the authentication event is enough to signal successful authentication.

startVerification

public void startVerification(byte[] sharedAuthenticationKey,
                              java.lang.String optionalParam,
                              RemoteConnection toRemote)

Starts the key verification process using our of band channels.

Specified by:

startVerification in interface KeyManager.VerificationHandler