本文へスキップ
AWS DAILY
重要度:通常新機能対応不要

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

公開
更新

概要

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

変更内容

  • REST API向けのネイティブJWTオーソライザーが新しいオーソライザータイプとして追加された
  • 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オーソライザーが必要でしたが、新しいオーソライザータイプにより設定のみで実現できます。
  • 設定可能な項目は、1つ以上のissuer、各issuerに対して受け入れるaudience、許可する署名アルゴリズム、トークンに含まれる追加クレームです。
  • API Gatewayはリクエストごとにトークンの署名・issuer・audience・有効期限・クレームを検証します。
  • 1つのオーソライザーを複数のメソッドにアタッチでき、メソッドごとに異なるスコープを要求できます。
  • マシン間通信API、モバイル・Webバックエンド、複数のIDプロバイダーからのトークンを受け入れるマルチテナントAPIに適しています。
  • Regional、エッジ最適化、プライベートのすべてのREST APIタイプで動作します。
  • すべての商用AWSリージョンおよびAWS GovCloud (US) リージョンで利用可能です。

当サイトの考察

ネイティブJWTオーソライザーの導入により、Lambdaオーソライザーで発生していたコールドスタートの遅延やLambda関数の管理コストを削減できる可能性があります。特にAuth0、Okta、Azure ADなどCognito以外のIDプロバイダーを採用している環境では、認証レイヤーの簡素化につながる実用的な改善です。既存のLambdaオーソライザーは引き続き利用できるため、移行は任意のタイミングで段階的に行えます。

確認できていない事項

  • 東京リージョン(ap-northeast-1)および大阪リージョン(ap-northeast-3)での具体的な提供状況は資料から確認できません(「すべての商用AWSリージョン」との記載はあります)。
  • ネイティブJWTオーソライザー利用時の追加料金の有無および料金体系は資料に記載がありません。
  • 一般提供(GA)の正確な開始日は資料から確認できません。

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

既存環境への影響

既存のLambdaオーソライザーを使ってJWT検証を行っているユーザーは、ネイティブJWTオーソライザーへの移行によりLambda関数の記述・管理・運用コストを削減できます。複数のIDプロバイダーからのトークンを受け入れるマルチテナントAPIや、マシン間通信APIにも対応しており、設計の柔軟性が向上します。既存の構成への強制的な変更はなく、引き続きLambdaオーソライザーも利用できます。

対応の必要性

対応不要

既存のREST APIへの強制的な変更はありません。Cognito以外のIDプロバイダーを使用しLambdaオーソライザーで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オーソライザーが利用可能になりました。これまでAmazon Cognito以外のOpenID ConnectやOAuth 2.0プロバイダーのトークン検証にはLambdaオーソライザーが必要でしたが、コードの記述・運用なしに設定だけで実現できます。