パッケージ jakarta.security.auth.message.callback

クラス CallerPrincipalCallback

java.lang.ObjectSE
jakarta.security.auth.message.callback.CallerPrincipalCallback
実装されているすべてのインターフェース:
CallbackSE
public class CallerPrincipalCallback extends ObjectSE implements CallbackSE
コンテナーの呼び出し元（またはリモートユーザー）プリンシパルを設定するためのコールバック。

このコールバックは、validateRequest 処理中に serverAuthModule によって呼び出されることを目的としています。

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

    • CallerPrincipalCallback

      public CallerPrincipalCallback(SubjectSE subject, PrincipalSE principal)
      CallerPrincipalCallback を作成して、呼び出し元プリンシパルのコンテナーの表現を設定します

      CallbackHandler は、引数 Principal を使用して、コンテナーによって処理されている呼び出しに関連付けられた呼び出し元プリンシパルを確立する必要があります。引数 Principal が null の場合、ハンドラーは、認証されていない呼び出し元プリンシパルのコンテナーの表現を確立する必要があります。

      ハンドラーは、非 null の引数 Principal 値のプリンシパルマッピングを実行できますが、非 null の引数 Principal を呼び出し元のプリンシパルとして確立するようにハンドラーを構成できる必要があります。

      パラメーター:
      subject - コンテナーが呼び出し元 ID を区別するサブジェクト。
      principal - 呼び出し元プリンシパルとして区別されるプリンシパル。この値は null の可能性があります。

    • CallerPrincipalCallback

      public CallerPrincipalCallback(SubjectSE subject, StringSE name)
      CallerPrincipalCallback を作成して、呼び出し元プリンシパルのコンテナーの表現を設定します。

      CallbackHandler は、name 引数を使用して、コンテナーによって処理されている呼び出しに関連付けられた呼び出し元プリンシパルを確立する必要があります。name 引数が null の場合、ハンドラーは、認証されていない呼び出し元プリンシパルのコンテナーの表現を確立する必要があります（コンテナーの型の要件に応じて、null に等しい場合と等しくない場合があります）。

      ハンドラーは、name の非 null 値のプリンシパルマッピングを実行できますが、確立されたプリンシパルで getName が呼び出されたときに返される値として、非 null 引数値を確立するようにハンドラーを構成できる必要があります。

      パラメーター:
      subject - コンテナーが呼び出し元 ID を区別するサブジェクト。
      name - 呼び出し元プリンシパルまたは null として確立されたプリンシパルで getName() が呼び出されたときに返される文字列値。

  • メソッドの詳細

    • getSubject

      public SubjectSE getSubject()
      ハンドラーが呼び出し元のプリンシパルを区別するサブジェクトを取得します
      戻り値:
      件名。

    • getPrincipal

      public PrincipalSE getPrincipal()
      呼び出し元のプリンシパルを取得します。

      このメソッドと getName メソッドによって返される値が null の場合、ハンドラーは サブジェクト内で認証されていない呼び出し元プリンシパルのコンテナー表現を確立する必要があります。

      戻り値:
      プリンシパルまたは null。

    • getName

      public StringSE getName()
      呼び出し元のプリンシパル名を取得します。

      このメソッドと getPrincipal メソッドによって返される値が null の場合、ハンドラーは サブジェクト内で認証されていない呼び出し元プリンシパルのコンテナー表現を確立する必要があります。

      戻り値:
      プリンシパル名または null。