javax.security.sasl
Class AuthorizeCallback

java.lang.Object
  |
  +--javax.security.sasl.AuthorizeCallback
All Implemented Interfaces:
javax.security.auth.callback.Callback, Serializable

public class AuthorizeCallback
extends Object
implements javax.security.auth.callback.Callback, Serializable

This callback is used by SaslServer to determine whether one entity (identified by an authenticated authentication id) can act on behalf of another entity (identified by an authorization id).

See Also:
Serialized Form

Constructor Summary
AuthorizeCallback(String authnID, String authzID)
          Constructs an instance of AuthorizeCallback.
 
Method Summary
 String getAuthenticationID()
          Returns the authentication id to check
 String getAuthorizationID()
          Returns the authorization id to check
 String getAuthorizedID()
          Returns the id of the authorized user
 boolean isAuthorized()
          Determines if the identity represented by authentication id is allowed to act on behalf of the authorization id
 void setAuthorized(boolean authorized)
          Sets if authorization is allowed or not
 void setAuthorizedID(String id)
          Sets the id of the authorized entity.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AuthorizeCallback

public AuthorizeCallback(String authnID,
                         String authzID)
Constructs an instance of AuthorizeCallback.

Parameters:
authnID - The (authenticated) authentication id
authzID - The authorization id
Method Detail

getAuthenticationID

public String getAuthenticationID()
Returns the authentication id to check

Returns:
The authentication id to check

getAuthorizationID

public String getAuthorizationID()
Returns the authorization id to check

Returns:
The authentication id to check

isAuthorized

public boolean isAuthorized()
Determines if the identity represented by authentication id is allowed to act on behalf of the authorization id

Returns:
true if authorization is allowed; false otherwise
See Also:
setAuthorized(boolean), getAuthorizedID()

setAuthorized

public void setAuthorized(boolean authorized)
Sets if authorization is allowed or not

Parameters:
authorized - true if authorization is allowed; false otherwise
See Also:
isAuthorized(), setAuthorizedID(java.lang.String)

getAuthorizedID

public String getAuthorizedID()
Returns the id of the authorized user

Returns:
The id of the authorized user. null means the authorization failed.
See Also:
setAuthorized(boolean), setAuthorizedID(java.lang.String)

setAuthorizedID

public void setAuthorizedID(String id)
Sets the id of the authorized entity. Called by handler only when the id is different from getAuthorizationID(). For example, the id might need to be canonicalized for the environment in which it will be used.

See Also:
setAuthorized(boolean), getAuthorizedID()