モジュール jdk.httpserver
パッケージ com.sun.net.httpserver

クラスBasicAuthenticator


  • public abstract class BasicAuthenticator
extends Authenticator
    BasicAuthenticatorは、HTTP基本認証の実装を提供します。 これはabstractクラスであり、各着信要求を検証するために呼び出されるcheckCredentials(String,String)の実装を提供するには、拡張する必要があります。

    • フィールドの詳細

      • realm

        protected String realm

    • コンストラクタの詳細

      • BasicAuthenticator

        public BasicAuthenticator​(String realm)
        指定されたHTTPレルムのためのBasicAuthenticatorを作成します。
        パラメータ:
        realm - HTTP基本認証レルム
        例外:
        NullPointerException - レルムが空の文字列である場合

    • メソッドの詳細

      • getRealm

        public String getRealm​()
        このBasicAuthenticatorが作成されたレルムを返します。
        戻り値:
        オーセンティケータのレルム文字列。

      • authenticate

        public Authenticator.Result authenticate​(HttpExchange t)
        次のクラスからコピーされた説明: Authenticator
        各着信要求を認証するために呼び出されます。 実装は、必要に応じてFailure、Success、またはRetryオブジェクトを返す必要があります。

        Failureは、認証は完了したが、無効な資格のために失敗したことを意味します。

        Sucessは、認証が正常に行われ、Sucess.getPrincipal()を呼び出すことでユーザーを表すPrincipalオブジェクトを取得できることを意味します。

        Retryは、別のHTTP交換が必要であることを意味します。 クライアントに送り返す必要がある応答ヘッダーは、指定されたHttpExchangeに設定されます。 返される応答コードをRetryオブジェクトに提供する必要があります。 Retryは複数回発生することがあります。

        定義:
        authenticate 、クラス:  Authenticator

      • checkCredentials

        public abstract boolean checkCredentials​(String username,
                                         String password)
        指定された名前とパスワードをこのAuthenticatorのレルムのコンテキストで検証するために、着信要求ごとに呼び出されます。 資格のキャッシュは、このメソッドの実装によって行う必要があります。
        パラメータ:
        username - 要求からのユーザー名
        password - 要求からのパスワード
        戻り値:
        資格が有効な場合はtrue、そうでない場合はfalse。