|
IBM WebSphereTM eXtreme Scale, Release 8.6 API Specification |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.ibm.websphere.objectgrid.security.plugins.builtins.LDAPLoginModule
SimpleLDAPLoginModule
LoginModule.
public class LDAPLoginModule
This LDAPLoginModule authenticates a user name and password to the configured LDAP server.
A login configuration should provide at least the following two options:
Here is a Login module configuration example used by the sample LDAPAuthenticator:
LDAPLogin {
com.ibm.websphere.objectgrid.security.plugins.builtins.LDAPLoginModule required
providerURL="ldap://bluepages.ibm.com:389/"
factoryClass="com.sun.jndi.ldap.LdapCtxFactory"
debug=true;
};
The providerURL points to the IBM bluepages LDAP server with the port number
389. The initial context factory is com.sun.jndi.ldap.LdapCtxFactory.
LoginModule
Field Summary | |
---|---|
static String |
FACTORY_CLASS
Deprecated. LDAP context factory implementation class property name |
static String |
PROVIDER_URL
Deprecated. LDAP server provider URL property name |
Constructor Summary | |
---|---|
LDAPLoginModule()
Deprecated. |
Method Summary | |
---|---|
boolean |
abort()
Deprecated. Called if the LoginContext's overall authentication failed. |
boolean |
commit()
Deprecated. Called if the LoginContext's overall authentication succeeded (the relevant REQUIRED, REQUISITE, SUFFICIENT and OPTIONAL LoginModules succeeded). |
void |
initialize(Subject _subject,
CallbackHandler _callbackHandler,
Map _sharedState,
Map _options)
Deprecated. Initializes this LoginModule . |
boolean |
login()
Deprecated. Authenticates the user by a user name and password. |
boolean |
logout()
Deprecated. Logs out the user. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String PROVIDER_URL
public static final String FACTORY_CLASS
Constructor Detail |
---|
public LDAPLoginModule()
Method Detail |
---|
public void initialize(Subject _subject, CallbackHandler _callbackHandler, Map _sharedState, Map _options)
LoginModule
.
initialize
in interface LoginModule
_subject
- the Subject
to be authenticated._callbackHandler
- a CallbackHandler
for communicating
with the end user (prompting for user names and
passwords, for example)._sharedState
- shared LoginModule
state._options
- options specified in the login
Configuration
for this particular
LoginModule
.public boolean login() throws LoginException
login
in interface LoginModule
LoginModule
should not be ignored.
FailedLoginException
- if the authentication fails.
LoginException
- if this LoginModule
is unable to perform the authentication.public boolean commit() throws LoginException
If this LoginModule's own authentication attempt succeeded (checked by
retrieving the private state saved by the login
method),
this method associates a SimpleUserPrincipal
and
SimpleDeptPrincipal
with the Subject
located in
the LoginModule
. If this LoginModule's own
authentication attempted failed, this method removes
any state that was originally saved.
commit
in interface LoginModule
LoginException
- if the commit fails.public boolean abort() throws LoginException
If this LoginModule's own authentication attempt
succeeded (checked by retrieving the private state saved by the
login
and commit
methods),
then this method cleans up any state that was originally saved.
abort
in interface LoginModule
LoginException
- if the abort fails.public boolean logout() throws LoginException
This method removes the SamplePrincipal
that was added by the commit
method.
logout
in interface LoginModule
LoginModule
should not be ignored.
LoginException
- if the logout fails.
|
IBM WebSphereTM eXtreme Scale, Release 8.6 API Specification |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |