クラス SessionManagementConfigurer<H extends HttpSecurityBuilder<H>>

メソッドの詳細

• invalidSessionUrl

  public SessionManagementConfigurer<H> invalidSessionUrl(StringSE invalidSessionUrl)

  この属性を設定すると、SessionManagementFilter に属性値で構成された SimpleRedirectInvalidSessionStrategy が挿入されます。無効なセッション ID が送信されると、戦略が呼び出され、構成された URL にリダイレクトされます。

  パラメーター:

  invalidSessionUrl - 無効なセッションが検出されたときにリダイレクトする URL

  戻り値:

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

• requireExplicitAuthenticationStrategy

  public SessionManagementConfigurer<H> requireExplicitAuthenticationStrategy(boolean requireExplicitAuthenticationStrategy)

  これを設定すると、SessionAuthenticationStrategy の明示的な呼び出しが必要になります。

  パラメーター:

  requireExplicitAuthenticationStrategy - SessionAuthenticationStrategy の明示的な呼び出しが必要

  戻り値:

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

• invalidSessionStrategy

  public SessionManagementConfigurer<H> invalidSessionStrategy(InvalidSessionStrategy invalidSessionStrategy)

  この属性を設定すると、提供された invalidSessionStrategy が SessionManagementFilter に注入されます。無効なセッション ID が送信されると、戦略が呼び出され、構成された URL にリダイレクトされます。

  パラメーター:

  invalidSessionStrategy - 無効なセッション ID が送信されたときに使用する戦略。

  戻り値:

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

• sessionAuthenticationErrorUrl

  public SessionManagementConfigurer<H> sessionAuthenticationErrorUrl(StringSE sessionAuthenticationErrorUrl)

  SessionAuthenticationStrategy が例外を発生させたときに表示されるエラーページの URL を定義します。設定されていない場合、不正な (402) エラーコードがクライアントに返されます。認証が失敗した URL が優先されるフォームベースのログイン中にエラーが発生した場合、この属性は適用されないことに注意してください。

  パラメーター:

  sessionAuthenticationErrorUrl - リダイレクト先の URL

  戻り値:

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

• sessionAuthenticationFailureHandler

  public SessionManagementConfigurer<H> sessionAuthenticationFailureHandler(AuthenticationFailureHandler sessionAuthenticationFailureHandler)

  SessionAuthenticationStrategy が例外を発生させるときに使用される AuthenticationFailureHandler を定義します。設定されていない場合、不正な (402) エラーコードがクライアントに返されます。認証が失敗した URL が優先されるフォームベースのログイン中にエラーが発生した場合、この属性は適用されないことに注意してください。

  パラメーター:

  sessionAuthenticationFailureHandler - 使用するハンドラー

  戻り値:

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

• enableSessionUrlRewriting

  public SessionManagementConfigurer<H> enableSessionUrlRewriting(boolean enableSessionUrlRewriting)

  true に設定すると、HttpServletResponse.encodeRedirectURL(String) または HttpServletResponse.encodeURL(String) を使用するときに HTTP セッションを URL に書き換えることができます。それ以外の場合、HTTP セッションを URL に含めることはできません。これにより、外部ドメインに情報が漏洩することを防ぎます。

  これは、HttpServletResponse.encodeURL(java.lang.String) および HttpServletResponse.encodeRedirectURL(java.lang.String) の呼び出しを保護することによって実現されます。ResourceUrlEncodingFilter のように、これら 2 つの方法のいずれかをオーバーライドするコードは、セキュリティフィルターチェーンの後に来る必要があります。そうしないと、スキップされるリスクがあります。

  パラメーター:

  enableSessionUrlRewriting - JSESSIONID を URL に書き換えられるようにする必要がある場合は true、そうでない場合は false (default)

  戻り値:

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

  関連事項:

  • HttpSessionSecurityContextRepository.setDisableUrlRewriting(boolean)

• sessionCreationPolicy

  public SessionManagementConfigurer<H> sessionCreationPolicy(SessionCreationPolicy sessionCreationPolicy)

  SessionCreationPolicy を指定できます

  パラメーター:

  sessionCreationPolicy - 使用する SessionCreationPolicy。null にはできません。

  戻り値:

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

  例外:

  IllegalArgumentExceptionSE - SessionCreationPolicy が null の場合。

  関連事項:

  • SessionCreationPolicy

