Connect Amazon Bedrock AgentCore Gateway to private APIs in a hub-and-spoke network with centralized inspection
Quick Summary
AWS는 네트워크 계정이 모든 서브넷을 소유하면서 Amazon Bedrock AgentCore Gateway의 비공개 API·MCP 서버 호출 중 리소스 게이트웨이와 도구 VPC 사이의 요청과 응답을 모두 중앙 방화벽으로 보내는 허브 앤드 스포크 구성을 제시했다.
🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약
AWS는 네트워크 계정이 모든 서브넷을 소유하면서 Amazon Bedrock AgentCore Gateway의 비공개 API·MCP 서버 호출 중 리소스 게이트웨이와 도구 VPC 사이의 요청과 응답을 모두 중앙 방화벽으로 보내는 허브 앤드 스포크 구성을 제시했다.
📌 핵심 요약
- 저자들은 미국 동부(버지니아 북부) 리전인 us-east-1에서 AWS Organizations 관리 계정 1개와 멤버 계정 3개로 구성을 구축하고 시험했다.
- 네트워크 계정은 자체 관리형 모드의 Amazon VPC Lattice 리소스 게이트웨이를 전용 VPC의 비공유 서브넷에 둔다. 리소스 게이트웨이와 도구 VPC 사이에서는 AWS Transit Gateway가 요청과 응답을 모두 검사 VPC로 보낸다.
- AgentCore 계정은 AWS RAM으로 공유받은 리소스 구성을 사용한다. 저자들의 시험에서는 다른 계정의 두 번째 비공개 REST API도 네트워크 변경 없이 같은 execute-api 인터페이스 엔드포인트와 리소스 구성을 이용했다.
- 중앙 방화벽은 TLS로 보호된 Gateway와 내부 Application Load Balancer(ALB) 사이의 흐름 메타데이터와 서버 이름 표시(SNI)를 볼 수 있다. 요청 본문은 검사할 수 없으며, 에이전트에서 인터페이스 엔드포인트까지의 구간, Gateway에서 리소스 게이트웨이까지의 구간, 자격 증명 공급자에 대한 토큰 요청도 방화벽을 거치지 않는다.
- OAuth 클라이언트 자격 증명 방식을 쓰면 도구에는 Gateway의 클라이언트 신원만 전달된다. 개별 호출자를 추적하는 근거는 Gateway 애플리케이션 로그에 기록된 인바운드 JWT 클레임이다.
🧩 주요 포인트
- 리소스 게이트웨이의 소유권과 배치 위치가 양방향 검사 경로를 결정한다. 애플리케이션 팀은 공유 서브넷에서 자체 리소스와 보안 그룹을 계속 관리할 수 있다.
- 리소스 구성의 목적지와 인증서 검증 기준은 다를 수 있다. 내부 ALB로 연결하더라도 인증서의 주체 대체 이름(SAN)은 Gateway 대상 URL의 호스트 이름과 일치해야 한다.
- 연결된 ALB에 새 API를 추가하면 도구 팀은 리스너 규칙을, AgentCore 팀은 Gateway 대상을 맡는다. 기존 Gateway 대상에 작업이나 도구만 추가할 때는 대상 정의를 갱신할 수 있다.
🧠 상세 정리
1. 서브넷 소유권과 양방향 검사라는 두 조건
이 글이 다루는 기업 환경에서는 중앙 네트워크 팀이 모든 VPC와 서브넷, AWS Transit Gateway 연결을 소유하고, 한 VPC에서 다른 VPC로 오가는 트래픽은 양방향 모두 중앙 방화벽의 검사를 받아야 한다. 애플리케이션 팀은 AWS RAM으로 공유받은 서브넷에서 자체 리소스와 보안 그룹을 관리한다. 에이전트가 Amazon Bedrock AgentCore Gateway를 통해 내부 REST API나 Model Context Protocol(MCP) 서버를 호출할 때도 같은 조건이 적용된다. 저자들은 us-east-1에서 관리 계정 1개와 멤버 계정 3개로 이를 시험했으며, 동반 저장소에 CloudFormation 템플릿과 시험 자료를 제공한다고 설명한다. 이 구성은 각 조직의 계정 구조에 맞춰 조정할 참조 사례로 제시됐다.
2. 연결 모드를 고르는 기준
Gateway가 비공개 대상에 연결할 때 사용하는 VPC Lattice 리소스 게이트웨이는 지정한 서브넷에 네트워크 인터페이스를 두며, 백엔드에는 이 인터페이스의 주소가 연결 출발지로 보인다. 관리형 모드에서는 AgentCore가 리소스 게이트웨이를 생성하므로 Gateway 계정이 도구에 접근할 수 있는 서브넷을 소유하는 환경에 적합하다. 문서에 제시된 일반적인 자체 관리형 구성은 백엔드에 직접 접근할 수 있는 서브넷에 리소스 게이트웨이를 두므로 도구와의 통신에 중앙 검사가 필요하지 않을 때 적합하다. 공개 엔드포인트로 접근할 수 있는 도구에는 표준 Gateway 대상을 사용할 수 있다. 저자들은 중앙 소유권과 양방향 검사가 모두 필요한 환경에 맞춰 자체 관리형 모드를 택하고 리소스 게이트웨이의 소유 계정과 배치 위치를 바꿨다.
3. 에이전트의 요청과 도구의 응답이 지나는 경로
인터넷 경로가 없는 공유 서브넷에서 에이전트가 Gateway URL을 호출하면 인터페이스 엔드포인트의 비공개 DNS가 에이전트 VPC 안에서 이름을 해석한다. AWS WAF가 연결돼 있으면 먼저 요청을 평가하고, Gateway는 리소스 정책과 인바운드 JWT를 확인한 뒤 호출할 도구를 선택하고 아웃바운드 OAuth 토큰을 받는다. AgentCore는 대상 생성 시 공유받은 리소스 구성을 자체 VPC Lattice 서비스 네트워크에 연결하므로, AgentCore 계정에 별도 Transit Gateway 연결이 없어도 요청이 네트워크 계정의 리소스 게이트웨이에 도달한다. 그 지점부터는 네트워크 팀이 관리하는 경로를 따라 요청이 검사 VPC를 거쳐 내부 ALB 또는 execute-api 엔드포인트로 전달된다. ALB나 Amazon API Gateway가 토큰을 검증해 요청을 백엔드로 보내고, 응답은 같은 검사 경로를 거슬러 돌아온다.
4. 방화벽의 가시성과 호출자 추적의 한계
양방향 검사가 적용되는 범위는 리소스 게이트웨이와 도구 VPC 사이이며, 에이전트의 최초 호출부터 인증과 응답까지 모든 통신이 방화벽을 거치는 것은 아니다. 에이전트와 인터페이스 엔드포인트 사이의 통신, Gateway와 리소스 게이트웨이 사이의 통신, AgentCore가 각 자격 증명 공급자에 보내는 토큰 요청은 검사 경로 밖에 있다. Gateway에서 ALB까지는 Gateway가 인증서를 검증하는 TLS 연결이 유지되므로 방화벽에서 볼 수 있는 정보는 흐름 메타데이터와 SNI이며, 요청 내용은 Gateway·AWS WAF·ALB 로그에서 확인한다. 호출자 식별에도 별도의 근거가 필요하다. 클라이언트 자격 증명 방식에서는 여러 사용자의 요청이 도구에 같은 Gateway 클라이언트 신원으로 도착하므로, 특정 요청을 보낸 사용자를 추적할 때는 Gateway 애플리케이션 로그의 인바운드 JWT 클레임을 사용한다.
5. 새 API와 기존 도구를 추가할 때의 역할 분담
네트워크 팀은 리소스 게이트웨이와 전용 VPC, 서브넷, 라우팅, 방화벽 규칙, Gateway 인터페이스 엔드포인트와 정책, AWS RAM 공유를 맡는다. 이미 연결된 ALB에 새 API를 추가할 때는 네트워크 팀의 변경 없이 도구 팀이 JWT를 검증하는 리스너 규칙을 추가하고 AgentCore 팀이 해당 API의 Gateway 대상을 만든다. 새 ALB나 도구 계정을 연결할 때는 네트워크 팀이 리소스 구성을 공유에 추가하고, 새 주소 범위를 사용할 경우 방화벽 규칙도 추가한다. 도구 팀은 내부 ALB와 보안 그룹, Gateway용 앱 클라이언트를 맡고, AgentCore 팀은 새 자격 증명 공급자가 필요한 경우 OAuth 자격 증명 공급자도 구성한다. 기존 대상에 작업이나 도구만 추가할 때는 OpenAPI 명세를 갱신하거나 MCP 서버의 도구 목록을 동기화하면 되므로 새 Gateway 대상을 만들 필요가 없다.
6. 계정 간 공유와 방화벽 연결의 전제 조건
이 구성은 AWS Organizations에서 AWS RAM 리소스 공유를 활성화해 네트워크 계정이 소유한 리소스를 다른 계정에서 이용할 수 있다는 전제에 기반한다. 인증서 설정 매개변수인 certificateConfigurations를 사용하려면 AWS CLI 2.37.7 이상 또는 Python용 AWS SDK인 Boto3 1.43.106 이상이 필요하다. Gateway 대상을 생성하는 역할에는 Bedrock AgentCore 대상 작업 권한과 VPC Lattice 리소스 구성을 조회하고 서비스 네트워크 연결을 생성·조회하는 데 필요한 권한이 있어야 한다. 저자들은 VPC Lattice를 사용하지 않던 조직이라면 서비스 제어 정책(SCP)이 해당 작업을 허용하는지도 확인하도록 안내한다. 네트워크 측 전제는 중앙 검사 VPC에 방화벽이 있고 해당 VPC의 Transit Gateway 연결에서 어플라이언스 모드가 활성화돼 있다는 것이다.
7. 첫 번째 설계 결정은 전용 VPC 배치
네트워크 계정은 리소스 게이트웨이 전용 VPC를 마련하고 그 서브넷을 다른 계정과 공유하지 않으며, 같은 공간에 중앙 엔드포인트나 백엔드를 두지 않는다. 신뢰 영역마다 리소스 게이트웨이를 하나씩 두고 해당 서브넷의 내부 목적지 트래픽을 Transit Gateway로 보내면 도구 VPC와 오가는 트래픽에 중앙 검사 경로를 적용할 수 있다. 글에 따르면 리소스 게이트웨이를 AgentCore에만 사용할 때는 서브넷마다 IP 주소 하나를 소비하므로 작은 서브넷으로도 충분하다. 다만 Ipv4AddressesPerEni와 ResourceConfigDnsResolution은 생성 후 변경할 수 없어 최초 배치 때 값을 정해야 한다. 가용 영역도 VPC Lattice와 사용하려는 AgentCore 기능이 함께 지원하는 가용 영역 ID를 기준으로 선택한다.
8. 두 번째 설계 결정은 목적지 공유와 인증서 검증
내부 ALB를 사용하는 경우 네트워크 팀은 로드 밸런서별로 해당 ALB의 DNS 이름을 가리키는 리소스 구성을 만들고 AWS RAM으로 AgentCore 계정에 공유한다. VPC Lattice는 리소스 구성에 지정한 도메인으로 연결하지만, Gateway는 대상 URL의 호스트 이름을 SNI로 보내고 그 이름을 기준으로 ALB 인증서를 검증한다. 따라서 인증서의 주체 대체 이름은 대상 URL의 호스트 이름과 일치해야 하며, 그 호스트 이름 자체가 DNS에서 해석될 필요는 없다. 비공개 API Gateway REST API의 경우 여러 API가 네트워크 계정의 execute-api 인터페이스 엔드포인트를 가리키는 리소스 구성 하나를 사용할 수 있고, 각 API는 자체 대상 URL을 사용하며 자체 리소스 정책에서 해당 엔드포인트를 허용해야 한다. 저자들은 다른 계정의 두 번째 API도 네트워크 변경 없이 연결됐다고 보고했다. 글은 여섯 가지 설계 결정을 예고하지만 제공된 본문은 세 번째 결정의 제목 도중에 끝난다.
🧾 핵심 주장 / 시사점
- 중앙 검사의 범위는 리소스 게이트웨이의 네트워크 인터페이스를 기준으로 이해할 수 있다. 그 인터페이스까지는 AWS가 연결을 제공하고, 이후 도구 VPC까지의 왕복 경로는 네트워크 팀의 라우팅과 방화벽이 결정한다.
- 통신 경로와 사용자 신원을 확인하려면 서로 다른 기록이 필요하다. 방화벽의 흐름 메타데이터는 연결을 보여주고, Gateway 로그의 인바운드 JWT 클레임은 도구에 전달되지 않은 호출자 정보를 제공한다.
- 여러 비공개 REST API가 같은 리소스 구성을 재사용해도 API별 URL과 리소스 정책은 각각 관리된다. 시험에서 네트워크 변경이 필요 없었던 이유와 각 API 팀에 남는 책임을 함께 설명하는 지점이다.
✅ 액션 아이템
- 서브넷 소유권과 양방향 검사 요건을 기준으로 자체 관리형 모드와 리소스 게이트웨이 전용 VPC의 적합성을 판단한다.
- 내부 ALB 인증서의 주체 대체 이름(SAN)이 Gateway 대상 URL의 호스트 이름과 일치하는지 확인한다.
- 개별 호출자를 추적할 때 Gateway 애플리케이션 로그의 인바운드 JWT 클레임을 사용한다.
❓ 열린 질문
- 에이전트에서 인터페이스 엔드포인트까지의 구간과 토큰 요청이 중앙 방화벽을 거치지 않아도 조직의 검사 요건을 충족하는가?
- 중앙 방화벽에서 확인할 수 있는 흐름 메타데이터와 서버 이름 표시(SNI)만으로 필요한 검사 범위를 충족하는가?
- 도구에 Gateway의 클라이언트 신원만 전달되는 환경에서 인바운드 JWT 클레임만으로 필요한 수준까지 개별 호출자를 추적할 수 있는가?