com.iplanet.sso

Interface SSOToken

public interface SSOToken

The SSOToken class represents a "single sign on"(SSO) token. It contains SSO token-related information such as authentication method used for authentication, authentication level of the authentication method, host name of the client that sent the request (browser). It also contains session-related information such as maximum session time, maximum session idle time and session idle time.

Method Summary

Modifier and Type	Method and Description
void	addSSOTokenListener(SSOTokenListener listener) Adds an SSO token listener for the token change events.
String	dereferenceRestrictedTokenID(SSOToken requester, String restrictedId) Given a restricted token, returns the SSOTokenID of the master token can only be used if the requester is an app token.
int	getAuthLevel() Returns the authentication level of the authentication method used for authentication.
String	getAuthType() Returns the authentication method used for authentication.
String	getHostName() Returns the host name of the client (browser) that sent the request.
long	getIdleTime() Returns the session idle time in seconds.
InetAddress	getIPAddress() Returns the IP Address of the client (browser) that sent the request.
long	getMaxIdleTime() Returns the maximum session idle time in minutes.
long	getMaxSessionTime() Returns the maximum session time in minutes.
Principal	getPrincipal() Returns the value of the property "Principal" set to the single sign on token.
Map<String,String>	getProperties() Get an unmodifiable map of all properties stored in this token.
String	getProperty(String name) Gets the property stored in this token.
String	getProperty(String name, boolean ignoreState) Gets the property stored in this token.
long	getTimeLeft() Returns the time left in seconds on the session based on max session time.
SSOTokenID	getTokenID() Returns single sign on token ID object.
boolean	isTokenRestricted() Returns true if the SSOTokenID associated with this SSOToken is a restricted token, false otherwise.
void	setProperty(String name, String value) Sets a property for this token.

Method Detail

getPrincipal

Principal getPrincipal()
                throws SSOException

Returns the value of the property "Principal" set to the single sign on token.

Returns:

The principal name.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the principal.

getAuthType

String getAuthType()
            throws SSOException

Returns the authentication method used for authentication.

Returns:

The authentication method.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the authentication method.

getAuthLevel

int getAuthLevel()
          throws SSOException

Returns the authentication level of the authentication method used for authentication.

Returns:

The authentication level.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the authentication level.

getIPAddress

InetAddress getIPAddress()
                  throws SSOException

Returns the IP Address of the client (browser) that sent the request.

Returns:

The IP Address of the client.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the IP Address of the client.

getHostName

String getHostName()
            throws SSOException

Returns the host name of the client (browser) that sent the request.

Returns:

The host name of the client.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the host name of the client.

getTimeLeft

long getTimeLeft()
          throws SSOException

Returns the time left in seconds on the session based on max session time.

Returns:

The time left in seconds on the session.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the maximum session time.

getMaxSessionTime

long getMaxSessionTime()
                throws SSOException

Returns the maximum session time in minutes.

Returns:

The maximum session time in minutes.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the maximum session time.

getIdleTime

long getIdleTime()
          throws SSOException

Returns the session idle time in seconds.

Returns:

The session idle time in seconds.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the session idle time.

getMaxIdleTime

long getMaxIdleTime()
             throws SSOException

Returns the maximum session idle time in minutes.

Returns:

The maximum session idle time in minutes

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the maximum idle time.

getTokenID

SSOTokenID getTokenID()

Returns single sign on token ID object.

Returns:

single sign on token ID.

setProperty

void setProperty(String name,
                 String value)
          throws SSOException

Sets a property for this token.

Parameters:

name - The property name.

value - The property value.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in setting the property name and value.

getProperty

String getProperty(String name)
            throws SSOException

Gets the property stored in this token.

Parameters:

name - The property name.

Returns:

The property value in string format.

Throws:

SSOException - if the single sign on token is not valid or if there are errors in getting the property value.

getProperty

String getProperty(String name,
                   boolean ignoreState)
            throws SSOException

Gets the property stored in this token. When ignoreState is set to true, it will return the session property value without refreshing the session even if the session state is invalid but it should be running in the server mode.

Parameters:

name - The property name.

ignoreState - The ignoreState flag.

Returns:

The property value in string format.

Throws:

SSOException - if the SSOToken is not VALID and if ignoreState is set to false.

getProperties

Map<String,String> getProperties()
                          throws SSOException

Get an unmodifiable map of all properties stored in this token.

Returns:

Unmodifiable map of all property values.

Throws:

SSOException - if the SSOToken was invalid or failed to be validated.

addSSOTokenListener

void addSSOTokenListener(SSOTokenListener listener)
                  throws SSOException

Adds an SSO token listener for the token change events.

Parameters:

listener - A reference to a SSOTokenListener object.

Throws:

SSOException - if the token is not valid or if there are errors in setting the SSO token listener.

isTokenRestricted

boolean isTokenRestricted()
                   throws SSOException

Returns true if the SSOTokenID associated with this SSOToken is a restricted token, false otherwise.

Returns:

true if the token is restricted.

Throws:

SSOException - If we are unable to determine if the session is restricted.

dereferenceRestrictedTokenID

String dereferenceRestrictedTokenID(SSOToken requester,
                                    String restrictedId)
                             throws SSOException

Given a restricted token, returns the SSOTokenID of the master token can only be used if the requester is an app token.

Parameters:

requester - Must be an app token

restrictedId - The SSOTokenID of the restricted token

Returns:

The SSOTokenID string of the master token

Throws:

SSOException - If the master token cannot be dereferenced