Spec-Zone .ru
спецификации, руководства, описания, API


javax.security.auth.message.config
Интерфейс AuthConfigProvider


public interface AuthConfigProvider

Этот интерфейс реализуется объектами, которые могут использоваться, чтобы получить объекты конфигурации контекста аутентификации, то есть, ClientAuthConfig или ServerAuthConfig объекты.

Объекты конфигурации контекста аутентификации служат источниками объектов контекста аутентификации, то есть, ClientAuthContext или ServerAuthContext объекты, для определенного уровня сообщения и контекста обмена сообщениями.

Объекты контекста аутентификации инкапсулируют инициализацию, конфигурацию, и вызов модулей аутентификации, то есть, ClientAuthModule или ServerAuthModule объекты, для определенного обмена сообщениями в пределах определенного уровня сообщения и контекста обмена сообщениями.

Вызывающие стороны непосредственно не работают на модулях аутентификации. Вместо этого они полагаются на ClientAuthContext или ServerAuthContext, чтобы управлять вызовом модулей. Вызывающая сторона получает экземпляр ClientAuthContext или ServerAuthContext, вызывая соответствующее getAuthContext метод на a ClientAuthConfig или ServerAuthConfig объект получается из AuthConfigProvider.

Следующее представляет типичную последовательность призывов к получению объекта контекста аутентификации клиента, и затем использованию этого, чтобы защитить запрос.

  1. Провайдер AuthConfigProvider;
  2. Конфигурация ClientAuthConfig = provider.getClientAuthConfig (уровень, appID, cbh);
  3. Представьте authContextID в виде строки = config.getAuthContextID (messageInfo);
  4. Контекст ClientAuthContext = config.getAuthContext (authContextID, предмет, свойства);
  5. context.secureRequest (messageInfo, предмет);

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

 
 public AuthConfigProviderImpl(Map properties, AuthConfigFactory factory);
 
где параметром свойств может быть нуль, и где все значения и ключи, происходящие в ненулевом параметре свойств, должны иметь Строку типа. Когда параметром фабрики не является нуль, он указывает, что провайдер должен самозарегистрироваться на фабрике, вызывая следующий метод на фабрике:
 
 public String 
 registerConfigProvider(AuthConfigProvider provider, String layer, 
                        String appContext, String description);
 
 

Версия:
% %I, %G %
См. Также:
ClientAuthContext, ServerAuthContext, AuthConfigFactory

Сводка метода
 ClientAuthConfig getClientAuthConfig(java.lang.String layer, java.lang.String appContext, javax.security.auth.callback.CallbackHandler handler)
          Получите экземпляр ClientAuthConfig от этого провайдера.
 ServerAuthConfig getServerAuthConfig(java.lang.String layer, java.lang.String appContext, javax.security.auth.callback.CallbackHandler handler)
          Получите экземпляр ServerAuthConfig от этого провайдера.
 void refresh()
          Заставляет динамического провайдера конфигурации обновлять свое внутреннее состояние так, что, любое получающееся изменение к его состоянию отражается в соответствующих объектах конфигурации контекста аутентификации, ранее создаваемых провайдером в пределах текущего контекста процесса.
 

Деталь метода

getClientAuthConfig

ClientAuthConfig getClientAuthConfig(java.lang.String layer,
                                     java.lang.String appContext,
                                     javax.security.auth.callback.CallbackHandler handler)
                                     throws AuthException
Получите экземпляр ClientAuthConfig от этого провайдера.

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

Параметры:
layer - Строка, идентифицирующая уровень сообщения для возвращенного объекта ClientAuthConfig. Этим параметром не должен быть нуль.
appContext - Строка, которая идентифицирует контекст обмена сообщениями для возвращенного объекта ClientAuthConfig. Этим параметром не должен быть нуль.
handler - CallbackHandler, который передадут к ClientAuthModules, инкапсулировавшему объектами ClientAuthContext, полученными из возвращенного ClientAuthConfig. Этим параметром может быть нуль, когда реализация может присвоить обработчик значения по умолчанию конфигурации. CallbackHandler, присвоенный конфигурации, должен поддерживать объекты Обратного вызова, требуемые поддерживаться профилем этой спецификации, сопровождаемой временем выполнения обмена сообщениями. Экземпляр CallbackHandler должен быть инициализирован с любым контекстом приложения, должен был обработать необходимые обратные вызовы от имени соответствующего приложения.
Возвраты:
Объект ClientAuthConfig, который описывает конфигурацию ClientAuthModules в уровне сообщения и контексте обмена сообщениями, идентифицированном уровнем и appContext параметрами. Этот метод не возвращает нуль.
Броски:
AuthException - Если этот провайдер не поддерживает присвоение значения по умолчанию CallbackHandler к возвращенному ClientAuthConfig.
SecurityException - Если у вызывающей стороны нет разрешения, чтобы получить конфигурацию.

getServerAuthConfig

ServerAuthConfig getServerAuthConfig(java.lang.String layer,
                                     java.lang.String appContext,
                                     javax.security.auth.callback.CallbackHandler handler)
                                     throws AuthException
Получите экземпляр ServerAuthConfig от этого провайдера.

Реализация этого метода возвращает экземпляр ServerAuthConfig, который описывает конфигурацию ServerAuthModules в данном уровне сообщения, и для определенного контекста приложения.

Параметры:
layer - Строка, идентифицирующая уровень сообщения для возвращенного объекта ServerAuthConfig. Этим параметром не должен быть нуль.
appContext - Строка, которая идентифицирует контекст обмена сообщениями для возвращенного объекта ServerAuthConfig. Этим параметром не должен быть нуль.
handler - CallbackHandler, который передадут к ServerAuthModules, инкапсулировавшему объектами ServerAuthContext, полученными из возвращенного ServerAuthConfig. Этим параметром может быть нуль, когда реализация может присвоить обработчик значения по умолчанию конфигурации. CallbackHandler, присвоенный конфигурации, должен поддерживать объекты Обратного вызова, требуемые поддерживаться профилем этой спецификации, сопровождаемой временем выполнения обмена сообщениями. Экземпляр CallbackHandler должен быть инициализирован с любым контекстом приложения, должен был обработать необходимые обратные вызовы от имени соответствующего приложения.
Возвраты:
Объект ServerAuthConfig, который описывает конфигурацию ServerAuthModules в данном уровне сообщения, и для определенного контекста приложения. Этот метод не возвращает нуль.
Броски:
AuthException - Если этот провайдер не поддерживает присвоение значения по умолчанию CallbackHandler к возвращенному ServerAuthConfig.
SecurityException - Если у вызывающей стороны нет разрешения, чтобы получить конфигурацию.

обновление

void refresh()
Заставляет динамического провайдера конфигурации обновлять свое внутреннее состояние так, что, любое получающееся изменение к его состоянию отражается в соответствующих объектах конфигурации контекста аутентификации, ранее создаваемых провайдером в пределах текущего контекста процесса.

Броски:
AuthException - Если ошибка произошла во время обновления.
SecurityException - Если у вызывающей стороны нет разрешения, чтобы обновить провайдера.


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter