org.apache.jackrabbit.oak.spi.security.authentication.credentials

Interface CredentialsSupport

All Known Implementing Classes:

CompositeCredentialsSupport, SimpleCredentialsSupport

public interface CredentialsSupport

Simple helper interface that allows to easily plug support for additional or custom Credentials implementations during authentication.

See Also:

AbstractLoginModule.getSupportedCredentials(), SimpleCredentialsSupport

Method Summary

Modifier and Type	Method and Description
@NotNull java.util.Map<java.lang.String,?>	getAttributes(@NotNull Credentials credentials) Obtains the attributes as present with the specified Credentials.
@NotNull java.util.Set<java.lang.Class>	getCredentialClasses() Returns all credentials classes supported by this implementation.
@Nullable java.lang.String	getUserId(@NotNull Credentials credentials) Retrieves the user identifier from the specified Credentials.
boolean	setAttributes(@NotNull Credentials credentials, @NotNull java.util.Map<java.lang.String,?> attributes) Writes the attributes to the specified Credentials.

Method Detail

getCredentialClasses

@NotNull
@NotNull java.util.Set<java.lang.Class> getCredentialClasses()

Returns all credentials classes supported by this implementation.

Returns:

the supported credentials classes.

getUserId

@Nullable
@Nullable java.lang.String getUserId(@NotNull
                                               @NotNull Credentials credentials)

Retrieves the user identifier from the specified Credentials. If the specified credentials are not supported or don't contain any user id information this method will return null.

Parameters:

credentials - The credentials as passed to the repository login.

Returns:

The user id present in the given Credentials or null.

getAttributes

@NotNull
@NotNull java.util.Map<java.lang.String,?> getAttributes(@NotNull
                                                                  @NotNull Credentials credentials)

Obtains the attributes as present with the specified Credentials. If the specified credentials are not supported or don't contain any attributes this method will return an empty Map.

Parameters:

credentials - The credentials as passed to the repository login.

Returns:

The credential attributes or an empty Map.

setAttributes

boolean setAttributes(@NotNull
                      @NotNull Credentials credentials,
                      @NotNull
                      @NotNull java.util.Map<java.lang.String,?> attributes)

Writes the attributes to the specified Credentials. If the specified credentials are not supported or doesn't allow to write attributes this method will return false.

Parameters:

credentials - The credentials as passed to the repository login.

attributes - The attributes to be written to the given credentials.

Returns:

true, if the attributes were set; false otherwise.