本文にスキップ
AI News HubLIVE
サイト内リライト5 分で読了

Okta Cross App AccessとAmazon Bedrock AgentCoreによるAIエージェントアクセスのガバナンス – パート2

記事の要約

本記事はシリーズのパート2で、パート1で構築した単一のAIエージェントに対するガバナンスの仕組みを企業規模に拡張する方法を説明します。主な変更点は、Amazon Bedrock AgentCore Gatewayが単一のフロントドアとしてOktaのグラントを引き換え、Cedarポリシーが各ツールをエージェントにバインドし、2番目のエージェントがAmazon EKS上で実行され、AgentCore ObservabilityがAmazon CloudWatchと統合してすべての許可と拒否の決定を追跡する点です。

ソースAWS Machine Learning Blog著者: Hammad Ausaf
Okta Cross App AccessとAmazon Bedrock AgentCoreによるAIエージェントアクセスのガバナンス – パート2
誤りを報告

訂正窓口はまだ利用できません。記事情報をコピーして保存できます。

訂正案内
本文へ

パート1では、Amazon Bedrock AgentCore上でタスクエージェントを構築しました。このエージェントは、サインインしたユーザーのためにOkta Cross App Access (XAA)を通じて動作します。Oktaはどのエージェントがどのユーザーのために動作できるかを決定し、AgentCore Identityがエージェント内でOktaのグラントを引き換えました。これによりガバナンスメカニズムが証明されましたが、トポロジーは意図的に小規模でした。1つのエージェント、2つのMCPサーバー、そして認可チェックが各サーバーにハードコードされていました。

このメカニズムは拡張できますが、トポロジーは拡張できません。1つのエージェントと2つのツールでは問題ない3つのことが、数百のエージェントと数千のツールを持つ企業では問題になります。パート1では、エージェントが各MCPサーバーのランタイムARNを保持して直接呼び出し、N個のエージェントとM個のサーバーが複雑な配線マトリックスを形成していました。エージェントのロールはトークン交換権限を保持し、プロバイダーのシークレットを読み取っていました。各MCPサーバーは独自のコードに同じグループチェックを持ち、ルールが数千のサーバーにコピーされ、ドリフトが発生し、一箇所で監査または変更できませんでした。

パート2ではこれを変更します。Amazon Bedrock AgentCore Gatewayが単一のフロントドアとなり、各ターゲットのOktaグラントを引き換えます。AgentCoreのポリシーはCedarポリシーを評価し、各ツールをエージェントとOktaが委任したスコープにバインドします。2番目のエージェントはAmazon Elastic Kubernetes Service (Amazon EKS)上で独自のOkta IDを持って参加し、フロントドアがエージェントの実行場所を問わないことを示します。AgentCore ObservabilityとAmazon CloudWatchは、Oktaの決定を含むすべての決定を一箇所で読み取る手段を提供します。

パート1のOkta設定、AgentCore Identityクレデンシャルプロバイダー、およびMCPサーバーはそのまま維持されます。ユーザーがサインインすると、バックエンド・フォー・フロントエンド (BFF) はIDトークンを、タスクエージェントAに発行されたIDアサーションJWT認可グラント (ID-JAG) と交換します。BFFはそのID-JAGを使用してAgentCoreランタイム上でエージェントAを呼び出します。エージェントAはID-JAGをMCPセッションのベアラートークンとしてGatewayに転送します。GatewayのインバウンドオーソライザーはエージェントAのID-JAGのみを受け入れます。AgentCoreのポリシーは、Gatewayがターゲットを呼び出す前に、各ツールリストと各ツール呼び出しに対してCedarポリシーを評価します。Cedarが許可した呼び出しに対して、GatewayはAgentCore Identityにパート1のクレデンシャルプロバイダーを介してOktaのカスタム認可サーバーで各ターゲットのID-JAGを引き換えさせます。Cedarが拒否した呼び出しはID-JAGを引き換えません。MCPサーバーはパート1と同様にユーザーのグループとスコープをチェックし、各決定をauthz.checkスパンとして記録します。すべてのホップがOpenTelemetryスパンをAgentCore Observabilityに発行し、CloudWatch Transaction Searchがそれらを収集し、OktaはAmazon EventBridgeを介してシステムログをCloudWatchにストリーミングします。レポーティングエージェントBはAmazon EKS上で実行され、独自のGatewayを介して同じパスをたどります。

パート1のソリューションに加えて、Amazon EKS上の2番目のエージェント用にeksctl、kubectl、Dockerが必要です。OktaシステムログをCloudWatchに取り込むためのOktaログストリーミング。AgentCore Gatewayとポリシーエンジン、Amazon EKSクラスター、CloudWatchロググループ、EventBridgeルール用のIAM権限も必要です。追加には約90分かかります。EKSコントロールプレーンは時間あたり0.10ドル、ノードとEKS Auto Mode管理費が加算され、AgentCore機能は使用量に応じて課金されます。

パート1と同様に、このソリューションはGitHubのAWSサンプル08-okta-xaa-delegation-chainに基づいており、その上にパート2の追加を構築できます。この記事のコードスニペットと設定は概念的なパターンを示すものであり、完全にデプロイ可能なソリューションではありません。コードは非本番用のサンプルコードであるため、デプロイ前にセキュリティチームと法務チームと協力して、組織のセキュリティ、規制、コンプライアンス要件を満たしてください。

