Класс 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=username. Если поиск завершается успешно, этот LoginModule получает зашифрованный пароль пользователя из найденной записи с помощью атрибута userPassword. Этот LoginModule предполагает, что пароль хранится в виде массива байтов, который при преобразовании в String имеет следующий формат:

     "{crypt}encrypted_password"

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

Этот LoginModule также распознает следующие параметры 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.