Function Compute:カスタムドメイン名に JWT 認証を設定

ステップ 1: カスタムドメイン名設定を開く

1. Function Compute コンソールにログインします。 左側のナビゲーションウィンドウで、[高度な機能] > [カスタムドメイン] を選択します。

2. 上部のナビゲーションバーで、ご利用のカスタムドメイン名が存在するリージョンを選択します。

3. [カスタムドメイン] ページで、設定するドメイン名をクリックします。

4. 右上隅で、[変更] をクリックします。

ステップ 2: JWT 認証を有効化

「カスタムドメイン名の変更」ページで、[認証方法] を [JWT 認証] に設定します。

ステップ 3: JWKS の構成

JWT 認証では、公開鍵を含む有効な JWKS が必要です。オンライン ツール（例： mkjwk.org）を使用して生成できます。PEM 形式の秘密鍵をお持ちの場合は、jwx などのツールを使用して JWKS 形式に変換します。

mkjwk.org で JWKS を生成するには、[キー使用目的]、[アルゴリズム]、および [X.509 を表示] を設定し、[生成] をクリックします。このツールは 2 つのキーを生成します：

• ① 秘密鍵 — コードでこれを使用して JWT トークンに署名 (発行) します。機密保持してください。

• ② 公開鍵 — これを Function Compute コンソールの keys 配列に貼り付けます。

コンソールに貼り付ける JWKS は次の構造に従います。

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

ステップ 4: JWT トークンの場所を構成

「JWT トークンの設定」セクションで、「読み取り位置」（ヘッダー、Cookie、クエリパラメーター、またはフォームパラメーター）と、Function Compute がトークンを検索するパラメーター名を設定します。

［読み取り位置］を［Header］に設定する場合は、［プレフィックスの削除］の値を指定してください。Function Compute は、トークンを解析する前にこのプレフィックスを削除します。たとえば、プレフィックスを Bearer に設定すると、リクエストヘッダー Authorization: Bearer <token> によって、Function Compute は <token> を抽出して検証します。

ステップ 5: クレーム転送の構成 (オプション)

「[JWT クレーム変換]」セクションで、JWT クレームを関数パラメーターにマッピングします。各マッピングについて、以下の項目を指定します：

• マッピングパラメーター位置 — クレームを転送する場所 (ヘッダー、Cookie、クエリパラメーター、またはフォームパラメーター)

• トークン内の元のクレーム名

• 関数に渡されるパラメーター名

ステップ 6: 構成を保存

[保存] をクリックします。

テストトークンの生成

1. PyJWT モジュールをインストールします。「PyJWT」をご参照ください。

2. 次の Python スクリプトをローカルで実行してトークンを生成します。秘密鍵のプレースホルダーを、JWKS 生成ステップからの X.509 PEM 秘密鍵に置き換えます。

import jwt
import time

private_key = """
-----BEGIN PRIVATE KEY-----
<Your X.509 PEM private key>
-----END PRIVATE KEY-----
"""

headers = {
    "alg": "RS256",
    "typ": "JWT"
}

payload = {
    "sub": "1234567890",
    "name": "John Snow",
    "iat": int(time.time()),              # Token issuance time
    "exp": int(time.time()) + 60 * 60,   # Token expires in 1 hour
}

encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
print("Generated token: %s" % encoded)

Postman でテスト

1. Function Compute コンソールで、[高度な機能] > [カスタムドメイン] に移動します。カスタムドメイン名をコピーし、Postman の URL フィールドに貼り付けます。

2. リクエストヘッダーを追加して、[JWT トークン設定] の設定と一致させます。たとえば、パラメーター名が Authentication で、プレフィックスが Bearer の場合:

   重要

   リクエストヘッダー内の JWT のフォーマットが、設定された [プレフィックスの削除] 設定と一致していることを確認してください。不一致がある場合、無効または期限切れの JWT エラーが返されます。

   パラメーター	値	説明
   Key	Authentication	JWT トークン設定
   Value	Bearer <your-jwt-token>	構成されたプレフィックス、スペース、および前のステップで生成されたトークン

3. 「[送信]」をクリックして、応答を確認します。

クレーム転送が構成されている場合、応答はクレームが関数に渡されたことを確認します。たとえば、nametofunction はクレームマッピングからの転送されたパラメーター名です。