org.gridforum.jgss
Interface ExtendedGSSCredential
- All Superinterfaces:
- java.lang.Cloneable, org.ietf.jgss.GSSCredential
public interface ExtendedGSSCredential
- extends org.ietf.jgss.GSSCredential
Defines Java API for credential export extension as defined in the
GSS-API Extensions document.
Some of the functions might not specify all the parameters as in the document.
Notes:
- Protection key is currently not supported.
Fields inherited from interface org.ietf.jgss.GSSCredential |
ACCEPT_ONLY, DEFAULT_LIFETIME, INDEFINITE_LIFETIME, INITIATE_AND_ACCEPT, INITIATE_ONLY |
Method Summary |
byte[] |
export(int option)
Exports this credential so that another process might import it. |
byte[] |
export(int option,
org.ietf.jgss.Oid mech)
Exports this credential so that another process might import it. |
java.lang.Object |
inquireByOid(org.ietf.jgss.Oid oid)
Retrieves arbitrary data about this credential. |
Methods inherited from interface org.ietf.jgss.GSSCredential |
add, dispose, equals, getMechs, getName, getName, getRemainingAcceptLifetime, getRemainingInitLifetime, getRemainingLifetime, getUsage, getUsage, hashCode |
IMPEXP_OPAQUE
static final int IMPEXP_OPAQUE
- See Also:
- Constant Field Values
IMPEXP_MECH_SPECIFIC
static final int IMPEXP_MECH_SPECIFIC
- See Also:
- Constant Field Values
export
byte[] export(int option)
throws org.ietf.jgss.GSSException
- Exports this credential so that another process might import it.
The exported credential might be imported again using the
ExtendedGSSManager.createCredential
method.
- Parameters:
option
- The export type. If set to ExtendedGSSCredential.IMPEXP_OPAQUE
exported buffer is an opaque
buffer suitable for storage in memory or on disk or passing to
another process. If set to ExtendedGSSCredential.IMPEXP_MECH_SPECIFIC
exported buffer is a
buffer filled with mechanism-specific information that the calling
application can use to pass the credential to another process that
is not written to the GSS-API.
- Returns:
- The buffer containing the credential
- Throws:
org.ietf.jgss.GSSException
- containing the following major error codes:
GSSException.CREDENTIAL_EXPIRED,
GSSException.UNAVAILABLE, GSSException.FAILURE
export
byte[] export(int option,
org.ietf.jgss.Oid mech)
throws org.ietf.jgss.GSSException
- Exports this credential so that another process might import it.
The exported credential might be imported again using the
ExtendedGSSManager.createCredential
method.
- Parameters:
option
- The export type. If set to ExtendedGSSCredential.IMPEXP_OPAQUE
exported buffer is an opaque
buffer suitable for storage in memory or on disk or passing to
another process. If set to ExtendedGSSCredential.IMPEXP_MECH_SPECIFIC
exported buffer is a buffer
filled with mechanism-specific information that the calling application
can use to pass the credential to another process that is not written
to the GSS-API.mech
- Desired mechanism for exported credential, may be null to
indicate system default.
- Returns:
- The buffer containing the credential
- Throws:
org.ietf.jgss.GSSException
- containing the following major error codes:
GSSException.CREDENTIAL_EXPIRED,
GSSException.UNAVAILABLE, GSSException.BAD_MECH, GSSException.FAILURE
inquireByOid
java.lang.Object inquireByOid(org.ietf.jgss.Oid oid)
throws org.ietf.jgss.GSSException
- Retrieves arbitrary data about this credential.
- Parameters:
oid
- the oid of the information desired.
- Returns:
- the information desired. Might be null.
- Throws:
org.ietf.jgss.GSSException
- containing the following major error codes:
GSSException.FAILURE