Класс Configuration

public abstract class Configuration
extends Object

Объект Configuration отвечает за указание, какие LoginModules должны использоваться для конкретного приложения и в каком порядке должны вызываться LoginModules.

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

Name {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };
      Name {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };
      other {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };

Каждый элемент в Configuration индексируется с помощью имени приложения, Name, и содержит список LoginModules, настроенных для этого приложения. Каждый LoginModule указывается через полное имя класса.

Проверка подлинности происходит по списку модулей в точном порядке, указанном в списке. Если для приложения нет конкретной записи, используется запись для "other".

Значение Flag управляет общим поведением по мере продвижения проверки подлинности по стеку. Ниже представлено описание допустимых значений для Flag и их семантики:

1) Required     - The LoginModule is required to succeed.
                      If it succeeds or fails, authentication still continues
                      to proceed down the LoginModule list.

      2) Requisite    - The LoginModule is required to succeed.
                      If it succeeds, authentication continues down the
                      LoginModule list.  If it fails,
                      control immediately returns to the application
                      (authentication does not proceed down the
                      LoginModule list).

      3) Sufficient   - The LoginModule is not required to
                      succeed.  If it does succeed, control immediately
                      returns to the application (authentication does not
                      proceed down the LoginModule list).
                      If it fails, authentication continues down the
                      LoginModule list.

      4) Optional     - The LoginModule is not required to
                      succeed.  If it succeeds or fails,
                      authentication still continues to proceed down the
                      LoginModule list.

Общая проверка подлинности успешна только в том случае, если все LoginModules Required и Requisite завершаются успешно. Если настроен и успешно завершен Sufficient LoginModule, то для успешной общей проверки подлинности должны быть успешны только LoginModules Required и Requisite, предшествующие этому Sufficient LoginModule. Если для приложения не настроены LoginModules Required или Requisite, то должен быть успешно завершен хотя бы один Sufficient или Optional LoginModule.

ModuleOptions — это список значений, разделенных пробелами, специфичных для LoginModule, которые передаются непосредственно в базовые LoginModules. Опции определяются самим LoginModule, и управляют поведением внутри него. Например, LoginModule может определить опции для поддержки возможностей отладки/тестирования. Правильный способ указания опций в Configuration заключается в использовании следующего сочетания ключ-значение: debug="true". Ключ и значение должны быть разделены символом «равно», а значение должно быть заключено в двойные кавычки. Если в значении встречается строка в формате ${system.property}, она будет расширена до значения системной переменной. Обратите внимание, что нет ограничений на количество опций, которые может определить LoginModule.

Ниже представлен пример Configuration записи, основанный на указанном выше синтаксисе:

Login {
   com.sun.security.auth.module.UnixLoginModule required;
   com.sun.security.auth.module.Krb5LoginModule optional
                   useTicketCache="true"
                   ticketCache="${user.home}${/}tickets";
 };

Этот Configuration указывает, что для приложения с именем «Login» пользователи должны сначала пройти проверку подлинности в модуле com.sun.security.auth.module.UnixLoginModule, который должен быть успешным. Даже если проверка подлинности UnixLoginModule завершается неудачей, модуль com.sun.security.auth.module.Krb5LoginModule всё равно вызывается. Это помогает скрыть причину ошибки. Поскольку Krb5LoginModule является Optional, общая проверка подлинности успешна только в том случае, если UnixLoginModule (Required) успешен.

Также обратите внимание, что модульные опции useTicketCache="true" и ticketCache=${user.home}${/}tickets" передаются в Krb5LoginModule. Эти опции инструктируют Krb5LoginModule использовать кэш билетов по указанному расположению. Системные переменные user.home и / (file.separator) расширяются до соответствующих значений.

В любое время во время выполнения устанавливается только один объект Configuration. Объект Configuration можно установить, вызвав метод setConfiguration. Установленный объект Configuration можно получить, вызвав метод getConfiguration.

Если в ходе выполнения не был установлен ни один объект Configuration, вызов getConfiguration устанавливает экземпляр реализации по умолчанию Configuration (реализация подкласса по умолчанию этого абстрактного класса). Реализацию Configuration по умолчанию можно изменить, установив значение системной переменной login.configuration.provider до полного имени желаемой реализации подкласса Configuration.

Код приложения может напрямую унаследовать от Configuration, чтобы предоставить пользовательскую реализацию. Кроме того, экземпляр объекта Configuration может быть создан путём вызова одного из getInstance фабричных методов со стандартным типом. Тип политики по умолчанию — "JavaLoginConfig". Список стандартных типов Configuration см. в разделе «Configuration» спецификации «Названия стандартных алгоритмов Java Security» по адресу https://docs.oracle.com/en/java/javase/11/docs/specs/security/standard-names.html#configuration-types.