すべてのプロダクト
Search
ドキュメントセンター

API Gateway:コンシューマーの作成

最終更新日:Nov 09, 2025

AI Gateway は、コンシューマーを使用してルートと API を認証します。このトピックでは、AI Gateway コンソールでコンシューマーを作成および管理する方法について説明します。

手順

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

  2. 左側のナビゲーションウィンドウで、[コンシューマー] を選択します。上部のナビゲーションバーでリージョンを選択します。

  3. [コンシューマー] ページの左上隅にある [コンシューマーの作成] をクリックします。

  4. [コンシューマーの作成] ページで、コンシューマー名を入力し、認証方式を選択して、[作成] をクリックします。

    JWT 認証

    image

    次の表にパラメーターを示します。

    設定項目

    説明

    コンシューマー名

    コンシューマーのカスタム名。

    ステータス

    コンシューマーのステータス。 [有効] または [無効] に設定できます。コンシューマーを作成した後、手動で 有効 または 無効 にできます。

    説明

    コンシューマーの説明。

    認証方式

    コンシューマーでサポートされている認証方式。現在、JWT と API Key がサポートされています。

    キータイプ

    • 対称キー: デフォルトの JSON Web Key Set (JWKS) 構成が生成されます。この構成は各コンシューマーに固有であり、トークンの暗号化または復号に使用されるキーが含まれています。

    • 非対称キー: 完全な JWKS 構成を入力する必要があります。秘密鍵を使用してトークンを暗号化します。ゲートウェイは、JWKS で構成された公開鍵を復号に使用します。

    JWKS

    JWKS の仕様の詳細については、「JSON Web Key (JWK)」をご参照ください。

    JWKS トークン構成

    • タイプ: トークンパラメーターのタイプ。デフォルトは Header です。

    • キー: トークンパラメーターの名前。

    • プレフィックス: トークンパラメーター名のプレフィックス。検証が必要なトークンパラメーター情報を構成します。デフォルトでは、トークンは Bearer プレフィックス付きで Authorization Header に配置されます。例: Authorization: Bearer token

    • パススルー: このオプションを選択すると、トークンパラメーターがバックエンドサービスに渡されます。

    JWKS ペイロード内のコンシューマー ID

    JWKS ペイロードからキーとそれに対応する値を指定して、現在のコンシューマーを識別します。デフォルトでは、キーが uid で、値がランダムな文字列であるキーと値のペアが提供されます。必要に応じて変更できます。

    次のコードは、ペイロード構成のサンプルを示しています。

    {
      "uid": "11215ac069234abcb8944232b79ae711"
    }

    API Key 認証

    image

    次の表にパラメーターを示します。

    設定項目

    説明

    コンシューマー名

    コンシューマーのカスタム名。

    ステータス

    コンシューマーのステータス。 [有効] または [無効] に設定できます。コンシューマーを作成した後、手動で 有効 または 無効 にできます。

    説明

    コンシューマーの説明。

    認証方式

    コンシューマーでサポートされている認証方式。現在、JWT と API Key がサポートされています。

    生成方式

    • システム生成: システムが自動的に API キー資格情報を生成します。

    • カスタム: カスタム API キー資格情報とそのソースを指定します。

    資格情報

    カスタム API キー資格情報。

    資格情報ソース

    ゲートウェイがリクエストから資格情報をフェッチする場所。次の場所がサポートされています。

    • Authorization: Bearer <token>

    • カスタム HTTP ヘッダー

    • カスタムクエリパラメーター