Protect agent tool calls with Skyflow and Amazon Bedrock AgentCore Gateway
Quick Summary
이 글은 Skyflow Detect를 Amazon Bedrock AgentCore Gateway의 요청·응답 인터셉터로 연결해 도구·모델·문서에 전달되는 민감정보를 정책에 따라 비식별화하고 필요한 경우 복원하는 구성을 소개한다.
🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약
이 글은 Skyflow Detect를 Amazon Bedrock AgentCore Gateway의 요청·응답 인터셉터로 연결해 도구·모델·문서에 전달되는 민감정보를 정책에 따라 비식별화하고 필요한 경우 복원하는 구성을 소개한다.
📌 핵심 요약
- 글은 에이전트의 도구 인자, 도구 응답, 문서의 서명된 URL을 민감정보 노출 경로로 지목하고, AgentCore Gateway에 공통 보호 기능을 배치하는 방식을 제시한다.
- Shield the tool은 도구로 보내는 민감정보를 가역적인 vault 토큰으로 바꾸고 응답에서 복원하며, Shield the model은 모델 입력을 비식별화한 뒤 해당 호출에서 생성한 토큰만 응답에서 복원한다.
- Shield the document는 원본 문서 URL을 비식별 사본의 URL로 교체한다. Skyflow Detect v2는 프리뷰 상태이며, 파일을 직접 가져와 승인된 리전에 사본을 저장하므로 파일 본문이 Lambda를 통과하지 않는다.
- 인터셉터는 단일 AWS Lambda 함수로 구성되며, 정책은 AWS Systems Manager Parameter Store, API 키는 AWS Secrets Manager, 판단 로그와 지표는 Amazon CloudWatch에서 관리한다. 비식별화에 실패하거나 검사할 수 없는 트래픽은 차단한다.
- 글은 대형 유럽 은행의 카드 분쟁 조사라는 예시로 보호 전후를 설명하고, Skyflow가 AgentCore Policy와 Amazon Bedrock Guardrails를 보완한다고 제시한다. 도구·에이전트 코드는 유지하지만 모델 보호에는 모델 클라이언트의 추론 엔드포인트 변경이 필요하며, Skyflow는 AWS Marketplace에서, 인터셉터는 GitHub 오픈소스로 제공된다고 안내한다.
🧩 주요 포인트
- AgentCore Gateway에 보호를 집중하면 게이트웨이 뒤의 에이전트와 도구에 공통 정책을 적용할 수 있어, 개별 에이전트마다 보호 기능을 추가해야 하는 부담을 줄이는 구조가 된다.
- Shield the tool·Shield the model·Shield the document는 실제 데이터를 보지 못하게 할 대상을 각각 구분하므로, 업무에 필요한 정보 이용과 민감정보 노출 제한을 서로 다른 경계에서 조정한다.
- 가역 토큰, 호출별 복원 범위, 승인된 리전, 실패 시 차단은 데이터 이용 범위와 처리 위치를 통제하는 장치이며, Policy의 권한 통제 및 Guardrails의 콘텐츠 보호와 결합하는 구성이 제안된다.
🧠 상세 정리
1. 에이전트의 도구 호출에 남아 있는 데이터 보호 공백
글은 에이전트가 질문에 답하는 수준을 넘어 도구를 통해 행동하게 되면서, 모든 도구 호출이 별도의 데이터 흐름이 되었다는 문제의식에서 출발한다. MCP 서버, SaaS API, 문서 저장소, 웹 검색으로 전달되는 정보는 모델의 입력과 출력에 집중된 기존 보호 범위에서 빠질 수 있다고 설명한다. 첫째, 모델이 문맥 전체를 바탕으로 도구 인자를 작성하면 해당 도구가 필요로 하지 않는 고객 이름이나 계정번호까지 외부로 전달될 수 있다. 둘째, 웹 페이지나 고객 기록에 포함된 불필요한 개인정보가 도구 응답을 통해 모델 문맥, 메모리, 추적 기록과 로그에 들어올 수 있다. 셋째, 문서 도구가 본문 대신 서명된 URL을 반환하면 문자열만 검사하는 필터는 원본 파일의 민감정보를 확인하지 못하므로, 글은 도구 호출 경계에 공통 통제가 필요하다고 주장한다.
2. AgentCore Gateway에 요청·응답 보호를 배치하는 방식
글이 제시하는 공통 통제 지점은 에이전트가 사용하는 도구 앞에 위치하는 Amazon Bedrock AgentCore Gateway다. 게이트웨이 인터셉터는 AWS Lambda 함수 형태의 사용자 코드를 실행하며, 요청 인터셉터는 도구에 전달되기 전의 호출을, 응답 인터셉터는 에이전트에 도달하기 전의 결과를 검사한다. 각 인터셉터는 전달 내용을 확인하거나 수정하거나 호출 자체를 차단할 수 있어, 민감정보 보호를 권한 통제 및 콘텐츠 안전 기능과 함께 배치할 수 있다는 설명이다. Skyflow 구성에서는 하나의 Lambda 함수를 REQUEST와 RESPONSE 두 지점에 연결하고, Skyflow Detect로 민감한 개체를 찾아 정책에 따라 토큰으로 바꾸거나 원래 값으로 복원한다. 글이 말하는 공통 적용 범위는 게이트웨이를 통과하는 호출과 그 뒤에 연결된 에이전트·도구이며, 모든 외부 데이터 흐름을 자동으로 포괄한다는 의미는 아니다.
3. 대형 유럽 은행의 카드 분쟁 조사 예시
원문은 엄격한 데이터 거주 요건을 가진 대형 유럽 은행을 가정하고, 카드 분쟁을 조사하는 에이전트의 업무로 보호 전후를 설명한다. 이는 특정 은행의 실증 성과를 보고한 사례가 아니라, 분석가의 요청에 따라 가맹점을 웹에서 검색하고 Amazon S3의 분쟁 기록을 요약하는 예시다. 보호가 없으면 고객 이름이 가맹점 검색어에 포함되어 외부 검색 제공자에게 전달되고, 검색 결과의 무관한 개인정보도 모델 문맥으로 들어올 수 있다고 서술한다. 또한 에이전트가 원본 분쟁 기록을 열면 고객의 성명, 이메일, 전화번호와 카드 정보를 그대로 읽게 된다. 제안 구성에서는 검색 제공자에게 고객 이름 대신 가역 토큰을 전달하고 웹 콘텐츠는 비식별화하며, 문서에는 비식별 사본의 링크만 제공하되 분석가에게는 필요한 실제 이름을 복원해 보여주는 흐름을 제시한다.
4. 도구 보호와 모델 보호의 차이
Shield the tool은 외부 도구가 실제 민감정보를 보지 못하게 하는 모드로, 나가는 인자의 값을 가역적인 vault 토큰으로 교체하고 돌아오는 결과에 포함된 토큰을 에이전트가 읽기 전에 복원한다. 글은 고객 신원을 몰라도 작업할 수 있는 웹 검색, 정보 보강, 제삼자 API를 대표적인 적용 대상으로 든다. Shield the model은 보호 경계를 모델 앞에 두어 프롬프트, 대화 이력, 파일과 도구 결과를 비식별화하고, 모델의 답변이 돌아올 때 실제 값을 복원하는 방식이다. 이를 위해 모델 호출은 게이트웨이의 추론 엔드포인트를 거쳐야 하며, 에이전트의 모델 클라이언트가 해당 엔드포인트를 사용하도록 설정해야 한다. 특히 응답에서는 그 호출에서 생성한 토큰만 복원한다고 설명하므로, 두 모드는 모두 토큰을 활용하지만 실제 정보를 차단하는 대상과 복원 범위가 다르다.
5. 문서 보호와 가역·비가역 토큰
Shield the document는 문서의 서명된 URL을 비식별 사본을 가리키는 URL로 교체해, 에이전트 측에서 원본의 실제 민감정보를 읽지 않게 하는 모드다. 프리뷰 상태인 Skyflow Detect v2가 파일을 직접 가져와 비식별화하고 승인된 리전에 사본을 저장하며, 인터셉터는 파일 본문을 직접 처리하지 않는다고 설명한다. 따라서 Lambda의 페이로드 제한이 파일 크기를 제한하지는 않지만, 문서 처리 설명에는 서명된 URL에 대한 허용 목록과 크기 제한 검사도 포함되어 있어 파일 크기에 아무 제한도 없다는 뜻은 아니다. 원문은 Amazon S3, Box, Google Drive의 사례 기록, 명세서, 계약서를 이러한 보호의 적용 대상으로 제시한다. 또한 vault 토큰은 권한이 있는 사용자가 Skyflow를 통해 복원할 수 있지만 일방향 카운터 토큰은 복원할 수 없다고 구분하며, 정책에서 사용할 토큰 종류를 정하도록 한다.
6. 정책 변경, 실패 시 차단과 운영 구성
운영 측면에서 글은 에이전트와 도구의 코드 변경을 최소화하고, 보호 정책은 재배포 없이 바꿀 수 있는 구성을 강조한다. 에이전트는 기존처럼 IAM 역할로 요청에 서명하며, 서버별·도구별 처리 방향, 탐지할 개체 유형, 가역 또는 일방향 토큰 선택은 AWS Systems Manager Parameter Store에 저장된 정책으로 결정한다. 비식별화를 완료할 수 없을 때에는 원문을 그대로 전송하지 않고 호출을 보류하며, 검사할 수 없는 트래픽과 허용 목록 밖의 파일 접근도 차단한다고 설명한다. Skyflow API 키는 AWS Secrets Manager에 저장하고 판단 내역과 경보용 지표는 Amazon CloudWatch에 남기되, 자격 증명이나 원래 민감정보 값은 인터셉터 로그에 기록하지 않는다고 밝힌다. 다만 모델 보호에는 추론 엔드포인트 설정이 필요하므로, 코드 변경이 없다는 소개와 별개로 해당 연결 설정은 구분해서 이해해야 한다.
7. 참조 아키텍처와 호출별 복원 범위
참조 아키텍처에서 에이전트는 AgentCore runtime에서 실행되며, IAM 역할로 서명한 도구 호출을 AgentCore Gateway에 보낸다. 요청 인터셉터가 도구와 정책을 대조해 필요한 인자를 비식별화하면 게이트웨이는 대상 도구를 호출하고, 응답 인터셉터는 정책에 따라 결과를 복원하거나 비식별화하거나 문서 URL을 교체한 뒤 에이전트에 전달한다. 인터셉터는 승인된 리전의 Skyflow Detect와 Skyflow Vault를 이용하며, 게이트웨이의 대상에는 외부 웹 검색 MCP 서버, Amazon S3의 사례 기록 저장소, 추론 대상으로 연결한 Amazon Bedrock 모델이 포함된다. 모델 호출에서는 Amazon DynamoDB에 각 호출이 생성한 토큰의 단기 기록을 두어 해당 토큰만 복원하며, 이 기록에는 원래 값이 들어 있지 않다고 설명한다. 이어지는 예시는 검색의 고객 이름 보호, 고객 답변 초안의 이름·이메일 보호, 사례 기록의 비식별 사본 제공으로 각 보호 경계가 어떻게 달라지는지를 보여준다.
8. Policy·Guardrails와의 역할 분담 및 제공 형태
글은 Skyflow를 AgentCore와 Amazon Bedrock의 기존 통제를 보완하는 구성으로 제시한다. AgentCore Policy는 Cedar와 Dogwood를 사용해 에이전트가 무엇을 할 수 있는지 판단하며, 이전 행동 이력, 에이전트와 모델 접근, 특정 도구로 전달되는 인자, 게이트웨이 통과 데이터에 대한 Guardrails 검사 등을 통제할 수 있다고 설명한다. Policy가 호출을 허용한 이후에는 Skyflow가 민감한 값을 토큰으로 교체해 도구나 모델에 실제 데이터가 노출되는 범위를 관리한다는 역할 분담이다. Amazon Bedrock Guardrails는 모델 상호작용의 콘텐츠 안전과 민감정보 가림을 담당하고, Skyflow는 여기에 vault 기반 토큰화와 문서 비식별화를 더하므로 함께 사용하는 다층 보호가 제안된다. 원문은 Skyflow를 AWS Marketplace에서 이용할 수 있고 인터셉터는 GitHub에 오픈소스로 공개되어 있다고 안내하지만, 제공된 본문에는 정량적인 탐지 정확도나 성능 검증 결과는 제시되지 않는다.
🧾 핵심 주장 / 시사점
- 민감정보 보호의 경계를 모델 입출력에서 도구 인자·도구 응답·문서 본문까지 확장해야 한다는 점이 글의 핵심 문제의식이다.
- 토큰의 복원 가능 여부와 복원 위치를 나누면, 업무 결과에 실제 정보가 필요한 경우에도 외부 도구나 모델이 이를 직접 읽는 범위를 줄이는 구성을 만들 수 있다.
- 공통 게이트웨이는 보호 정책을 집중 적용하는 지점이지만, 실제 보호 범위는 게이트웨이를 통과하는 호출, 모드별 설정, 검사 가능한 데이터와 실패 시 처리에 달려 있다.
✅ 액션 아이템
- AgentCore Gateway를 통과하는 도구 인자·도구 응답·문서의 서명된 URL을 중심으로 민감정보 노출 경로 검토.
- Shield the tool·Shield the model·Shield the document별 보호 대상과 복원 필요성을 비교하고, 모델 보호에 필요한 추론 엔드포인트 변경 검토.
- Skyflow Detect v2의 프리뷰 상태, 승인된 리전, 실패 시 차단 조건을 적용 제약으로 검토.
❓ 열린 질문
- AgentCore Gateway를 통과하는 도구 인자·도구 응답·문서의 서명된 URL 중 민감정보 보호가 필요한 범위는 어디까지인가?
- Shield the tool·Shield the model·Shield the document 중 어떤 조합이 업무에 필요한 정보 이용과 민감정보 노출 제한에 적합한가?
- Skyflow Detect v2의 프리뷰 상태와 승인된 리전, 실패 시 차단 조건을 현재 업무에서 수용할 수 있는가?