Class AuthorizeCallback

java.lang.Object

javax.security.sasl.AuthorizeCallback

All Implemented Interfaces:

Serializable, Callback

public class AuthorizeCallback
extends Object
implements 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).

Since:

1.5

See Also:

• Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
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 whether the authentication id is allowed to act on behalf of the authorization id.
void	setAuthorized(boolean ok)	Sets whether the authorization is allowed.
void	setAuthorizedID(String id)	Sets the id of the authorized entity.

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

AuthorizeCallback

public AuthorizeCallback(String authnID,
 String authzID)

Constructs an instance of AuthorizeCallback.

Parameters:

authnID - The (authenticated) authentication id.

authzID - The authorization id.

Method Details

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 whether the 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 ok)

Sets whether the authorization is allowed.

Parameters:

ok - 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.

Parameters:

id - The id of the authorized user.

See Also:

• setAuthorized(boolean)
• getAuthorizedID()