Класс JndiLoginModule

public class JndiLoginModule
extends Object
implements LoginModule

Модуль запрашивает имя пользователя и пароль, а затем проверяет пароль по отношению к паролю, хранящемуся в службе каталогов, настроенной в JNDI.

Этот LoginModule взаимодействует с любым совместимым поставщиком услуг JNDI. Чтобы направить этот LoginModule на использование определённого поставщика услуг JNDI, в разделе параметров входа Configuration для этого LoginModule необходимо указать два параметра.

user.provider.url=name_service_url
      group.provider.url=name_service_url

name_service_url указывает службу каталогов и путь, где этот LoginModule может получить доступ к соответствующей информации о пользователе и группе. Поскольку этот LoginModule выполняет только поиск в одном уровне, чтобы найти соответствующую информацию о пользователе, URL должен указывать на каталог на уровень выше, где информация о пользователе и группе хранится в службе каталогов. Например, чтобы направить этот LoginModule на обращение к серверу NIS, необходимо указать следующие URL-адреса:

user.provider.url="nis://NISServerHostName/NISDomain/user"
    group.provider.url="nis://NISServerHostName/NISDomain/system/group"

NISServerHostName указывает имя хоста сервера NIS (например, nis.sun.com), а NISDomain указывает домен для этого сервера NIS (например, jaas.sun.com). Чтобы обратиться к серверу LDAP, необходимо указать следующие URL-адреса:

user.provider.url="ldap://LDAPServerHostName/LDAPName"
    group.provider.url="ldap://LDAPServerHostName/LDAPName"

LDAPServerHostName указывает имя хоста сервера LDAP, которое может включать номер порта (например, ldap.sun.com:389), а LDAPName указывает имя записи в каталоге LDAP (например, ou=People,o=Sun,c=US и ou=Groups,o=Sun,c=US для информации о пользователе и группе соответственно).

Формат, в котором информация о пользователе должна храниться в службе каталогов, указан в RFC 2307. В частности, этот LoginModule будет искать запись пользователя в службе каталогов, используя атрибут uid пользователя, где uid=имя_пользователя. Если поиск успешен, этот LoginModule получит зашифрованный пароль пользователя из извлечённой записи, используя атрибут userPassword. Этот LoginModule предполагает, что пароль хранится в виде массива байтов, который при преобразовании в String, имеет следующий формат:

"{crypt}encrypted_password"

Сервер каталогов LDAP должен быть настроен таким образом, чтобы разрешать чтение атрибута userPassword. Если пользователь ввёл корректное имя пользователя и пароль, этот LoginModule сопоставляет UnixPrincipal, UnixNumericUserPrincipal, и соответствующие UnixNumericGroupPrincipals с Subject.

Этот модуль входа также распознаёт следующие Configuration параметры:

debug          if, true, debug messages are output to System.out.

    useFirstPass   if, true, this LoginModule retrieves the
                   username and password from the module's shared state,
                   using "javax.security.auth.login.name" and
                   "javax.security.auth.login.password" as the respective
                   keys.  The retrieved values are used for authentication.
                   If authentication fails, no attempt for a retry is made,
                   and the failure is reported back to the calling
                   application.

    tryFirstPass   if, true, this LoginModule retrieves the
                   the username and password from the module's shared state,
                   using "javax.security.auth.login.name" and
                   "javax.security.auth.login.password" as the respective
                   keys.  The retrieved values are used for authentication.
                   If authentication fails, the module uses the
                   CallbackHandler to retrieve a new username and password,
                   and another attempt to authenticate is made.
                   If the authentication fails, the failure is reported
                   back to the calling application.

    storePass      if, true, this LoginModule stores the username and password
                   obtained from the CallbackHandler in the module's
                   shared state, using "javax.security.auth.login.name" and
                   "javax.security.auth.login.password" as the respective
                   keys.  This is not performed if existing values already
                   exist for the username and password in the shared state,
                   or if authentication fails.

    clearPass     if, true, this LoginModule clears the
                  username and password stored in the module's shared state
                  after both phases of authentication (login and commit)
                  have completed.

public final String USER_PROVIDER

public final String GROUP_PROVIDER

public JndiLoginModule()

public void initialize(Subject subject,
                       CallbackHandler callbackHandler,
                       Map<String,​?> sharedState,
                       Map<String,​?> options)

public boolean login()
              throws LoginException

public boolean commit()
               throws LoginException

public boolean abort()
              throws LoginException

public boolean logout()
               throws LoginException