本文へスキップ
AWS DAILY
重要度:通常新機能確認推奨

Amazon API Gateway REST APIがネイティブJWTオーソライザーをサポート、Lambda不要でトークン検証が可能に

公開
更新

概要

Amazon API GatewayのREST APIで、JWTをゲートウェイ内で直接検証するネイティブJWTオーソライザーが利用可能になりました。これまでAmazon Cognito以外のOpenID ConnectやOAuth 2.0プロバイダーのトークン検証にはLambdaオーソライザーが必要でしたが、コードの記述・運用なしに設定だけで実現できます。

変更内容

  • REST API向けのネイティブJWTオーソライザーが新しいオーソライザータイプとして追加された
  • Amazon Cognito以外のOpenID ConnectおよびOAuth 2.0プロバイダーのトークン検証がLambdaなしで設定可能になった
  • 発行者(issuer)、受け入れるaudience、署名アルゴリズム、追加クレームをそれぞれ定義できる
  • API Gatewayがリクエストごとにトークンの署名・issuer・audience・有効期限・クレームを検証する
  • 1つのオーソライザーを複数のメソッドにアタッチし、メソッドごとに異なるスコープを要求できる
  • Regional、エッジ最適化、プライベートのすべてのREST APIタイプで動作する
  • すべての商用AWSリージョンおよびAWS GovCloud (US) リージョンで利用可能

公式発表で確認できる事実

  • Amazon API GatewayのREST APIに、JWTをゲートウェイ内で直接検証するネイティブJWTオーソライザーが追加されました。
  • これまでAmazon Cognito以外のOpenID ConnectまたはOAuth 2.0 IDプロバイダーのトークン検証にはLambdaオーソライザーの実装が必要でした。
  • 新しいJWTオーソライザーでは以下の項目を設定できます。
    • 1つ以上の発行者(issuer)
    • 各issuerに対して受け入れるaudience
    • 許可する署名アルゴリズム
    • トークンに含まれる追加クレーム
  • API Gatewayはリクエストごとにトークンの署名・issuer・audience・有効期限・クレームを自動的に検証します。
  • 1つのオーソライザーを複数のメソッドにアタッチし、メソッドごとに異なるスコープを要求することができます。
  • 対応するAPIタイプはRegional、エッジ最適化、プライベートのREST APIです。
  • すべての商用AWSリージョンおよびAWS GovCloud (US) リージョンで利用可能です。
  • ユースケースとして、マシン間API、モバイル・Webバックエンド、複数のIDプロバイダーからトークンを受け付けるマルチテナントAPIが挙げられています。

当サイトの考察

これまでCognito以外のIDプロバイダー(Auth0、Okta、Azure AD等)を利用する場合、JWT検証ロジックをLambda関数として実装・維持する必要がありました。ネイティブJWTオーソライザーにより、その実装コストと運用負荷が大幅に削減されます。

Lambdaオーソライザーはコールドスタートや実行時間によるレイテンシーが課題になることがありましたが、ゲートウェイ内での検証はそのオーバーヘッドを排除できる可能性があります。ただし、Lambdaオーソライザーで実現していた複雑なカスタムロジック(動的なポリシー生成など)が必要な場合は引き続きLambdaオーソライザーが適切な選択肢です。

確認できていない事項

  • 東京リージョン(ap-northeast-1)および大阪リージョン(ap-northeast-3)での具体的な提供状況は資料のリージョン表記から直接確認できません(「すべての商用AWSリージョン」との記載はあります)
  • ネイティブJWTオーソライザーの利用に伴う追加料金の有無および金額
  • 既存のLambdaオーソライザーからネイティブJWTオーソライザーへの移行ツールや自動変換機能の有無
  • サポートされる具体的な署名アルゴリズムの一覧

この記事は、AWS 公式の発表をもとに AI が作成し、自動で公開しています。

既存環境への影響

Lambdaオーソライザーを使ってJWT検証を実装していたユーザーは、コードの記述・デプロイ・運用が不要になり、設定ベースの検証に移行できます。マシン間API、モバイル・Webバックエンド、複数のIDプロバイダーからトークンを受け付けるマルチテナントAPIに適しています。既存のLambdaオーソライザーは引き続き動作するため、既存環境への強制的な影響はありません。

対応の必要性

確認推奨

LambdaオーソライザーでJWT検証を実装している場合、ネイティブJWTオーソライザーへの移行を検討することで運用コストと管理負荷を削減できます。新規実装ではネイティブJWTオーソライザーの利用を推奨します。

利用可能リージョン

東京(ap-northeast-1)
提供中
大阪(ap-northeast-3)
提供中

公式記事の「all AWS Regions」の記載を、東京と大阪にも当てはめています。個別のリージョン一覧は確認していません。

AWS 公式情報

当サイトの記事は公式情報をもとに編集したものです。正確な内容は必ず AWS 公式情報をご確認ください。

重要度:通常新機能

Amazon API Gateway REST APIがネイティブJWTオーソライザーをサポート、Lambda不要でトークン検証が可能に

Amazon API GatewayのREST APIで、JWTをゲートウェイ内で直接検証するネイティブJWTオーソライザーが利用可能になりました。これまでCognito以外のOIDC/OAuth 2.0プロバイダーのトークン検証にはLambdaオーソライザーが必要でしたが、コードの記述・運用なしに設定だけで実現できます。