クラス AuthenticationManagerBuilder

方法の詳細

• parentAuthenticationManager

  public AuthenticationManagerBuilder parentAuthenticationManager(AuthenticationManager authenticationManager)

  この AuthenticationManager が提供された Authentication の認証を試みることができなかった場合に試行される親 AuthenticationManager の提供を許可します。

  パラメーター:

  authenticationManager - 現在の AuthenticationManager が提供された Authentication を認証しようとすることができなかった場合に使用される AuthenticationManager

  戻り値:

  認証型をさらに追加するための AuthenticationManagerBuilder

• authenticationEventPublisher

  public AuthenticationManagerBuilder authenticationEventPublisher(AuthenticationEventPublisher eventPublisher)

  AuthenticationEventPublisher を設定します

  パラメーター:

  eventPublisher - 使用する AuthenticationEventPublisher

  戻り値:

  さらにカスタマイズするための AuthenticationManagerBuilder

• eraseCredentials

  public AuthenticationManagerBuilder eraseCredentials(boolean eraseCredentials)

  パラメーター:

  eraseCredentials - AuthenticationManager が認証後に Authentication オブジェクトから資格情報をクリアする必要がある場合は true

  戻り値:

  さらにカスタマイズするための AuthenticationManagerBuilder

• inMemoryAuthentication

  public InMemoryUserDetailsManagerConfigurer<AuthenticationManagerBuilder> inMemoryAuthentication()

  AuthenticationManagerBuilder にメモリ内認証を追加し、InMemoryUserDetailsManagerConfigurer を返して、メモリ内認証のカスタマイズを許可します。

  また、このメソッドは、UserDetailsService が getDefaultUserDetailsService() メソッドで使用可能であることを確認します。追加の UserDetailsService がこの UserDetailsService をデフォルトとしてオーバーライドする場合があることに注意してください。

  戻り値:

  メモリ内認証のカスタマイズを可能にする InMemoryUserDetailsManagerConfigurer

  例外:

  ExceptionSE - メモリ内認証の追加時にエラーが発生した場合

• jdbcAuthentication

  public JdbcUserDetailsManagerConfigurer<AuthenticationManagerBuilder> jdbcAuthentication()

  JDBC 認証を AuthenticationManagerBuilder に追加し、JdbcUserDetailsManagerConfigurer を返し、JDBC 認証のカスタマイズを許可します。

  永続データストアで使用する場合は、Flyway や Liquibase などを使用して構成の外部でユーザーを追加し、スキーマを作成してユーザーを追加することで、これらの手順が 1 回だけ実行され、最適な SQL が使用されるようにするのが最適です。

  また、このメソッドは、UserDetailsService が getDefaultUserDetailsService() メソッドで使用可能であることを確認します。追加の UserDetailsService がこの UserDetailsService をデフォルトとしてオーバーライドする場合があることに注意してください。デフォルトのスキーマについては、リファレンスのユーザースキーマセクションを参照してください。

  戻り値:

  JDBC 認証のカスタマイズを可能にする JdbcUserDetailsManagerConfigurer

  例外:

  ExceptionSE - JDBC 認証の追加時にエラーが発生した場合

• userDetailsService

  public <T extends UserDetailsService> DaoAuthenticationConfigurer<AuthenticationManagerBuilder, T> userDetailsService(T userDetailsService)

  渡されたカスタム UserDetailsService に基づいて認証を追加します。次に、DaoAuthenticationConfigurer を返し、認証のカスタマイズを許可します。

  また、このメソッドは、UserDetailsService が getDefaultUserDetailsService() メソッドで使用可能であることを確認します。追加の UserDetailsService がこの UserDetailsService をデフォルトとしてオーバーライドする場合があることに注意してください。

  戻り値:

  DAO 認証のカスタマイズを可能にする DaoAuthenticationConfigurer

  例外:

  ExceptionSE - UserDetailsService ベースの認証を追加するときにエラーが発生した場合

• ldapAuthentication

  public LdapAuthenticationProviderConfigurer<AuthenticationManagerBuilder> ldapAuthentication() throws ExceptionSE

  LDAP 認証を AuthenticationManagerBuilder に追加し、LdapAuthenticationProviderConfigurer を返して、LDAP 認証のカスタマイズを許可します。

  このメソッド は、UserDetailsService が getDefaultUserDetailsService() メソッドで使用可能であることを保証しません。

  戻り値:

  LDAP 認証のカスタマイズを可能にする LdapAuthenticationProviderConfigurer

  例外:

  ExceptionSE - LDAP 認証の追加時にエラーが発生した場合

• authenticationProvider

  public AuthenticationManagerBuilder authenticationProvider(AuthenticationProvider authenticationProvider)

  渡されるカスタム AuthenticationProvider に基づいて認証を追加します。AuthenticationProvider の実装は不明であるため、すべてのカスタマイズは外部で行う必要があり、AuthenticationManagerBuilder はすぐに返されます。

  このメソッドは、UserDetailsService が getDefaultUserDetailsService() メソッドで使用できることを保証しません。AuthenticationProvider の追加時にエラーが発生した場合、ExceptionSE がスローされる可能性があることに注意してください。

  次で指定:

  インターフェース ProviderManagerBuilder<AuthenticationManagerBuilder> 内の authenticationProvider 

  戻り値:

  AuthenticationManagerBuilder にさらに認証を提供できるようにする AuthenticationManagerBuilder

• performBuild

  protected ProviderManager performBuild()

  クラスからコピーされた説明: AbstractConfiguredSecurityBuilder

  サブクラスはこのメソッドを実装して、返されるオブジェクトを構築する必要があります。

  次で指定:

  クラス AbstractConfiguredSecurityBuilder<AuthenticationManager, AuthenticationManagerBuilder> の performBuild 

  戻り値:

  構築するオブジェクト、または実装で許可されている場合は null

• isConfigured

  public boolean isConfigured()

  AuthenticationManagerBuilder が null 以外の AuthenticationManager を作成するように構成されているかどうかを判別します。これは、非 null の親が指定されているか、少なくとも 1 つの AuthenticationProvider が指定されていることを意味します。

  SecurityConfigurer インスタンスを使用する場合、AuthenticationManagerBuilder は SecurityConfigurer.configure(SecurityBuilder) メソッドまで構成されません。これは、最後の SecurityConfigurer がこのメソッドをチェックし、SecurityConfigurer.configure(SecurityBuilder) メソッドでデフォルト構成を提供できることを意味します。

  戻り値:

  AuthenticationManagerBuilder が構成されている場合は true、そうでない場合は false

• getDefaultUserDetailsService

  public UserDetailsService getDefaultUserDetailsService()

  AuthenticationManagerBuilder のデフォルト UserDetailsService を取得します。状況によっては、結果が null になる場合があります。

  戻り値:

  AuthenticationManagerBuilder のデフォルト UserDetailsService