すべてのプロダクト
Search

このプロダクト

    Server Load Balancer:HTTPヘッダー

    ドキュメントセンター

    Server Load Balancer:HTTPヘッダー

    最終更新日:Sep 20, 2024

    このトピックでは、Application Load Balancer (ALB) でサポートされている非標準HTTPヘッダーと、非標準HTTPヘッダーをリスナーに追加する方法について説明します。 非標準ヘッダーをカスタマイズして、機能を実装できます。

    ALBでサポートされている非標準HTTPヘッダー

    HTTPヘッダは、HTTP要求または応答の一部であり、要求または応答に関する追加情報を搬送する。 ビジネス要件に基づいて、ブラウザまたはwebサーバーで非標準HTTPヘッダーを構成できます。 次の表に、ALBでサポートされている非標準HTTPヘッダーを示します。

    ヘッダー

    説明

    リスナープロトコル

    X-Forwarded-For

    リスナーはX-Forwarded-Forヘッダーを使用してクライアントIPアドレスを取得できます。

    形式：

    X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, …

    X-Forwarded-Forは、デフォルトでALBリスナーに対して有効になっています。

    ALBを有効にしてクライアントIPアドレスを保持する方法の詳細については、「ALBを有効にしてクライアントIPアドレスを保持する」をご参照ください。

    • HTTP

    • HTTPS

    SLB-ID

    リスナーはSLB-IDを使用してALBインスタンスIDを取得できます。

    • HTTP

    • HTTPS

    • QUIC

    X-Forwarded-For

    リスナーは、X-Forwarded-Protoヘッダーを使用して、クライアントとリスナー間のプロトコルを取得できます。 このようにして、アプリケーションはX-Forwarded-Protoヘッダー内のプロトコルを識別し、リダイレクトを実行できます。

    形式：

    X-Forwarded-Proto: <originatingProtocol>

    • HTTP

    • HTTPS

    • QUIC

    X-転送ポート

    リスナーは、X-Forwarded-Portヘッダーを使用して、クライアントとリスナーが通信するポートを取得できます。

    形式：

    X-Forwarded-Port: <port>

    • HTTP

    • HTTPS

    • QUIC

    X-転送済み-Clientcert-subjectdn

    リスナーは、X-Forwarded-Clientcert-subjectdnヘッダーを使用して、クライアント証明書の所有者に関する情報を取得できます。

    このヘッダーを使用するには、カスタムヘッダーの名前を指定する必要があります。

    HTTPS

    X-転送-Clientcert-issuerdn

    リスナーは、X-Forwarded-Clientcert-issuerdnヘッダーを使用して、クライアント認証局に関する情報を取得できます。

    このヘッダーを使用するには、カスタムヘッダーの名前を指定する必要があります。

    HTTPS

    X-Forwarded-Clientcert-fingerprint

    リスナーは、X-Forwarded-Clientcert-fingerprintヘッダーを使用して、クライアント証明書のフィンガープリント値を取得できます。

    このヘッダーを使用するには、カスタムヘッダーの名前を指定する必要があります。

    HTTPS

    X-Forwarded-Clientcert-clientverify

    リスナーは、X-Forwarded-Clientcert-clientverifyヘッダーを使用して、クライアント証明書の認証結果を取得できます。

    このヘッダーを使用するには、カスタムヘッダーの名前を指定する必要があります。

    HTTPS

    X-Forwarded-Client-srcport

    リスナーは、X-Forwarded-Client-srcportを使用してクライアントポートを取得できます。

    形式：

    X-Forwarded-Client-srcport: <port>

    • HTTP

    • HTTPS

    コンソールでHTTPヘッダーを追加する

    リスナーを作成するときにHTTPヘッダーを追加する

    1. ALBコンソールにログインします。

    2. 上部のナビゲーションバーで、ALBインスタンスがデプロイされているリージョンを選択します。

    3. 次のいずれかの方法を使用して、リスナー構成ウィザードを開きます。

      • インスタンス ページで、管理するALBインスタンスを見つけ、[操作] 列の リスナーの作成 をクリックします。

      • インスタンス ページで、管理するALBインスタンスのIDをクリックします。 リスナー タブで、リスナーの作成 をクリックします。

    4. リスナーの設定ステップで、以下のパラメータを設定し、次へをクリックします。

      パラメーター

      説明

      リスナープロトコル

      リスナープロトコルを選択します。

      詳細設定

      [変更] をクリックして、詳細設定を設定できます。

      追加のHTTPヘッダー

      追加するHTTPヘッダーを選択します。

      説明

      その他のパラメーターの詳細については、以下のトピックを参照してください。

    5. プロンプトに従って設定を完了します。

    既存のリスナーにHTTPヘッダーを追加する

    1. ALBコンソールにログインします。

    2. 上部のナビゲーションバーで、ALBインスタンスがデプロイされているリージョンを選択します。

    3. インスタンスページで、管理するALBインスタンスのIDをクリックします。

    4. をクリックし、リスナータブで、管理するリスナーを見つけて選択します。アクション列で更多リスナーの変更を選択します。

    5. リスナーの変更ダイアログボックスで、詳細設定の右側で変更をクリックします。

    6. 追加のHTTPヘッダーセクションでHTTPヘッダーを追加または削除し、保存をクリックします。

    API呼び出しによるHTTPヘッダーの追加

    APIを呼び出してリスナーを作成するときに追加するヘッダーを指定できます。 APIを呼び出して、既存のリスナーのヘッダーを追加、保持、または削除するとき。

    • リスナーの作成時にHTTPヘッダーを追加するには、CreateListener操作を呼び出すときにXForwardedForConfigパラメーターを設定します。

    • 既存のリスナーのHTTPヘッダーを管理するには、UpdateListenerAttribute操作を呼び出すときにXForwardedForConfigパラメーターを変更します。

    関連ドキュメント

    コンソール操作

    • ALBがHTTPリクエストを転送できるようにする方法の詳細については、「HTTPリスナーの追加」をご参照ください。

    • ALBがHTTPSリクエストを転送できるようにする方法の詳細については、「HTTPSリスナーの追加」をご参照ください。

    • ALBによるQUICリクエストの転送方法の詳細については、「QUICリスナーの追加」をご参照ください。

    API参照

    • CreateListener: HTTP、HTTPS、またはQUICリスナーを作成します。 リクエストにXForwardedForConfigパラメーターを設定して、HTTPヘッダーを追加できます。

    • UpdateListenerAttribute: リスナーの設定を変更します。 リクエストのXForwardedForConfigパラメーターを変更して、HTTPヘッダーを追加、保持、または削除できます。