네트워크 이그레스 정책 관리

Sandboxes

송신 범위는 샌드박스별로 지정됩니다. 에이전트 샌드박스와 도구 샌드박스를 독립적으로 제어합니다.

agent.yaml에서 sandboxes.agent.network 또는 sandboxes.tool.network 아래에 각 샌드박스의 정책을 선언합니다. CLI 명령의 경우 --component agent 또는 --component tool를 사용합니다.

동일한 샌드박스에 있는 도구는 해당 샌드박스에 허용된 모든 이그레스 대상에 연결할 수 있습니다. 샌드박스가 도구 간에 비밀과 네트워크 액세스 주식 방법을 학습 보려면 MongoDB Atlas Agent Engine 제한을 참조하세요.

모드

각 샌드박스는 다음 모드 중 하나에서 작동하며, 이 모드는 에이전트 파일 에서 샌드박스의 network.egress_mode 필드 사용하여 설정하다 .

동일한 샌드박스의 대상 목록과 allow_all을 결합할 수 없습니다. 대상도 나열하는 샌드박스에 allow_all을 설정하다 에이전트 파일 유효성 검사 실패합니다.

배포가 이그레스 정책을 적용하는 방법

agent.yaml 파일 을(를 ) 배포 때 적용된 송신 정책의 진실 소스입니다. 첫 번째 배포 전에 샌드박스에 대해 network.egress_mode을(를) 설정하여 파일 에서 이그레스 정책을 선언합니다. allow_list의 경우 network.egress에서도 대상을 선언합니다. 파일 이 송신 정책을 선언하지 않으면 배포가 거부됩니다.

