パッケージ org.springframework.security.authentication.jaas

クラス AbstractJaasAuthenticationProvider

java.lang.ObjectSE
org.springframework.security.authentication.jaas.AbstractJaasAuthenticationProvider
実装されたすべてのインターフェース:
EventListenerSE、org.springframework.beans.factory.Aware、org.springframework.beans.factory.InitializingBean、org.springframework.context.ApplicationEventPublisherAware、org.springframework.context.ApplicationListener<SessionDestroyedEvent>、AuthenticationProvider
既知の直属サブクラス
DefaultJaasAuthenticationProvider, JaasAuthenticationProvider
public abstract class AbstractJaasAuthenticationProvider extends ObjectSE implements AuthenticationProvider, org.springframework.context.ApplicationEventPublisherAware, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationListener<SessionDestroyedEvent>
JAAS ログイン構成からユーザーの詳細を取得する AuthenticationProvider 実装。

この AuthenticationProvider は、正しいユーザー名とパスワードを含む UsernamePasswordAuthenticationToken リクエストを検証できます。

この実装は、サブクラスの createLoginContext(CallbackHandler) の実装によって提供される JAAS 構成によってサポートされます。

認証ソースとして JAAS ログインモジュールを使用する場合は、時々 LoginContext は CallbackHandler 秒が必要になります。AbstractJaasAuthenticationProvider は内部 CallbackHandler を使用して、ApplicationContext で構成された JaasAuthenticationCallbackHandler をラップします。LoginContext が内部 CallbackHandler を呼び出すと、渡された各 Callback の各 JaasAuthenticationCallbackHandler に制御が渡されます。

JaasAuthenticationCallbackHandler は callbackHandlers プロパティを通じて AbstractJaasAuthenticationProvider に渡されます。

 <property name="callbackHandlers">
   <list>
     <bean class="org.springframework.security.authentication.jaas.TestCallbackHandler"/>
     <bean class="org.springframework.security.authentication.jaas.JaasNameCallbackHandler"/>
     <bean class="org.springframework.security.authentication.jaas.JaasPasswordCallbackHandler"/>
  </list>
 </property>

LoginContext.login() を呼び出した後、AbstractJaasAuthenticationProvider はサブジェクト（LoginContext.getSubject()。getPrincipals）から返されたプリンシパルを取得します。返された各プリンシパルは、構成された AuthorityGranter に渡されます。AuthorityGranter は、返されたプリンシパルとロール名の間のマッピングです。AuthorityGranter が Authorization にロールを付与したい場合は、AuthorityGranter.grant(java.security.Principal) メソッドからそのロール名を返します。返されたロールは、GrantedAuthority として Authorization オブジェクトに適用されます。

