VPC Lattice を使用して VPC 内のプライベートリソースに接続する

Amazon Bedrock AgentCore は、プライベート MCP サーバー、内部 REST APIs、データベースなど、 AWS VPC または VPC に接続されたオンプレミス環境内でホストされているリソースへのプライベート接続をサポートします。これらのサービスはパブリックインターネットに公開されません。

プライベート接続は、Amazon VPC Lattice リソースゲートウェイとリソース設定を使用して確立されます。サポートされている 2 つのモード (マネージドおよびセルフマネージド Lattice) の詳細については、「サポートされている VPC 出力モード」を参照してください。

主要なコンセプト

サポートされている Amazon Bedrock AgentCore サービス

次の Amazon Bedrock AgentCore サービスは、VPC Lattice を使用した VPC 出力をサポートしています。

サポートされている VPC 出力モード

Amazon Bedrock AgentCore は、VPC Lattice 接続を設定するための 2 つのモードをサポートしています。

次の表は、主な違いをまとめたものです。

VPC Lattice の料金の詳細については、「Amazon VPC Lattice の料金」を参照してください。

オプション 1: マネージド VPC リソース

マネージド VPC リソースでは、VPC、サブネット、およびオプションのセキュリティグループ情報を提供します。AgentCore は、ユーザーに代わって VPC Lattice リソースゲートウェイとリソース設定の作成とライフサイクル管理を処理します。マネージドリソースゲートウェイは、VPC 内の ENIs を囲むラッパーです。変更、設定、操作はできません。AgentCore は、作成、再利用、削除を含むライフサイクル全体を所有します。

AgentCore は、AWSServiceRoleForBedrockAgentCoreGatewayNetworkサービスにリンクされたロールを使用して、アカウントで VPC Lattice リソースゲートウェイを作成および管理します。このロールは、マネージドプライベートエンドポイントを使用してゲートウェイターゲットを初めて作成するときに自動的に作成されます。このロールの詳細については、「ゲートウェイサービスにリンクされたロール」を参照してください。

前提条件

マネージドプライベートエンドポイントを使用してゲートウェイターゲットを作成する前に、以下を確認してください。

マネージドプライベートエンドポイントを使用してターゲットを作成する

マネージドプライベートエンドポイントを使用してリソースを作成するには、作成リクエストに privateEndpoint.managedVpcResourceブロックを含めます。

{
  ...
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0abc123def456",
      "subnetIds": ["subnet-0abc123", "subnet-0def456"],
      "endpointIpAddressType": "IPV4",
      "securityGroupIds": ["sg-0abc123def"]
    }
  },
  ...
}

managedVpcResource ブロックは、次のフィールドを受け入れます。

マネージドリソースを表示する

リソースを作成したら、関連する Get API ( など) GetGatewayTarget を呼び出して、AgentCore がユーザーに代わって作成したマネージド VPC Lattice リソースを表示します。これらはレスポンスの privateEndpointManagedResourcesフィールドで返されます。

{
  ...
  "status": "READY",
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0abc123def456",
      "subnetIds": ["subnet-0abc123", "subnet-0def456"],
      "endpointIpAddressType": "IPV4",
      "securityGroupIds": ["sg-0abc123def"]
    }
  },
  "privateEndpointManagedResources": [
    {
      "domain": "my-server.internal.example.com",
      "resourceGatewayArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-abc123"
    }
  ]
}

resourceGatewayArn は、AgentCore がアカウントで作成した VPC Lattice リソースゲートウェイの ARN です。AgentCore は、このリソースのライフサイクル全体を管理します。VPC とサブネットの設定が一致するターゲットに対して同じリソースゲートウェイを再利用し、ターゲットで使用されなくなったときに削除します。

オプション 2: セルフマネージド Lattice リソース

セルフマネージド Lattice では、VPC Lattice リソースゲートウェイとリソース設定を自分で作成および管理し、リソース設定識別子を AgentCore に提供します。このオプションは、VPC Lattice リソースが既に設定されている場合、複数のサービス間でリソース設定を共有する必要がある場合、または Lattice リソースのライフサイクルを制御する必要がある場合に使用します。

前提条件

セルフマネージドプライベートエンドポイントを使用してゲートウェイターゲットを作成する前に、次の手順を実行します。

セルフマネージド接続用の VPC Lattice リソースを設定する

