org.gridforum.jgss

Interface ExtendedGSSCredential

All Superinterfaces:

java.lang.Cloneable, org.ietf.jgss.GSSCredential

All Known Implementing Classes:

GlobusGSSCredentialImpl

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.

Field Summary

Fields

Modifier and Type	Field and Description
static int	IMPEXP_MECH_SPECIFIC
static int	IMPEXP_OPAQUE

Fields inherited from interface org.ietf.jgss.GSSCredential

ACCEPT_ONLY, DEFAULT_LIFETIME, INDEFINITE_LIFETIME, INITIATE_AND_ACCEPT, INITIATE_ONLY

Method Summary

Methods

Modifier and Type	Method and Description
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

Field Detail

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

Method Detail

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