多くの企業では、中央のネットワークチームがすべての仮想プライベートクラウド(VPC)とサブネットを所有し、VPC 間のすべてのフローが双方向で中央ファイアウォールを通過する必要があります。エージェントが Amazon Bedrock AgentCore Gateway を介して内部 REST API や Model Context Protocol(MCP)サーバーを呼び出す場合も、同じ 2 つの要件を満たす必要があります。Amazon Bedrock AgentCore は、任意のフレームワークやモデルを使用して、大規模にエージェントを構築、接続、最適化するためのプラットフォームです。
この投稿では、両方の要件を満たすパターンを紹介します。ネットワークチームはすべてのサブネットの所有権を保持し、Gateway とプライベート API および MCP サーバー間のトラフィックは双方向で中央ファイアウォールを通過します。Gateway がプライベートターゲットに到達するために使用する Amazon VPC Lattice リソースゲートウェイをどこに配置するか、各コンポーネントの所有者、6 つの設定上の決定事項、およびパターンが機能することを確認するチェックについて説明します。
このパターンは、AWS Organizations の 3 つのメンバーアカウントと 1 つの管理アカウントを含むラボで、米国東部(バージニア北部)AWS リージョン(us-east-1)で構築およびテストしました。AWS CloudFormation テンプレート、テストスクリプト、テストエビデンス、および参考資料(アドレス計画、完全な検証チェック、トラブルシューティング、クォータ)はコンパニオンリポジトリにあります。このパターンはガイドラインとして使用し、独自のアカウントアーキテクチャに合わせて調整してください。
用語の説明
リソースゲートウェイ:Amazon VPC Lattice が VPC に進入するためのエントリポイントで、選択したサブネットに弹性ネットワークインターフェイス(ENI)を作成します。バックエンドはそのアドレスを各接続の送信元として認識します。
リソース設定:VPC Lattice オブジェクトで、リソースゲートウェイの背後にある 1 つのバックエンド(ここでは内部ロードバランサーまたは VPC エンドポイントの DNS 名とポート)を指定します。AWS Resource Access Manager(AWS RAM)を介して他のアカウントと共有できます。
マネージドモードとセルフマネージドモード:Gateway ターゲットの 2 つのプライベートエンドポイントオプション。マネージドモードでは、AgentCore がリソースゲートウェイを作成します。セルフマネージドモードでは、ユーザーがリソースゲートウェイを作成し、ターゲットにリソース設定を提供します。
このパターンを使用する場合
以下のすべてが当てはまる場合にこのパターンを使用します。
ネットワークアカウントがすべての VPC、サブネット、AWS Transit Gateway アタッチメントを所有し、AWS RAM を介してアプリケーションサブネットを共有している。
検査 VPC の中央ファイアウォールが、各 VPC に出入りするトラフィックを検査する必要がある。
アプリケーションチームは自分のリソースとセキュリティグループのみを管理する。
それ以外の場合は、表 1 のオプションのいずれかがより適しています。
表 1:別のオプションが適している場合
環境 | 使用
Gateway アカウントがツールに到達するサブネットを所有できる | マネージドモード
Gateway とツール間のトラフィックに中央検査が不要 | セルフマネージドモード(ドキュメントどおり)
ツールがパブリックエンドポイントで到達可能 | 標準 Gateway ターゲット
また、AgentCore が所有するサブネットでのマネージドモード、各ツール VPC または中央エンドポイント VPC のリソースゲートウェイ、各ツールの AWS WAF を備えたインターネット向けロードバランサーも検討しました。代替案の説明では、これらの制約下で各案が不十分である理由を説明しています。
集中検査の設計要件
ネットワークアカウントがすべてのサブネットを所有します。Gateway アカウントとアプリケーションアカウントは、AWS RAM を介して共有されたサブネット内でのみ構築します。
VPC 間のすべてのフローは双方向で中央ファイアウォールを通過します。検査 VPC の中央ファイアウォールが、Gateway とプライベート API および MCP サーバー間のトラフィックを検査します。
AgentCore Gateway は VPC Lattice リソースゲートウェイを介してプライベートターゲットに到達し、2 つのプライベートエンドポイントモードではその配置場所が異なります。マネージドモードでは Gateway アカウントにリソースゲートウェイを作成します。これは、そのアカウントが実行するサブネットを所有できる環境に適しています。セルフマネージドモード(ドキュメントどおり)では、バックエンドに直接アクセスできるサブネットにリソースゲートウェイを配置します。これは、Gateway とツール間の検査が不要な環境に適しています。この環境では両方の条件が同時に必要であるため、このパターンではセルフマネージドモードを使用し、1 つの変更を加えます。ネットワークアカウントがリソースゲートウェイを所有し、AWS Transit Gateway 経由でルーティングされるサブネットに配置するため、すべてのリクエストとレスポンスが検査 VPC を通過します。
ソリューションの概要
ネットワークアカウント内のリソースゲートウェイに専用の VPC とサブネットを提供します。これらを共有せず、バックエンドをこれらのサブネットに配置しないでください。トランジットゲートウェイ経由でルーティングして、VPC 間のすべてのリクエストとレスポンスがファイアウォールを通過するようにします。AWS RAM を介して、バックエンドごとに 1 つのリソース設定を AgentCore アカウントと共有します。図 1 にアカウント、VPC、トラフィックパスを示します。
トラフィックパス
エージェントはインターネットルートのない共有サブネット内にあり、Gateway URL を呼び出します。Gateway インターフェイスエンドポイントのプライベート DNS がエージェントの VPC 内で解決します。
AWS WAF がアタッチされている場合はリクエストを評価します。Gateway はリソースポリシーと受信 JSON Web Token(JWT)を確認し、ターゲットとツールを選択します。
Gateway はツールアカウントの送信 OAuth トークンを取得し、VPC Lattice を介してネットワークアカウントのリソースゲートウェイにリクエストを送信します。
リソースゲートウェイのサブネットはトランジットゲートウェイにルーティングされ、トランジットゲートウェイは検査 VPC を経由してツールアカウントの内部 Application Load Balancer(ALB)または execute-api エンドポイントにトラフィックを送信します。(ファイアウォールを通過。)
ALB または Amazon API Gateway はトークンを検証し、リクエストをバックエンドに転送します。
レスポンスは同じ経路で戻ります。(ファイアウォールを通過。)
AgentCore アカウントにトランジットゲートウェイアタッチメントがない場合、Gateway トラフィックはどのようにネットワークアカウントの VPC に進入するのでしょうか。ターゲットを作成すると、AgentCore は共有リソース設定を独自の VPC Lattice サービスネットワークに関連付けます。次に VPC Lattice は、そのサービスネットワークから VPC 内のリソースゲートウェイのネットワークインターフェイスに接続を配信します。このホップは AWS が運用し、そこから先はユーザーのルートとファイアウォールが引き継ぎます。
このパターンが行わないこと。採用前にこれらの制限が要件に適合するか確認してください。
ペイロード検査なし:Gateway から ALB までのトラフィックはエンドツーエンドの TLS で、Gateway が証明書を検証します。ファイアウォールはフローメタデータと TLS Server Name Indication(SNI)を確認できますが、ペイロードは確認できません。リクエスト内容は Gateway、AWS WAF、ALB のログにあります。
一部の区間はファイアウォールをスキップ:エージェントからインターフェイスエンドポイントへの区間と、Gateway からリソースゲートウェイへの区間はファイアウォールを通過しません。各 ID プロバイダーへの AgentCore のトークンリクエストも同様です。
ツール側でエンドユーザー ID なし:クライアントクレデンシャルグラントでは、ツールに到達するすべての呼び出しが Gateway のクライアント ID を持ちます。呼び出しを呼び出し元まで追跡するには、Gateway アプリケーションログの受信 JWT クレームを使用します。
誰が何を所有するか
表 2:誰が何を作成するか
一度限り | 接続された ALB 上の新しい API | 新しい ALB またはツールアカウント
ネットワークチーム | リソースゲートウェイとその VPC、サブネット、ルート。ファイアウォールルール。ALB の署名キー取得のためのツール VPC からトランジットゲートウェイへのデフォルトルート。Gateway インターフェイスエンドポイントとポリシー。AWS RAM 共有 | なし | 共有に追加された 1 つのリソース設定。範囲が新しい場合はファイアウォールルール
ツールチーム | AgentCore チームが使用するターゲットホスト名に一致するサブジェクト代替名を持つ ALB 証明書 | 自身の ALB のリスナールール(jwt-validation 付き) | 内部 ALB とセキュリティグループ、および Gateway 用のアプリクライアント(クライアントクレデンシャルグラント、tools/invoke などのスコープ付き)
AgentCore チーム | Gateway、受信認可者、リソースポリシー、オプションの AWS WAF | API または MCP サーバーごとに 1 つの Gateway ターゲット | ターゲットと、新しい ID プロバイダー用の OAuth クレデンシャルプロバイダー
既存のターゲット上の新しい操作やツールには新しいターゲットは不要です。UpdateGatewayTarget で OpenAPI 仕様を更新するか、MCP サーバーの場合は SynchronizeGatewayTargets を呼び出します。リポジトリの構築順序には、各アカウントの手順とチーム間で受け渡す値が記載されています。
前提条件
AWS Organizations の組織で、AWS RAM のリソース共有が有効になっていること。
certificateConfigurations パラメータには、AWS Command Line Interface(AWS CLI)2.37.7 以降、または AWS SDK for Python(Boto3)1.43.106 以降。
Gateway ターゲットを作成するロールには、vpc-lattice:GetResourceConfiguration、vpc-lattice:CreateServiceNetworkResourceAssociation、vpc-lattice:GetServiceNetworkResourceAssociation、vpc-lattice:ListServiceNetworkResourceAssociations、vpc-lattice:AssociateViaAWSService、および bedrock-agentcore のターゲットアクション。組織が現在 VPC Lattice を使用していない場合は、サービスコントロールポリシー(SCP)を確認してください。
中央検査 VPC 内にあり、アプライアンスモードが有効なトランジットゲートウェイに接続されたファイアウォール。
主要な設計上の決定事項
スニペットはラボテンプレートからの抜粋で、ラボのアドレス計画を使用しています。RGW_NET はリソースゲートウェイサブネット(10.0.1.0/24–10.0.3.0/24)、TOOL_NET はツール VPC(10.12.0.0/16)、ALB_NET はその中の ALB サブネットです。
決定 1:リソースゲートウェイをネットワークアカウントの専用 VPC に配置する
ネットワークアカウント内にリソースゲートウェイ専用の VPC を作成し、共有しないサブネットを使用し、中央エンドポイントやバックエンドを配置しないでください。これらのサブネットをトランジットゲートウェイにルーティングします。信頼ゾーンごとに 1 つのリソースゲートウェイを維持します。
ResourceGateway: Type: AWS::VpcLattice::ResourceGateway Properties: Name: hub-resource-gateway VpcIdentifier: !Ref ResourceGatewayVpc SubnetIds: [!Ref RgwSubnetA, !Ref RgwSubnetB, !Ref RgwSubnetC] SecurityGroupIds: [!Ref RgwSg] # egress 443 to application ranges only IpAddressType: IPV4
RgwRouteToTgw: Type: AWS::EC2::Route Properties: RouteTableId: !Ref RgwRouteTable DestinationCidrBlock: 10.0.0.0/8 # internal ranges go to the transit gateway TransitGatewayId: !Ref Tgw
AgentCore でのみ使用する場合、リソースゲートウェイはサブネットごとに 1 つの IP アドレスを消費するため、小さなサブネットで十分です。作成後に変更できない設定が 2 つあります。Ipv4AddressesPerEni と ResourceConfigDnsResolution です。事前に選択してください。VPC Lattice と AgentCore 機能がサポートするアベイラビリティゾーン ID を使用します。ラボのレイアウトには us-east-1 の AZ ID が記載されています。
決定 2:ロードバランサーごとに 1 つのリソース設定を作成し、AWS RAM を介して共有する
リソース設定を内部 ALB の DNS 名に向け、AgentCore アカウントと共有します。VPC Lattice が予約しているため、名前を rcfg- で始めないでください。
ToolsResourceConfig: Type: AWS::VpcLattice::ResourceConfiguration Properties: Name: tools-account-a ResourceConfigurationType: SINGLE ResourceGatewayId: !Ref ResourceGateway ProtocolType: TCP PortRanges: ["443"] ResourceConfigurationDefinition: DnsResource: DomainName: internal-tools-alb-1234567890.us-east-1.elb.amazonaws.com IpAddressType: IPV4
ShareToAgentCore: Type: AWS::RAM::ResourceShare Properties: Name: agentcore-resource-configs AllowExternalPrincipals: false Principals: [""] ResourceArns: [!GetAtt ToolsResourceConfig.Arn]
VPC Lattice は、リソース設定のドメインに接続を配信します。AgentCore はターゲット URL のホスト名(例:tools.example.internal)を SNI として送信し、そのホスト名に対して ALB 証明書を検証します。証明書のサブジェクト代替名はそのホスト名と一致する必要があります。ホスト名は DNS で解決する必要はありません。
プライベート API Gateway REST API の場合は、1 つのリソース設定をネットワークアカウントの execute-api インターフェイスエンドポイントに向けます。各 API のターゲットは独自の URL を使用し、各 API のリソースポリシーは aws:SourceVpce を介してそのエンドポイントを許可する必要があります。テストでは、別のアカウントの 2 番目の API が、ネットワークを変更せずに同じリソース設定を介して機能しました。
決定 3:必要なフローのみをファイアウォールに通す
ファイアウォールには 2 つのステートフル許可が必要です。リソースゲートウェイサブネットからツール VPC へのポート 443、および ALB サブネットから ID プロバイダーのホスト名へのポート 443 です。セッションベースのファイアウォール……