AI エージェントがチケットを更新したり顧客レコードを読み取ったりする場合、それはユーザーに代わって、そのユーザーがアクセスできるアプリケーション内で動作します。ID チームは、アプリごとの OAuth 同意や共有サービスアカウントでは解決できない問題に直面します。つまり、どのエージェントがどのユーザーとしてどのアプリケーションで動作できるか、そしてそれをどう阻止するかという問題です。Okta Cross App Access(XAA)は、ID プロバイダー(IdP)でこの問題を解決します。Okta でエージェントを登録し、管理者がエージェントがアクセスできるアプリケーションを承認し、エージェントがユーザーとして動作を要求するたびに Okta がポリシーを評価します。テストでは、管理者がユーザーのエージェントへの割り当てを削除した後、Okta はそのユーザーの新しいリクエストを約 1 秒以内に拒否し、発行済みのトークンは 5 分以内に期限切れになりました。
Amazon Bedrock AgentCore は、任意のフレームワークやモデルを使用して、大規模にエージェントを構築、接続、最適化するためのプラットフォームです。このソリューションでは、その 2 つの機能を利用して AWS 上で Okta の決定を実行します。Amazon Bedrock AgentCore ランタイムは Okta の許可を検証し、Amazon Bedrock AgentCore Identity はその許可を短期間のアクセストークンと引き換え、エージェントコードが認識しない資格情報をトークンボールトに保持します。テストでは、AgentCore Identity はエンドツーエンドで約 30 秒かかるリクエストに約 0.6 秒を追加しました。
この記事は 2 部構成の前半です。AgentCore ランタイム上で、XAA と AgentCore Identity を介してサインイン済みユーザーとして動作するタスクエージェントを構築します。必要な AgentCore Identity の構成要素を設定し、ツール内で各ユーザーの権限を強制し、測定結果を確認します。各チェックが何を拒否するか、採用したプラクティス、Okta の制御がどのくらい迅速に有効になるかです。第 2 部では、同じガバナンスを Amazon Bedrock AgentCore Gateway の背後に置き、Cedar ポリシー、Amazon EKS 上の 2 番目のエージェント、Amazon CloudWatch の監査証跡を使用します。
ソリューションの概要:Okta はガバナンスプレーンであり、どのエージェントがどのユーザーとしてどのリソースに対して動作できるかを決定します。AgentCore Identity は実行プレーンであり、エージェントの資格情報を保持し、Okta の決定をリソースが受け入れるトークンに変換し、そのトークンに両方の ID を保持します。各リクエストは 3 つのトークンを運び、それぞれが異なる決定を記録します。ID トークンはユーザーが誰かを示し、ID-JAG(Identity Assertion JWT Authorization Grant)は Okta の決定であり、アクセストークンはリソースが受け入れるものです。1 つのリクエストの流れは次のとおりです。ユーザーは OpenID Connect を介して Web フロントエンド(BFF)にサインインします。BFF は各リクエストで、エージェントとして認証され、Okta の組織認可サーバーでユーザーの ID トークンを ID-JAG と交換します(RFC 8693 トークン交換)。Okta はエージェントがアクティブであること、ユーザーがエージェントに割り当てられていること、管理者が要求されたスコープに対してエージェントをターゲット認可サーバーに接続したことを確認します。ID-JAG は 1 回限りで、5 分で期限切れになります。BFF は ID-JAG をベアラートークンとして AgentCore ランタイム上のエージェントを呼び出します。ランタイムの JWT 認可者は、Okta がこのエージェントに発行した ID-JAG のみを受け入れます。ランタイムは AgentCore Identity からワークロードアクセストークンを取得し、エージェントのワークロード ID をユーザーにバインドし、エージェントコードに渡します。このワークロードアクセストークンは AWS 内部のバインディングトークンであり、Okta もリソースも参照しないため、3 つのトークンの 1 つではありません。エージェントは AgentCore Identity にアクセストークンを要求します。AgentCore Identity は、エージェントとして認証され、リソースの Okta カスタム認可サーバーで ID-JAG を JWT 認可グラント(RFC 7523)と引き換えます。Okta はユーザーとエージェントの両方を示し、ユーザーのグループを運ぶ 5 分間のアクセストークンを返します。エージェントはそのトークンで MCP サーバーを呼び出します。タスクマネージャーは、登録されたエージェントがトークンを取得したこと、ユーザーのグループとスコープがツールを許可していることを確認します。
前提条件:Amazon Bedrock AgentCore と Amazon Bedrock の Anthropic Claude モデルへのアクセス権を持つ AWS アカウント(米国西部オレゴン)、AI エージェントの Cross App Access と API アクセス管理(カスタム認可サーバー)が有効な Okta 組織(Okta Integrator 無料プラン組織を使用)、Python 3.11、AWS CLI バージョン 2、boto3 1.43、AgentCore CLI 0.31.1、AgentCore Python SDK 1.24.1、AgentCore リソースと IAM ロールを作成する IAM 権限が必要です。所要時間は約 1 時間です。
Okta でエージェントを登録する:Okta 管理コンソールで、リソース用のカスタム認可サーバーをオーディエンス api://task-manager、カスタムスコープ xaa:read と xaa:write で作成します。OpenID Connect スコープ(openid や profile など)を含む ID-JAG リクエストは Okta が拒否するため、少なくとも 1 つのカスタムスコープを含み、OpenID Connect スコープを含まないようにします。アクセストークンに xaa- で始まるグループにフィルタリングされたグループクレームを追加します。Directory > AI Agents に移動し、Register AI agent、手動登録を選択し、リンクされた OpenID Connect アプリを作成します。クライアント登録でクライアントシークレットを選択し、シークレットを生成してエージェントをアクティブ化します。エージェントとアプリは 1 つのクライアント ID を共有し、そのアプリがユーザーをサインインさせる必要があります。エージェントの Resource connections タブで、必要なスコープに限定して認可サーバーに接続します。カスタム認可サーバーに、エージェントの JWT ベアラーグラントを許可するアクセスポリシールールを追加し、アクセストークンの有効期間を 5 分に設定します。エージェントを介して動作する可能性のあるユーザーまたはグループを割り当て、リンクされたアプリを介してサインインできるようにします。
AgentCore Identity を設定する:AgentCore Identity は 3 つを保持します。ワークロード ID(AWS 上のエージェントの ID で、リクエストごとにサインインユーザーにバインドされ、AgentCore ランタイムが管理)、OAuth2 資格情報プロバイダー(エージェントの Okta クライアント ID とシークレット、および使用するグラントで、Okta エージェントごとに 1 回作成)、トークンボールト(プロバイダーが取得したアクセストークンで、AgentCore Identity が作成)です。資格情報プロバイダーを作成するには、カスタム認可サーバーを指定し、AI エージェントとして認証し、オンビハーフグラントを JWT_AUTHORIZATION_GRANT に設定します。Okta は 2 つの交換を ID-JAG で指定されたクライアントにバインドするため、各 Okta エージェントには独自のプロバイダーが必要です。AgentCore Identity はシークレットをサービス管理の AWS Secrets Manager シークレットに保存し、update-oauth2-credential-provider でローテーションできます。チームが既にシークレットを管理している場合は、そのシークレット ARN を参照できます。共有シークレットを避けるには、プライベートキー JWT で認証します。AgentCore ランタイムは各エージェントランタイムのワークロード ID を作成および管理します。リクエストがランタイムの JWT 認可者を通過すると、ランタイムはワークロードアクセストークンを取得し、コードに渡します。AgentCore Identity はその背後にある ID-JAG を交換のアサーションとして使用します。AgentCore Python SDK はワークロードアクセストークンを BedrockAgentCoreContext に保持し、エントリポイントが受け取るリクエストヘッダーには含めません。