AgentCore がユーザーに代わってリソース設定を AgentCore サービスネットワークに関連付けるには、IAM プリンシパルに次のアクセス許可も必要です。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "vpc-lattice:GetResourceConfiguration",
        "vpc-lattice:CreateServiceNetworkResourceAssociation",
        "vpc-lattice:GetServiceNetworkResourceAssociation",
        "vpc-lattice:ListServiceNetworkResourceAssociations",
        "vpc-lattice:AssociateViaAWSService"
      ],
      "Resource": "*"
    }
  ]
}

セルフマネージドプライベートエンドポイントを使用してターゲットを作成する

セルフマネージドプライベートエンドポイントを使用してリソースを作成するには、作成リクエストに privateEndpoint.selfManagedLatticeResourceブロックを含めます。

{
  ...
  "privateEndpoint": {
    "selfManagedLatticeResource": {
      "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-abc123"
    }
  },
  ...
}

は、VPC Lattice リソース設定の ARN または ID のいずれかresourceConfigurationIdentifierです。AgentCore は (フォワードアクセスセッションを介して) 認証情報を使用して、リソース設定を AgentCore サービスネットワークに関連付けます。

リソースが作成されると、Get API レスポンスには privateEndpointManagedResourcesフィールドresourceAssociationArnの が含まれます。同じリソース設定を指す複数のリソースを作成すると、AgentCore は既存のサービスネットワークリソースの関連付けを自動的に再利用します。

クロスアカウントプライベートリソース

AgentCore は、ゲートウェイを所有する AWS アカウントとは異なるアカウントのプライベートリソースに接続できます。これは、一元化されたゲートウェイを管理するプラットフォームチームにとって一般的なパターンであり、個々のサービスチームがプライベートリソースを所有しています。

リソース所有者アカウントは、RAM を使用して VPC Lattice AWS リソース設定をゲートウェイ所有者アカウントと共有する必要があります。次に、ゲートウェイ所有者アカウントは、ゲートウェイターゲットの作成時に共有リソース設定識別子を提供します。

次のステップは、クロスアカウント設定をまとめたものです。

クロスアカウントプライベート接続を設定する

中間ドメイン経由でトラフィックをルーティングする

routingDomain フィールドを使用して、VPC エンドポイント、内部 Application Load Balancer、Network Load Balancer などの中間コンポーネントを介してトラフィックをターゲットドメインに直接ルーティングできます。これは、1 つのエントリポイントの背後で複数のプライベートリソースを統合する場合に役立ちます (たとえば、1 つの VPC エンドポイントを介して複数のプライベート API Gateway をルーティングして、リソース設定の数と関連コストを削減するなど）。

ルーティングドメインを使用する場合、ターゲットに指定するドメイン (MCP エンドポイント URL または OpenAPI サーバー URL 内) は、リソースの実際の DNS 名である必要があります。routingDomain は、AgentCore が VPC Lattice リソース設定をセットアップするために使用する別のドメインです。呼び出し時に、AgentCore はルーティングドメインを介してトラフィックをルーティングしますが、実際のターゲットドメインを TLS SNI ホスト名としてリクエストを送信するため、リソースは実際のドメイン宛てのリクエストを受け取ります。

ルーティングドメインは、VPC 内のプライベートリソースにルーティングする任意のドメインにすることができます。一般的なオプションは次のとおりです。

次の手順では、ルーティングドメインを使用する場合のトラフィックフローについて説明します。

例: VPCE ルーティングドメインを持つプライベート API Gateway

次の例は、VPCE ドメインをルーティングドメインとして使用してプライベート API Gateway のゲートウェイターゲットを作成する方法を示しています。ターゲット URL はプライベート API Gateway ホスト名で、 routingDomainは VPCE DNS 名です。

{
  "name": "my-private-apigw-target",
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0123456789abcdef0",
      "subnetIds": ["subnet-0123456789abcdef0", "subnet-0abcdef1234567890"],
      "endpointIpAddressType": "IPV4",
      "routingDomain": "<vpce-id>.execute-api.us-east-1.vpce.amazonaws.com"
    }
  },
  "targetConfiguration": {
    "mcp": {
      "openApiSchema": {
        "inlinePayload": "<OpenAPI spec JSON with server URL matching the public certificate domain, for example https://<api-id>.execute-api.<region>.amazonaws.com>"
      }
    }
  }
}

プライベート証明書の回避策: ALB

VPC 出力では、ターゲットエンドポイントにパブリックに信頼された TLS 証明書が必要です。プライベートリソースがプライベート認証機関 (CA) によって発行された証明書を使用する場合、推奨される回避策は、リソースの前に内部 Application Load Balancer (ALB) を配置することです。

次の手順では、トラフィックフローについて説明します。

ステップ 1: パブリック ACM 証明書をリクエストする

所有するドメインのパブリック証明書を ACM にリクエストします。このドメインはターゲット URL として使用されます。手順については、 AWS 「 Certificate Manager ユーザーガイド」の「パブリック証明書のリクエスト」を参照してください。

ステップ 2: 内部 ALB を作成する

プライベートリソースと同じ VPC に内部 Application Load Balancer を作成します。手順については、Elastic Application Load Balancer の作成」を参照してください。 Elastic Load Balancing スキームを に設定してくださいinternal。

ステップ 3: IP ベースのターゲットグループを作成する

ポート 443 (HTTPS) でプライベートリソースの IP アドレスipを指すターゲットタイプを使用してターゲットグループを作成し、プライベートリソースをターゲットとして登録します。手順については、Elastic Load Balancing ユーザーガイド」の「ターゲットグループの作成」を参照してください。

ステップ 4: ホストヘッダー変換を使用して HTTPS リスナーを作成する

パブリック ACM 証明書を使用して、ポート 443 に HTTPS リスナーを作成します。転送前にホストヘッダーをパブリックドメインからプライベートリソースのドメインに変換するリスナールールを追加します。

aws elbv2 create-listener \
  --load-balancer-arn <alb-arn> \
  --protocol HTTPS \
  --port 443 \
  --certificates CertificateArn=<acm-certificate-arn> \
  --default-actions '[{
    "Type": "forward",
    "TargetGroupArn": "<target-group-arn>",
    "ForwardConfig": {
      "TargetGroups": [{"TargetGroupArn": "<target-group-arn>", "Weight": 1}]
    }
  }]'

次に、リスナールールを変更してホストヘッダー変換を追加します。

aws elbv2 modify-rule \
  --rule-arn <default-rule-arn> \
  --actions '[{
    "Type": "forward",
    "TargetGroupArn": "<target-group-arn>",
    "ForwardConfig": {
      "TargetGroups": [{"TargetGroupArn": "<target-group-arn>", "Weight": 1}]
    }
  }]' \
  --transforms '[{
    "Type": "host-header",
    "HostHeaderConfig": {
      "Values": ["my-server.my-company.internal"]
    }
  }]'

ステップ 5: プライベートエンドポイントを設定する

ALB DNS 名を として使用routingDomainし、パブリック証明書ドメインをターゲット URL として使用します。

{
  ...
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "<vpc-id>",
      "subnetIds": ["<subnet-id-1>", "<subnet-id-2>"],
      "endpointIpAddressType": "IPV4",
      "routingDomain": "internal-my-alb-1234567890.us-west-2.elb.amazonaws.com"
    }
  },
  ...
}

ターゲット設定のターゲット URL は、プライベートドメインではなく https://my-server.my-company.com (パブリック証明書ドメイン) を使用する必要があります。

VPC 出力のサービスにリンクされたロール

マネージドプライベートエンドポイント ( managedVpcResource ) を使用してゲートウェイターゲットを作成すると、AgentCore はAWSServiceRoleForBedrockAgentCoreGatewayNetworkサービスにリンクされたロールを使用して、アカウントで VPC Lattice リソースゲートウェイを作成および管理します。このロールは、IAM プリンシパルが必要なiam:CreateServiceLinkedRoleアクセス許可を持っている場合、マネージドプライベートエンドポイントターゲットを初めて作成するときに自動的に作成されます。

サービスにリンクされたロールには、次の主要な特性があります。

完全なポリシードキュメントと、このロールを作成、編集、削除する手順については、「ゲートウェイサービスにリンクされたロール」を参照してください。

ターゲットのステータスとトラブルシューティング

プライベートエンドポイントを使用してリソースを作成すると、AgentCore が VPC Lattice リソースをセットアップしてサービスネットワークの関連付けを確立している間、リソースは CREATING状態になります。関連する Get API ( など) を呼び出し、 statusおよび GetGatewayTarget statusReasonsフィールドを確認することで、ステータスをモニタリングできます。

次の表に、一般的なステータス値とその意味を示します。

次の表に、一般的な問題とその解決策を示します。

制約事項と考慮事項

AgentCore に VPC 出力を使用する場合は、次の制限に注意してください。