|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Defines Java API for setting and getting context options and delegation extensions as defined in the
GSS-API Extensions document.
Some of the functions might not specify all the parameters as in the document.
Notes:
ExtendedGSSContext client = .... ExtendedGSSContext server = .... byte [] input = new byte[0]; byte [] output = null; do { output = client.initDelegation(null, null, 0, input, 0, input.length); input = server.acceptDelegation(0, output, 0, output.length); } while (!client.isDelegationFinished()); GSSCredential cred = server.getDelegatedCredential(); ...Because delegation can be performed multiple times on the same contexts, the
do { ... } while ();
block should be used to properly reset the delegation state (The state of isDelegationFinished
is reset on the initial call to initDelegation
or acceptDelegation
.
Field Summary |
Fields inherited from interface org.ietf.jgss.GSSContext |
DEFAULT_LIFETIME, INDEFINITE_LIFETIME |
Method Summary | |
byte[] |
acceptDelegation(int lifetime,
byte[] but,
int off,
int len)
Accept a delegated credential. |
GSSCredential |
getDelegatedCredential()
Returns the delegated credential that was delegated using the initDelegation and acceptDelegation
functions. |
Object |
getOption(Oid option)
Gets a context option. |
byte[] |
initDelegation(GSSCredential cred,
Oid mechanism,
int lifetime,
byte[] buf,
int off,
int len)
Initiate the delegation of a credential. |
Object |
inquireByOid(Oid oid)
Retrieves arbitrary data about this context. |
boolean |
isDelegationFinished()
Used during delegation to determine the state of the delegation. |
void |
setOption(Oid option,
Object value)
Sets a context option. |
Methods inherited from interface org.ietf.jgss.GSSContext |
acceptSecContext, acceptSecContext, dispose, export, getAnonymityState, getConfState, getCredDelegState, getDelegCred, getIntegState, getLifetime, getMech, getMIC, getMIC, getMutualAuthState, getReplayDetState, getSequenceDetState, getSrcName, getTargName, getWrapSizeLimit, initSecContext, initSecContext, isEstablished, isInitiator, isProtReady, isTransferable, requestAnonymity, requestConf, requestCredDeleg, requestInteg, requestLifetime, requestMutualAuth, requestReplayDet, requestSequenceDet, setChannelBinding, unwrap, unwrap, verifyMIC, verifyMIC, wrap, wrap |
Method Detail |
public void setOption(Oid option, Object value) throws GSSException
option
- option type.value
- option value.
GSSException
- containing the following major error codes:
GSSException.FAILURE
public Object getOption(Oid option) throws GSSException
option
- option type.
GSSException
- containing the following major error codes:
GSSException.FAILURE
public byte[] initDelegation(GSSCredential cred, Oid mechanism, int lifetime, byte[] buf, int off, int len) throws GSSException
acceptDelegation
function.
cred
- The credential to be delegated. May be null
in which case the credential associated with the security
context is used.mechanism
- The desired security mechanism. May be null.lifetime
- The requested period of validity (seconds) of the delegated
credential.
acceptDelegation
if
isDelegationFinished
returns false. May be null.
GSSException
- containing the following major error codes:
GSSException.FAILURE
public byte[] acceptDelegation(int lifetime, byte[] but, int off, int len) throws GSSException
initDelegation
function.
lifetime
- The requested period of validity (seconds) of the delegated
credential.
initDelegation
if
isDelegationFinished
returns false. May be null.
GSSException
- containing the following major error codes:
GSSException.FAILURE
public GSSCredential getDelegatedCredential()
initDelegation
and acceptDelegation
functions. This is to be called on the delegation accepting
side once once isDelegationFinished
returns true.
public boolean isDelegationFinished()
public Object inquireByOid(Oid oid) throws GSSException
oid
- the oid of the information desired.
GSSException
- containing the following major error codes:
GSSException.FAILURE
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |