Package com.adobe.idp.um.spi.authentication
Interfacepublic interface AuthProvider

The AuthProvider interface is the primary interface that your authentication service provider must implement.

This interface defines the authenticate method that processes authentication information sent from User Management. This interface also defines several constants that represent the names of the properties used to specify the authentication information and represent the results of the authentication.

The implementation of this interface should support only user name and password authentication.



Public Methods
 MethodDefined by
  
AuthResponse authenticate(Map credential, List authConfigs)
Provides the authentication results for the given authentication parameters.
AuthProvider
  
String getConfigName()
Provides the name of the configuration node whose first-level children are extracted from the configuration file.
AuthProvider
Public Constants
 ConstantDefined by
  AUTH_OPTIONS
[static] The constant that represents the additional authentication parameters required by the individual authentication provider.
AuthProvider
  AUTH_TYPE
[static] The constant that represents the type of authentication mechanism that should be used to process the given authentication parameters.
AuthProvider
  CERTIFICATE_PKCS7_SIGNATURE
[static] The constant that represents the signature property of the certificate authentication scheme of a User Management user account.
AuthProvider
  CERTIFICATE_UNSIGNED_DATA
[static] The constant that represents the unsigned data property of the certificate authentication scheme of a User Management user account.
AuthProvider
  CONTEXT
[static] The constant that represents a context property that authentication service providers should ignore.
AuthProvider
  ENCODED_KERBEROS_TICKET
[static] The constant that represents a Kerberos property that authentication service providers should ignore.
AuthProvider
  PASSWORD
[static] The constant that represents the password property of a User Management user account.
AuthProvider
  USER_NAME
[static] The constant that represents the user name property of a User Management user account.
AuthProvider
Method Detail
authenticate()
public AuthResponse authenticate(Map credential, List authConfigs)

Provides the authentication results for the given authentication parameters. The implementation of this method should support the processing of user names and passwords of User Management user accounts. The implementation should not process parameters meant for authentication schemes that are not based on user names and passwords. If a different type of authentication parameters is provided, the implementation should respond with an indication that the parameters were not understood.

This method does not throw exceptions. However, the implementation should include error information in the returned results.

Parameters

credential — A java.util.Map object that contains the set of property-value pairs needed to authenticate a user. This parameter provides values for the properties that the constant fields of this interface define. The only valid value for the AUTH_TYPE property is AuthScheme.AUTHTYPE_USERNAME_PWD. If no value is provided for AUTH_TYPE, AuthScheme.AUTHTYPE_USERNAME_PWD is used by default.
 
authConfigs — A java.util.List object that contains the configuration information.

Returns
An AuthResponse object that contains the results of the authentication, or null if the result is unknown. The results can also provide information about any errors that occurred during authentication and an indication that the provided value of AUTH_TYPE was not valid.

See also

getConfigName() 
public String getConfigName()

Provides the name of the configuration node whose first-level children are extracted from the configuration file. Valid return values depend on the provider being used.

Returns
A java.lang.String containing the name of the parent node whose children are to be extracted.
Constant Detail
AUTH_OPTIONSConstant
public static final AUTH_OPTIONS

The constant that represents the additional authentication parameters required by the individual authentication provider.

AUTH_TYPEConstant 
public static final AUTH_TYPE

The constant that represents the type of authentication mechanism that should be used to process the given authentication parameters.

CERTIFICATE_PKCS7_SIGNATUREConstant 
public static final CERTIFICATE_PKCS7_SIGNATURE

The constant that represents the signature property of the certificate authentication scheme of a User Management user account.

CERTIFICATE_UNSIGNED_DATAConstant 
public static final CERTIFICATE_UNSIGNED_DATA

The constant that represents the unsigned data property of the certificate authentication scheme of a User Management user account.

CONTEXTConstant 
public static final CONTEXT

The constant that represents a context property that authentication service providers should ignore.

The only valid value for this property is AuthScheme.AUTHTYPE_USERNAME_PWD.

ENCODED_KERBEROS_TICKETConstant 
public static final ENCODED_KERBEROS_TICKET

The constant that represents a Kerberos property that authentication service providers should ignore.

PASSWORDConstant 
public static final PASSWORD

The constant that represents the password property of a User Management user account.

USER_NAMEConstant 
public static final USER_NAME

The constant that represents the user name property of a User Management user account.





 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/javadoc/com/adobe/idp/um/spi/authentication/AuthProvider.html