Класс LoginContext

public class LoginContext
extends Object

Класс LoginContext описывает основные методы, используемые для аутентификации субъектов и предоставляет способ разработки приложения, независимого от технологии аутентификации. Configuration определяет технологию аутентификации, или LoginModule, которая должна использоваться с конкретным приложением. Разные LoginModules могут быть подключены к приложению без необходимости каких-либо изменений в самом приложении.

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

Типичный вызывающий метод инициализирует LoginContext с именем и CallbackHandler. LoginContext использует имя в качестве индекса в Конфигурации, чтобы определить, какие LoginModules должны быть использованы, и какие из них должны преуспеть, чтобы общая аутентификация прошла успешно. CallbackHandler передается в подлежащие LoginModules, чтобы они могли взаимодействовать с пользователями (например, запрашивая имя пользователя и пароль через графический пользовательский интерфейс).

После того, как вызывающий метод инициализировал LoginContext, он вызывает метод login для аутентификации Subject. Метод login вызывает настроенные модули для выполнения их соответствующих типов аутентификации (имя/пароль, проверка пин-кода смарт-карты и т.д.). Обратите внимание, что LoginModules не будут пытаться повторить попытки аутентификации и не будут вводить задержки в случае неудачи аутентификации. Такие задачи лежат на стороне вызывающего метода LoginContext.

Если метод login возвращается без генерации исключения, значит общая аутентификация прошла успешно. Затем вызывающий метод может получить недавно аутентифицированный субъект, вызвав метод getSubject. Принципы и учетные данные, связанные с субъектом, могут быть получены путем вызова соответствующих методов субъекта getPrincipals, getPublicCredentials, и getPrivateCredentials.

Для выхода из системы субъекта вызывающий метод вызывает метод logout. Как и с методом login, этот метод logout вызывает метод logout для настроенных модулей.

LoginContext не следует использовать для аутентификации более одного субъекта. Для аутентификации каждого отдельного субъекта следует использовать отдельный LoginContext.

Следующая документация относится ко всем конструкторам LoginContext:

1. Subject
   • Если конструктор имеет параметр Subject, LoginContext использует объект Subject, указанный вызывающим методом.
   • Если вызывающий метод указывает субъект null и разрешено значение null, LoginContext создает новый Subject.
   • Если конструктор не имеет параметра Subject, LoginContext создает новый Subject.
2. Configuration
   • Если конструктор имеет параметр Configuration и вызывающий метод указывает не null Configuration, LoginContext использует указанную вызывающим методом Configuration.

     Если конструктор не имеет параметра Configuration, или вызывающий метод указывает объект Configuration null, конструктор использует следующий вызов для получения установленной Configuration:

     config = Configuration.getConfiguration();

     В обоих случаях аргумент name, переданный в конструктор, передается методу Configuration.getAppConfigurationEntry. Если в Конфигурации нет записей для заданного имени, то LoginContext вызывает getAppConfigurationEntry с именем "other" (имя по умолчанию). Если нет записи для "other", то генерируется LoginException.
   • Когда LoginContext использует установленную Configuration, вызывающий метод требует AuthPermissions createLoginContext.name и, возможно, createLoginContext.other. Кроме того, LoginContext будет вызывать настроенные модули изнутри вызова AccessController.doPrivileged, так что модули, выполняющие задачи, чувствительные к безопасности (например, подключение к удаленным хостам и обновление Subject), будут требовать соответствующих разрешений, но вызывающие методы LoginContext не будут требовать этих разрешений.
   • Когда LoginContext использует указанную вызывающим методом Configuration, вызывающий метод не требует никаких AuthPermission createLoginContext. LoginContext сохраняет AccessControlContext для вызывающего метода и вызывает настроенные модули изнутри вызова AccessController.doPrivileged , ограниченного этим контекстом. Это означает, что контекст вызывающего метода (сохраненный при создании LoginContext) должен иметь достаточные разрешения для выполнения любых задач, чувствительных к безопасности, которые могут выполнять модули.
3. CallbackHandler
   • Если конструктор имеет параметр CallbackHandler, LoginContext использует объект CallbackHandler, указанный вызывающим методом.
   • Если конструктор не имеет параметра CallbackHandler, или вызывающий метод указывает объект CallbackHandler null (и разрешено значение null), LoginContext запрашивает у свойства безопасности auth.login.defaultCallbackHandler полное имя класса реализации обработчика по умолчанию. Если свойство безопасности не установлено, то подлежащие модули не будут иметь CallbackHandler для взаимодействия с пользователем. Таким образом, вызывающий метод предполагает, что настроенные модули имеют альтернативные способы аутентификации пользователя.
   • Когда LoginContext использует установленную Configuration (вместо указанной вызывающим методом, см. выше), этот LoginContext должен обернуть любой указанный вызывающим методом или по умолчанию CallbackHandler в новую реализацию CallbackHandler, чья реализация метода handle вызывает метод handle указанного CallbackHandler в вызове java.security.AccessController.doPrivileged , ограниченном текущим AccessControlContext вызывающего метода.