AuthorityGranters は次のように Spring XML で構成されています...

 <property name="authorityGranters">
   <list>
     <bean class="org.springframework.security.authentication.jaas.TestAuthorityGranter"/>
   </list>
  </property>

  • フィールドの詳細

    • log

      protected final org.apache.commons.logging.Log log

  • コンストラクターの詳細

    • AbstractJaasAuthenticationProvider

      public AbstractJaasAuthenticationProvider()

  • メソッドの詳細

    • afterPropertiesSet

      public void afterPropertiesSet() throws ExceptionSE
      必要なプロパティが設定されていることを検証します。さらに、setCallbackHandlers(JaasAuthenticationCallbackHandler[]) が有効なハンドラーで呼び出されていない場合は、JaasNameCallbackHandler および JaasPasswordCallbackHandler を使用するように初期化します。
      次で指定:
      インターフェース org.springframework.beans.factory.InitializingBean の afterPropertiesSet 
      例外:
      ExceptionSE

    • authenticate

      public Authentication authenticate(Authentication auth) throws AuthenticationException
      認証オブジェクトのプリンシパルとクレデンシャルを指定してユーザーにログインしようとします
      次で指定:
      インターフェース AuthenticationProvider の authenticate 
      パラメーター:
      auth - 認証される認証オブジェクト。
      戻り値:
      認証済みの認証オブジェクトで、grantedAuthorities が設定されています。
      例外:
      AuthenticationException - この実装は「ロックされた」または 'disabled' アカウントを処理しません。このメソッドは、loginContext.login() メソッドが失敗した場合にスローされる LoginException のメッセージとともに AuthenticationServiceException のみをスローします。

    • createLoginContext

      protected abstract LoginContextSE createLoginContext(CallbackHandlerSE handler) throws LoginExceptionSE
      認証に使用する LoginContext を作成します。
      パラメーター:
      handler - LoginContext に使用する必要がある CallbackHandler（非 null）。
      戻り値:
      認証に使用する LoginContext
      例外:
      LoginExceptionSE

    • handleLogout

      protected void handleLogout(SessionDestroyedEvent event)
      破棄されたセッションのセキュリティコンテキストを取得し、JaasAuthenticationToken を含むすべてのセッションに対して LoginContext.logout() を呼び出すことにより、ログアウトを処理します。
      パラメーター:
      event - 現在のセッションを含むセッションイベント

    • onApplicationEvent

      public void onApplicationEvent(SessionDestroyedEvent event)
      次で指定:
      インターフェース org.springframework.context.ApplicationListener<SessionDestroyedEvent> の onApplicationEvent 

    • publishFailureEvent

      protected void publishFailureEvent(UsernamePasswordAuthenticationToken token, AuthenticationException ase)
      JaasAuthenticationFailedEvent を公開します。さまざまな機能のサブクラスによってオーバーライドできます
      パラメーター:
      token - 処理中の認証トークン
      ase - 認証失敗の原因となった例外

    • publishSuccessEvent

      protected void publishSuccessEvent(UsernamePasswordAuthenticationToken token)
      JaasAuthenticationSuccessEvent を公開します。さまざまな機能のサブクラスによってオーバーライドできます。
      パラメーター:
      token - 処理中のトークン

    • setAuthorityGranters

      public void setAuthorityGranters(AuthorityGranter[] authorityGranters)
      認証に付与されるロール名について調べられる AuthorityGranters を設定します。
      パラメーター:
      authorityGranters - AuthorityGranter 配列
      関連事項:

    • setCallbackHandlers

      public void setCallbackHandlers(JaasAuthenticationCallbackHandler[] callbackHandlers)
      LoginContext.login メソッドによって生成されたコールバックオブジェクトを処理するように JAASAuthenticationCallbackHandler 配列を設定します。
      パラメーター:
      callbackHandlers - JAASAuthenticationCallbackHandlers の配列

    • setLoginContextName

      public void setLoginContextName(StringSE loginContextName)
      loginContextName を設定します。この名前は、loginConfig プロパティで指定された構成のインデックスとして使用されます。
      パラメーター:
      loginContextName -

    • setLoginExceptionResolver

      public void setLoginExceptionResolver(LoginExceptionResolver loginExceptionResolver)

    • supports

      public boolean supports(ClassSE<?> aClass)
      インターフェースからコピーされた説明: AuthenticationProvider
      この AuthenticationProvider が指定された Authentication オブジェクトをサポートする場合、true を返します。

      true を返しても、AuthenticationProvider が提示された Authentication オブジェクトを認証できることは保証されません。これは単に、より詳細な評価をサポートできることを示しているだけです。AuthenticationProvider は、AuthenticationProvider.authenticate(Authentication) メソッドから null を返して、別の AuthenticationProvider を試す必要があることを示すことができます。

      認証を実行できる AuthenticationProvider の選択は、実行時に ProviderManager で行われます。

      次で指定:
      インターフェース AuthenticationProvider の supports 
      戻り値:
      実装が提示された Authentication クラスをより厳密に評価できる場合は true 

    • setApplicationEventPublisher

      public void setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher applicationEventPublisher)
      次で指定:
      インターフェース org.springframework.context.ApplicationEventPublisherAware の setApplicationEventPublisher 

    • getApplicationEventPublisher

      protected org.springframework.context.ApplicationEventPublisher getApplicationEventPublisher()