Function Compute:HTTPトリガーのJWT認証の設定

1. Function Computeコンソールにログインします。 左側のナビゲーションウィンドウで、[サービスと機能] をクリックします。

2. 上部のナビゲーションバーで、リージョンを選択します。 [サービス] ページで、目的のサービスをクリックします。

3. [関数] ページで、目的の関数の名前をクリックします。 表示される [機能の詳細] ページで、[トリガー管理 (URL)] タブをクリックします。

4. トリガー管理 (URL)タブで、HTTPトリガーのアクション列で変更をクリックします。

5. [トリガーの変更] パネルで、次のパラメーターを設定し、OK をクリックします。

   1. [認証方法] を [JWT認証] に設定します。

      

   2. 設定JWKS.

      HTTPトリガーのJWT認証を設定するには、有効なJWKSを指定する必要があります。 手動でJWKSを準備するか、WebブラウザーでJSON web Keyジェネレーターを検索して、mkjwk.orgなどのオンラインジェネレーターを使用することができます。 プライバシー強化メール (PEM) 形式のキーがある場合は、jwxなどのツールを使用してキーをJWKS形式に変換できます。

      この例では、mkjwk.orgを使用してJWKSを生成します。 JWKSを生成するページで、Show X.509をYesに設定して秘密鍵を表示します。 プライベートキーを使用してコードでJWTを発行する場合は、安全に保管してください。 Function Computeコンソールで、公開鍵の内容をJWKSのkeys配列にコピーできます。 詳細は以下の図をご参照ください。

      

      サンプルコード：

      {
          "keys": [
              {
                  "alg": "RS256",
                  "e": "AQAB",
                  "kty": "RSA",
                  "n": "u1LWgoomekdOMfB1lEe96OHehd4XRNCbZRm96RqwOYTTc28Sc_U5wKV2umDzolfoI682ct2BNnRRahYgZPhbOCzHYM6i8sRXjz9Ghx3QHw9zrYACtArwQxrTFiejbfzDPGdPrMQg7T8wjtLtkSyDmCzeXpbIdwmxuLyt_ahLfHelr94kEksMDa42V4Fi5bMW4cCLjlEKzBEHGmFdT8UbLPCvpgsM84JK63e5ifdeI9NdadbC8ZMiR--dFCujT7AgRRyMzxgdn2l-nZJ2ZaYzbLUtAW5_U2kfRVkDNa8d1g__2V5zjU6nfLJ1S2MoXMgRgDPeHpEehZVu2kNaSFvDUQ",
                  "use": "sig"
              }
          ]
      }

   3. [JWTトークン設定] セクションで、トークンの読み取り位置とトークンの名前を選択します。

      トークンの読み取り位置パラメーターをヘッダー、Cookie、クエリパラメーター、またはフォームパラメーターに設定できます。 トークンの読み取り位置パラメーターをヘッダーに設定した場合、Function Computeがトークンを取得するときに削除するプレフィックスを指定する必要があります。

   4. では、JWTクレーム変換セクションで、パラメーターを関数に渡す位置、パラメーターの元の名前、およびパラメーターが関数に渡された後のパラメーターの新しい名前を選択します。

      マッピングパラメーターの位置パラメーターをヘッダー、Cookie、クエリパラメーター、またはフォームパラメーターに設定できます。

   5. リクエストマッチングモードを指定します。

      • すべて一致: すべてのHTTPリクエストは、JWTを使用して検証する必要があります。

      • ホワイトリストモード: [リクエストパスのホワイトリスト] で指定されたパスから送信されたHTTPリクエストは、JWTを使用して検証されません。 他の要求は、JWTを使用して検証される。

      • ブラックリストモード: [リクエストパスのブラックリスト] で指定されたパスから送信されたHTTPリクエストは、JWTを使用して検証されます。 その他のリクエストは、JWTを使用して検証されません。

      ホワイトリストモードとブラックリストモードは、次の対応モードをサポートしています。

      • 完全一致

        パスが指定されたパスとまったく同じである場合にのみ、パスが一致します。 たとえば、[リクエストパスのブラックリスト] パラメーターを /aに設定した場合、/aから送信されるリクエストにはJWT検証が必要です。 /a/ から送信されるリクエストには、JWT検証は必要ありません。

      • ファジーマッチ

        値は、アスタリスクのワイルドカード (*) が付加されたパスに設定できます。 たとえば、[リクエストパスのブラックリスト] パラメーターを /login/* に設定した場合、/login/ というプレフィックスが付いたパス (/login/aや /login/b/c/dなど) から送信されたリクエストは、JWTを使用して検証されます。

このセクションでは、インターネットエンドポイント、内部エンドポイント、トークンなどのHTTPトリガーの設定に基づいて、ツールを使用してHTTPサービスに期待どおりにアクセスできるかどうかについて説明します。 このセクションでは、デバッグとテストにPostmanを使用します。

1. 手順1で生成された秘密鍵を使用してJWTを作成します。

2. Postmanを使用して、HTTPサービスにアクセスできるかどうかを確認します。

   1. 管理する関数の [トリガー管理 (URL)] タブで、HTTPトリガーのインターネットエンドポイントを取得します。 次に、Postmanページのアドレスバーにエンドポイントを入力します。

   2. Postmanのヘッダーでトークンのパラメーターを設定します。 次の表に、トークンの設定を示します。

      パラメーター	値	説明
      Key	認証	[JWTトークン設定] セクションで指定したトークンの名前。
      値	ベアラーeyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiSm9uIFNub3ciLCJhZG1pbiI6dHJ1ZSwiZXhwIjo0ODI5NTk3NjQxfQ.eRcobbpjAd3OSMxcWbmbicOTLjO2vuLR9F2QZMK4rz1JqfSRHgwQVqNxcfOIO9ckDMNlF_3jtdfCfvXfka-phJZpHmnaQJxmnOA8zA3R4wF4GUQdz5zkt74cK9jLAXpokwrviz2ROehwxTCwa0naRd_N9eFhvTRnP3u7L0xn3ll4iOf8Q4jS0mVLpjyTa5WiBkN5xi9hkFxd__p98Pah_Yf0hVQ2ldGSyTtAMmdM1Bvzad-kdZ_wW0jcctIla9bLnOo-Enr14EsGvziMh_QTZ3HQtJuToSKZ11xkNgaz7an5de6PuF5ISXQzxigpFVIkG765aEDVtEnFkMO0xyPGLg	トークンの読み取りに使用されるヘッダー。 削除するプレフィックスとトークンの間にスペースを残す必要があります。 プレフィックスを除いたヘッダ部分がトークンとして使用される。

   3. HTTPサービスの返された情報を表示するには、[送信] をクリックします。 次の情報が返されます。

      

      返された情報のnametofunctionは、クレームによって関数に渡される名前を示します。