ID-JAGを受け入れるGatewayを作成します。Gatewayのインバウンドオーソライザーはパート1のランタイムオーソライザーと同様に機能します。発行者はOktaの組織認可サーバー、オーディエンスはカスタム認可サーバーで、allowedClientsは1つのエージェントに固定します。各MCPサーバーはGatewayターゲットになり、そのアウトバウンド認可はパート1のクレデンシャルプロバイダーを介してTOKEN_EXCHANGEを使用するため、Gatewayが2回目の交換を実行します。ここで3つの詳細が重要です。ターゲットのスコープはID-JAGのスコープと等しくなければなりません。各ターゲットに静的ツールスキーマを提供し、Cedarポリシーが参照するツール名を固定します。Gatewayはターゲットごとにtools/listをページングするため、クライアントはページングカーソルに従う必要があります。AgentCore IdentityはGatewayの交換からのトークンを保持するため、1回限りのID-JAGがセッション内のすべてのツール呼び出しにサービスを提供します。クレデンシャルプロバイダーは1つのOktaエージェントとして認証するため、各エージェントに独自のGatewayとプロバイダーを提供します。

Cedarを使用してツールをエージェントにバインドします。AgentCoreのポリシーエンジンをENFORCEモードでGatewayにアタッチし、許可のみのポリシーを記述します。CedarはJWTクレームをタグとして公開します。存在しないタグを読み取るポリシーはエラーになりスキップされます。スキップされた許可は何も付与しないためデフォルト拒否が維持されますが、スキップされた禁止は何もブロックしません。各タグをhasTagで保護します。scopeタグはID-JAGのスペース区切りスコープクレームを保持するため、4つの条件はxaa:writeを完全なエントリとしてのみ一致させます。エンジンをアタッチする前に、すべてのポリシーがACTIVEであることを確認してください。Cedarはツールをエージェントとその委任されたスコープにバインドし、MCPサーバーは引き続きグループクレームから各ユーザーの権限を決定します。

エージェントをGatewayに向けます。エージェントAは、AgentCore Identityを自分で呼び出す代わりに、インバウンドID-JAGをGatewayに転送します。エージェントの実行ロールからパート1のAgentCore Identityステートメントを削除します。これがロールへの唯一の変更であり、ロールはトークン交換やシークレット権限を保持しなくなります。トークン交換の権限はGatewayのロールが保持するためです。ランタイムのオーソライザーでallowedClientsを維持します。

Amazon EKSで2番目のエージェントを実行します。2番目のエージェントであるレポーティングエージェントは、Amazon EKS上で同じコードを実行し、独自のOkta登録を持ちます。そのリソース接続はxaa:readのみを許可し、独自のGatewayとクレデンシャルプロバイダーを持ちます。EKS Pod Identityは、モデルを呼び出して独自のログとトレースを書き込むことができるIAMロールをポッドに付与し、それ以外は何も許可しません。AWS Distro for OpenTelemetry (ADOT) SDKがトレースをエクスポートします。AgentCoreランタイムの外部では、ポッドの前にオーソライザーがないため、エージェントはモデル呼び出しの前にID-JAGを検証します。署名、発行者、オーディエンス、トークンタイプoauth-id-jag+jwt、有効期限、およびclient_idが自分自身であることを確認します。MCPサーバーにパート1のエージェントチェックを残した場合は、エージェントBのクライアントIDをREGISTERED_AGENTSに追加します。2つの設定で問題が発生しました。EKS Auto Modeの汎用ノードプールはamd64のみを実行するため、マルチアーキテクチャイメージを構築してください。AgentCore Python SDKはDOCKER_CONTAINER=trueを設定しない限りlocalhostにバインドします。

AgentCore Observabilityで各決定を追跡します。このセクションのスパンはAgentCore Observabilityであり、図1のエージェントとCloudWatchの間に位置するコンポーネントです。ランタイム、Gateway、Identity、Policyは、Transaction Searchとトレース配信を有効にした後、コード変更なしで各ホップのOpenTelemetryスパンを発行します。独自のサービスはADOTを使用してスパンを追加します。CloudWatch Transaction Searchがそれらを収集し、AgentCoreコンソールがエージェントトレースとして読み取り、Amazon CloudWatch Omniが同じスパンをtraces.defaultとして読み取ります。これにより、1つのクエリでOktaのイベントと並べて表示できます。したがって、1回のツール呼び出しは次のスパン链を生成し、各スパンは決定を行った制御を名前で示します。AgentCore.Gateway.InboundAuth(Gateway、インバウンドID-JAGがこのエージェントに発行されたかどうかを記録)、AgentCore.Policy.AuthorizeAction(Policy、このツールのCedar決定を記録)、AgentCore.Identity.GetWorkloadAccessToken(Identity、エージェントのワークロードIDをユーザーにバインド)、AgentCore.Identity.GetResourceOauth2Token(Identity、OktaでID-JAGをスコープ付きアクセストークンと引き換え)、AgentCore.Gateway.InvokeTool(Gateway、ツール呼び出しとその結果を記録)、authz.check(MCPサーバー、ユーザーのグループ、エージェント、決定、理由を記録)。OktaのシステムログはAWSが発行できない唯一の記録であるため、これを取り込む必要があります。

要点と分析を開く

記事インテリジェンス

エンジニア初級

要点

  • AgentCore Gatewayは単一のフロントドアとして機能し、トークン交換を一元化して、エージェントとMCPサーバー間の配線マトリックスを回避します。
  • Gatewayで適用されるCedarポリシーはデフォルト拒否の認可を提供し、ツールをエージェントのclient_idと委任されたスコープにバインドします。
  • Amazon EKS上の2番目のエージェントは、アーキテクチャがエージェントの実行環境に依存しないことを示します。
  • AgentCore ObservabilityとCloudWatchは、OpenTelemetryスパンとOktaシステムログイベントを組み合わせた統合監査ビューを提供します。

要点と分析は自動生成され、誤りを含む場合があります。原典をご確認ください。