• sessionAuthenticationStrategy

  public SessionManagementConfigurer<H> sessionAuthenticationStrategy(SessionAuthenticationStrategy sessionAuthenticationStrategy)

  SessionAuthenticationStrategy を明示的に指定できます。デフォルトでは ChangeSessionIdAuthenticationStrategy を使用します。セッションの最大数を制限するように構成されている場合、CompositeSessionAuthenticationStrategy が ConcurrentSessionControlAuthenticationStrategy に委譲します。ConcurrentSessionControlAuthenticationStrategy は、デフォルトの OR が提供する SessionAuthenticationStrategy および RegisterSessionAuthenticationStrategy です。

  NOTE: カスタム SessionAuthenticationStrategy を指定すると、デフォルトのセッション固定戦略がオーバーライドされます。

  パラメーター:

  sessionAuthenticationStrategy -

  戻り値:

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

• addSessionAuthenticationStrategy

  public SessionManagementConfigurer<H> addSessionAuthenticationStrategy(SessionAuthenticationStrategy sessionAuthenticationStrategy)

  CompositeSessionAuthenticationStrategy 内で使用される追加の SessionAuthenticationStrategy を追加します。

  パラメーター:

  sessionAuthenticationStrategy -

  戻り値:

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

• sessionFixation

  public SessionManagementConfigurer<H>.SessionFixationConfigurer sessionFixation()

  デフォルトの SessionFixationProtectionStrategy を変更できます。

  戻り値:

  さらなるカスタマイズのための SessionManagementConfigurer<H extends HttpSecurityBuilder<H>>.SessionFixationConfigurer 

• sessionFixation

  public SessionManagementConfigurer<H> sessionFixation(Customizer<SessionManagementConfigurer<H>.SessionFixationConfigurer> sessionFixationCustomizer)

  セッション固定保護を構成できます。

  パラメーター:

  sessionFixationCustomizer - SessionManagementConfigurer<H extends HttpSecurityBuilder<H>>.SessionFixationConfigurer により多くのオプションを提供する Customizer

  戻り値:

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

• maximumSessions

  public SessionManagementConfigurer<H>.ConcurrencyControlConfigurer maximumSessions(int maximumSessions)

  ユーザーの最大セッション数を制御します。デフォルトでは、任意の数のセッションが許可されます。

  パラメーター:

  maximumSessions - ユーザーの最大セッション数

  戻り値:

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

• sessionConcurrency

  public SessionManagementConfigurer<H> sessionConcurrency(Customizer<SessionManagementConfigurer<H>.ConcurrencyControlConfigurer> sessionConcurrencyCustomizer)

  ユーザーのセッションの最大数を制御します。デフォルトでは、任意の数のユーザーを許可します。

  パラメーター:

  sessionConcurrencyCustomizer - SessionManagementConfigurer<H extends HttpSecurityBuilder<H>>.ConcurrencyControlConfigurer により多くのオプションを提供する Customizer

  戻り値:

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

• init

  public void init(H http)

  インターフェースからコピーされた説明: SecurityConfigurer

  SecurityBuilder を初期化します。ここでは、共有状態のみを作成および変更する必要がありますが、オブジェクトの構築に使用される SecurityBuilder のプロパティは作成および変更しないでください。これにより、構築時に SecurityConfigurer.configure(SecurityBuilder) メソッドが正しい共有オブジェクトを使用するようになります。ここで設定を適用する必要があります。

  次で指定:

  インターフェース SecurityConfigurer<DefaultSecurityFilterChain,H extends HttpSecurityBuilder<H>> の init 

  オーバーライド:

  クラス SecurityConfigurerAdapter<DefaultSecurityFilterChain,H extends HttpSecurityBuilder<H>> の init 

• configure

  public void configure(H http)

  インターフェースからコピーされた説明: SecurityConfigurer

  SecurityBuilder に必要なプロパティを設定して、SecurityBuilder を構成します。

  次で指定:

  インターフェース SecurityConfigurer<DefaultSecurityFilterChain,H extends HttpSecurityBuilder<H>> の configure 

  オーバーライド:

  クラス SecurityConfigurerAdapter<DefaultSecurityFilterChain,H extends HttpSecurityBuilder<H>> の configure