org.jasig.cas.authentication

Interface Credential

All Known Subinterfaces:

RememberMeCredential

All Known Implementing Classes:

AbstractCredential, HttpBasedServiceCredential, OneTimePasswordCredential, RememberMeUsernamePasswordCredential, UsernamePasswordCredential

public interface Credential

Describes an authentication credential. Implementations SHOULD also implement CredentialMetaData if no sensitive data is contained in the credential; conversely, implementations MUST NOT implement CredentialMetaData if the credential contains sensitive data (e.g. password, key material).

Since:

3.0

Author:

William G. Thompson, Jr., Marvin S. Addison

See Also:

CredentialMetaData

Field Summary

Fields

Modifier and Type	Field and Description
static String	UNKNOWN_ID An ID that may be used to indicate the credential identifier is unknown.

Method Summary

Methods

Modifier and Type	Method and Description
String	getId() Gets a credential identifier that is safe to record for logging, auditing, or presentation to the user.

Field Detail

UNKNOWN_ID

static final String UNKNOWN_ID

An ID that may be used to indicate the credential identifier is unknown.

See Also:

Constant Field Values

Method Detail

getId

String getId()

Gets a credential identifier that is safe to record for logging, auditing, or presentation to the user. In most cases this has a natural meaning for most credential types (e.g. username, certificate DN), while for others it may be awkward to construct a meaningful identifier. In any case credentials require some means of identification for a number of cases and implementers should make a best effor to satisfy that need.

Returns:

Non-null credential identifier. Implementers should return UNKNOWN_ID for cases where an ID is not readily available or meaningful.