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-nZJ2ZaYzbLUtAW5_U2kfRVkDNa8d1g__2V5zjU6nfLJ1S2MoXMgRgDPeHpEehZVu2kNaSFvDUQ",
            "use": "sig"
        }
    ]
}

ステップ4：JWT トークンの場所の設定

[JWT トークン設定] セクションで、[読み取り位置] (ヘッダー、Cookie、クエリパラメーター、またはフォームパラメーター) および Function Compute がトークンを検索するパラメーター名を設定します。

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

ステップ5：クレーム転送の設定 (オプション)

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

• [マッピングパラメーター位置] — クレームを転送する場所 (Header、Cookie、Query Parameters、または Form Parameters)

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

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

ステップ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": "田中一郎",
    "iat": int(time.time()),              # トークン発行時刻
    "exp": int(time.time()) + 60 * 60,   # トークンは1時間後に失効します
}

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 のフォーマットが、設定された [プレフィックスの削除] 設定と一致することを確認してください。一致しない場合、invalid or expired jwt エラーが返されます。

   パラメーター	値	説明
   Key	Authorization	[JWT Token Configuration] で設定したパラメーター名
   Value	Bearer <your-jwt-token>	設定したプレフィックス、スペース、および前の手順で生成したトークン

3. [送信] をクリックして、レスポンスを確認します。

クレーム転送が設定されている場合、レスポンスはクレームが関数に渡されたことを示します。たとえば、nametofunction は、クレームマッピングから転送されたパラメーター名です。