을 (배포 하면 플랫폼이 정책을 작업 공간에 적용합니다. 파일 에 선언된 모드 는 샌드박스의 기존 모드 보다 우선합니다.

배포서버 후 agentengine egress 또는 작업 공간 아웃바운드 액세스 UI 사용하여 적용된 설정을 확인합니다.

역할 기반 액세스 제어

RBAC(역할 기반 액세스 제어)를 사용하여 액세스 지정할 수 있습니다. 송신 작업에는 다음과 같은 역할이 필요합니다.

프로젝트 멤버(읽기) 역할 있는 사용자는 배포된 정책을 검사할 수 있습니다. 로컬 에이전트 파일 편집하는 데에는 역할 필요하지 않지만, 에이전트 배포하여 변경 사항을 적용 하려면 프로젝트 소유자 역할 필요합니다.

FQDN(정규화된 도메인 이름) 규칙

이 플랫폼은 다음 대상을 허용합니다.

• 호스트 이름(예: api.openai.com 또는 storage.googleapis.com)

• 하위 도메인 수준이 하나인 선행 레이블 와일드카드(예: *.example.com

• 두 개의 하위 도메인 수준이 있는 선행 레이블 와일드카드(예: *.*.example.com

• 모든 하위 도메인 수준과 일치하는 재귀 와일드카드(예: **.example.com). 이 플랫폼은 **.com과 같은 패턴도 허용합니다.

플랫폼은 다음 대상을 거부합니다.

• 다음과 같은 IP 리터럴 1.2.3.4

• 다음과 같은 CIDR 범위 10.0.0.0/8

• localhost, *.local, *.svc.cluster.local

• 클라우드 메타데이터 엔드포인트(예: *.metadata.google.internal 및 169.254.169.254)

• 베어 와일드카드(예: * 및 **)

• 선행하지 않는 와일드카드(예: api.*.com

• 단일 레이블 와일드카드가 2개 이상 있는 패턴은 다음과 같습니다. *.*.*.example.com

• 예약된 접미사(예: .arpa, .test, .example, .invalid)

대상이 이러한 규칙 중 하나라도 위반하면 유효성 검사 실패하고 대상이 적용되지 않습니다. agentengine agent validate를 실행 로컬에서 오류를 포착할 수 있습니다. 플랫폼은 빌드 경로 중에 동일한 유효성 검사 적용합니다. 이 오류는 fqdn_ip_literal 또는 fqdn_wildcard_misuse와 같은 이유를 예시 합니다.

IP addresses are not allowed; declare a hostname such as api.example.com

각 대상은 1 ~ 65535의 포트 범위 , 대상당 최대 10 포트, 작업 공간당 최대 50 대상을 지원합니다.

대상에 대한 포트를 생략하면 플랫폼은 해당 대상에 대한 모든 포트를 허용하고 비차단 경고를 반환합니다.

배포된 정책 보기

두 샌드박스에 대한 현재 정책을 보려면 agentengine egress 명령을 사용할 수 있습니다. 특정 작업 공간에 대한 정책을 보려면 --workspace 플래그를 사용합니다. 다음 예시 이러한 명령을 보여 줍니다.

# View the deployed policy for both sandboxes
agentengine egress
# View the policy for a specific workspace
agentengine egress --workspace my-workspace

agentengine egress 명령은 보기 전용입니다. 파일 기반 정책을 변경하려면 agent.yaml를 편집하거나 agentengine agent egress add 및 agentengine agent egress remove를 사용한 다음 에이전트 를 재배포합니다.

대상 추가 또는 제거

agentengine agent egress add 및 agentengine agent egress remove 명령은 로컬 에이전트 파일 에서 각 샌드박스의 network.egress 차단 편집합니다. 한 번에 하나의 대상을 변경하고 목록의 나머지 부분은 변경되지 않습니다. --component 플래그를 사용하여 하나의 샌드박스를 대상으로 합니다. 플래그를 생략하면 명령이 두 샌드박스를 모두 업데이트 . 이러한 로컬 편집은 에이전트 배포 때까지 배포된 정책을 변경하지 않습니다. 단일 대상을 변경하려면 다음 명령을 사용합니다.

# Add a destination for both sandboxes
agentengine agent egress add api.openai.com:443
# Add a destination with multiple ports for the tool sandbox only
agentengine agent egress add --component tool '*.mongodb.net:443,27017'
# Stop allowing a destination
agentengine agent egress remove api.openai.com

포트가 없는 베어 FQDN을 agentengine agent egress remove에 전달합니다. 에이전트 를 배포 후 agentengine egress 명령 또는 작업 공간 아웃바운드 액세스 UI 사용하여 새 설정을 확인합니다.

명령은 다음과 같이 작동합니다.

• 대상 샌드박스가 deny_all에 있는 경우, add은 이를 allow_list로 전환하고 mode: deny_all → allow_list을 출력합니다.

• 대상 샌드박스가 allow_all에 있는 경우, allow_all 모드 에서는 대상이 영향을 미치지 않으므로 add는 파일 변경하지 않고 그대로 둡니다. 대상을 추가하려면 먼저 agentengine agent egress mode 명령을 사용하여 모드 를 allow_list로 설정하다 .

• remove가 샌드박스의 마지막 대상을 제거하면 샌드박스는 deny_all로 돌아가서 no destinations remain; mode set to deny_all를 인쇄합니다.

• 동일한 FQDN과 동일한 포트를 의미하는 정확한 복제본을 추가해도 아무런 효과가 없습니다.

송신 모드 업데이트

agentengine agent egress mode를 사용하여 로컬 에이전트 파일 에서 각 샌드박스의 network.egress_mode 값을 설정하다 . --component 플래그를 사용하여 하나의 샌드박스를 대상으로 지정합니다. 이러한 변경 사항을 적용하려면 에이전트 배포합니다.

다음 예시에서는 송신 모드 업데이트 방법을 보여줍니다.

# Set allow-list mode
agentengine agent egress mode allow_list
# Set deny-all mode
agentengine agent egress mode deny_all
# Set allow-all mode
agentengine agent egress mode allow_all --confirm-allow-all

agentengine agent egress mode 명령은 로컬 에이전트 파일 만 편집합니다. 변경 사항을 적용하려면 에이전트 배포합니다.