|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.wsspi.wssecurity.auth.token.WSSToken
com.ibm.wsspi.wssecurity.auth.token.UsernameToken
public class UsernameToken
This class is a token object implementation for a username token that stores the username and
password information of the token.
It extends the WSSToken
class, which implements the Token
class.
It will typically be created by the UsernameTokenGenerator
and process by the
UsernameTokenConsumer
.
Protected by following Java 2 Security Permissions:
com.ibm.websphere.security.WebSphereRuntimePermission("wssecurity.UsernameToken.setUsername")
com.ibm.websphere.security.WebSphereRuntimePermission("wssecurity.UsernameToken.getPassword")
com.ibm.websphere.security.WebSphereRuntimePermission("wssecurity.UsernameToken.setPassword")
com.ibm.websphere.security.WebSphereRuntimePermission("wssecurity.UsernameToken.setExpiration")
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.ibm.wsspi.wssecurity.auth.token.WSSToken |
---|
WSSToken.AttributesEnumerator |
Field Summary |
---|
Fields inherited from class com.ibm.wsspi.wssecurity.auth.token.WSSToken |
---|
_attributes, _callerChecked, _error, _keyInfoType, _processed, _referenced, _tokenelem, _tokenId, _trusted, _usedTokenConsumer, _usedTokenGenerator, _usedToLogin, _version, _vtype |
Constructor Summary | |
---|---|
UsernameToken(java.lang.String tokenId,
java.lang.String username,
char[] password)
Constructor using a username and password. |
|
UsernameToken(java.lang.String tokenId,
java.lang.String username,
char[] password,
org.w3c.dom.Element elem)
Constructor using a username, password and token element. |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object o)
|
java.util.Date |
getDate()
Returns created date. |
long |
getExpiration()
This returns the expiration time in milli-seconds. |
char[] |
getPassword()
Returns the password char array. |
java.lang.String |
getPrincipal()
Gets the principal that this Token belongs to. |
java.lang.String |
getUniqueID()
Returns a unique identifier of the token based upon information that the provider considers to be unique. |
java.lang.String |
getUsername()
Returns the username string. |
int |
hashCode()
|
boolean |
isValid()
Called by the runtime to determine if a token is valid still in terms of expiration, digital signature, etc. |
void |
setDate(java.util.Date date)
Sets created date. |
void |
setExpiration(long expiration)
|
void |
setPassword(char[] password)
Sets the password string. |
void |
setUsername(java.lang.String username)
Sets the username string. |
java.lang.String |
toString()
|
Methods inherited from class com.ibm.wsspi.wssecurity.auth.token.WSSToken |
---|
addAttribute, clone, getAttributeNames, getAttributes, getBytes, getCallerChecked, getElement, getError, getId, getKeyInfoType, getName, getType, getUsedTokenConsumer, getUsedTokenGenerator, getUsedToLogin, getVersion, isForwardable, isProcessed, isReadOnly, isReferenced, isTrusted, setCallerChecked, setElement, setError, setId, setKeyInfoType, setProcessed, setReadOnly, setReferenced, setTrusted, setType, setType, setUsedTokenConsumer, setUsedTokenGenerator, setUsedToLogin |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public UsernameToken(java.lang.String tokenId, java.lang.String username, char[] password)
tokenId
- The token IDusername
- The username stringpassword
- The password as a char[]; may be null if the token does not have a passwordpublic UsernameToken(java.lang.String tokenId, java.lang.String username, char[] password, org.w3c.dom.Element elem)
tokenId
- The token IDusername
- The username stringpassword
- The password as a char[]; may be null if the token does not have a passwordelem
- The token elementMethod Detail |
---|
public void setDate(java.util.Date date)
date
- The created datepublic java.util.Date getDate()
public void setUsername(java.lang.String username)
public java.lang.String getUsername()
public void setPassword(char[] password)
public char[] getPassword()
public long getExpiration()
Token
This returns the expiration time in milli-seconds.
public void setExpiration(long expiration)
expiration
- Protected by Java 2 Security permission com.ibm.websphere.security.WebSphereRuntimePermission("wssecurity.UsernameToken.setExpiration")public java.lang.String getPrincipal()
Token
Gets the principal that this Token belongs to. If this is an authorization token, this principal string must match the authentication token principal string or the message will be rejected. CSIv2 has stringent rules about validating authorization tokens using either the Identity Token or Authentication Token principal.
public java.lang.String getUniqueID()
Token
Returns a unique identifier of the token based upon information that the provider considers to be unique. This will be used for caching purposes and may be used in combination with other token unique IDs that are part of the same Subject to form a Subject unique identifier.
An implementation of this method should be careful to only change the token uniqueness when required. Any login which generates a new unique ID will create a Subject entry in the cache, which will increase memory requirements.
This method should return null if the token does not need to affect the cache uniqueness. Typically, if using only static registry attributes, this should return null. However, if dynamic attributes are used including strength of authentication, time of day, etc. you may affect the cache uniqueness by returning a non-null value that reflects how you want the cache key too look. Typically, the token implementation will know what is most unique about the dynamic data, however, an alternative is to return a UUID. The values of getUniqueID() from all custom tokens present in the Subject will be added together and used in the SSO token for lookup. A one-way hash of this string will be created as the unique ID. When altering a token to contain a non-null value here, the token must be added to the Subject prior to the commit phase or before the wsMap module commit is called.
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object o)
equals
in class java.lang.Object
public boolean isValid()
Token
Called by the runtime to determine if a token is valid still in terms of expiration, digital signature, etc. The implementation determines what valid means. If this returns false to the WebSphere runtime, an exception will be thrown (appropriate to where the call was made, e.g., NO_PERMISSION, WSLoginFailedException, etc.) and the request will be rejected.
public java.lang.String toString()
toString
in class java.lang.Object
|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |