에이전트 보안

관리 콘솔의 에이전트 보안에서 정책과 설정을 관리하세요. 에이전트 보안은 기존 정책 및 구성 메뉴를 대체합니다. 에이전트 보안은 Work와 dot의 로컬 컴퓨터 액세스 기능과 별도로 출시됩니다.

마이그레이션 대상인 기존 클라우드 정책의 설정은 전역 설정으로 이전되며, 정책 할당과 적용 순서는 유지됩니다. 에이전트 보안에서 이전된 정책을 검토하세요. 로컬 컴퓨터 액세스는 Work와 dot에서 각각 별도로 활성화해야 합니다.

설정이 적용되는 범위

각 정책은 전역 설정을 기준으로 합니다. 로컬 또는 Codex Cloud에서 지원하는 실행 설정은 환경별로 재정의할 수 있습니다. 환경에서 재정의하지 않은 설정은 해당 정책의 전역 설정을 상속합니다.

• 전역: 승인 및 웹 검색을 비롯한 오케스트레이터 제어 항목과 공통 실행 설정을 구성합니다.

• 로컬: 연결된 컴퓨터에서 작업을 실행할 때 적용할 설정을 조정합니다. 로컬 환경에서 지원하는 실행 설정만 조정할 수 있습니다.

• Codex Cloud: Codex 클라우드 작업에서 지원하는 실행 설정을 조정합니다. Codex Cloud를 활성화하기 전에 정책을 구성할 수 있지만, 권한 페이지에서 Codex Cloud를 활성화한 후에만 정책이 적용됩니다. Work Cloud에는 별도의 기능 권한이 있습니다. 자세한 내용은 Work Cloud에 에이전트 보안이 적용되는 방식을 참고하세요.

기준 설정 및 환경별 설정 추가

1. 에이전트 보안을 열고 기존 전역 정책과 각 정책의 할당 대상 및 적용 순서를 검토하세요. 조직에서 적용하려는 제어 항목과 일치하는지 확인하세요. 검토만으로 Work Cloud의 로컬 컴퓨터 액세스가 활성화되지는 않습니다.

2. 요구 사항과 기본값을 각각 검토하세요. 요구 사항은 사용자가 재정의할 수 없는 한계를 정합니다. 기본값은 그 범위 안에서 처음 적용할 값을 정합니다.

3. 오케스트레이터 제어 항목은 전역 설정에 두세요. 여기에는 승인 요구 사항, 허용되는 웹 검색 모드, 관리형 도구 제어 항목이 포함됩니다.

4. 샌드박스, 파일 시스템 권한, 실행 시 관리형 네트워크 액세스 등 지원되는 실행 제어 항목에 로컬 또는 Codex Cloud 환경 설정을 추가하세요. 특정 운영 체제에만 적용해야 한다면 해당 운영 체제에 한해 설정을 재정의하세요.

5. 정책을 저장하고 입력한 설정에 대한 유효성 검사 메시지를 확인하세요.

제어 항목 및 구성 필드 선택

오케스트레이터는 작업을 조율합니다. 실행기는 작업의 실행 단계를 수행하는 컴퓨터 또는 클라우드 컨테이너입니다. 오케스트레이터 제어 항목은 전역에서 구성하세요. 환경별 requirements.toml 설정은 실행 제어 항목만 지원합니다. 승인 정책과 웹 검색 같은 오케스트레이터 설정은 전역에서만 구성하며, 환경별로 재정의할 수 없습니다.

오케스트레이터 제어 항목

이 항목들은 전역에서 구성하세요. 관리형 정책을 활성화하면 로컬 액세스를 사용하는 Work와 dot에 공유 클라우드 오케스트레이터를 통해 지원되는 전역 정책이 적용됩니다. 환경별로 재정의할 수 있는 항목은 지원되는 실행 설정에 한정되며, 오케스트레이터 제어 항목은 재정의할 수 없습니다. 아래의 승인, 웹 검색, 앱, MCP, 플러그인 및 규칙 요구 사항 가운데 에이전트 보안 UI에서 전용 설정을 제공하는 항목은 허용되는 승인 정책 및 허용되는 웹 검색 모드뿐입니다. 나머지 필드는 TOML에서 구성하세요.

Work Cloud의 로컬 컴퓨터 액세스에서 사용하는 훅

전역에서 TOML로 편집을 선택하고 로컬 컴퓨터 액세스를 사용하는 Work와 dot에 적용할 mcp_tool 핸들러를 구성하세요. 훅으로 도구 실행을 차단하려면 먼저 훅이 명시적으로 거부할 때와 콜백이 실패할 때 도구가 어떻게 동작하는지 모두 테스트하세요. 지원되는 핸들러와 이벤트는 클라우드 오케스트레이션에서 사용하는 훅을 참고하세요.

전역에는 데스크톱 및 클라이언트 설정도 있습니다. 일부 설정은 데스크톱 앱에만 적용됩니다. 전역에서 구성한 설정이라도 적용 범위는 다를 수 있습니다. 각 필드의 지원 범위는 구성 레퍼런스에서 확인하세요.

실행 제어 항목(실행기)

이 필드들은 컴퓨터 또는 클라우드 컨테이너에서 작업을 실행하는 방식을 제어합니다. 공통값은 전역에서 설정하세요. 로컬 또는 Codex Cloud에서 다른 값이 필요한 경우 해당 환경에서 지원되는 설정을 재정의하세요.

위 표는 환경별로 재정의할 수 있는 필드 그룹을 보여 줍니다. 그룹별로 지원하는 옵션은 플랫폼에 따라 다를 수 있습니다. 여러 정책에 걸쳐 적용되는 요구 사항 중에는 한 정책의 값이 다른 정책의 값을 대체하지 않고 서로 결합되는 항목도 있습니다. 지원되는 값은 구성 레퍼런스에서, 네트워크 예외는 관리형 구성 가이드에서 확인하세요.

Codex Cloud에서 지원하는 관리형 실행 경로에서는 에이전트 보안에서 도메인을 허용해도 환경의 제한이 우선합니다. 샌드박스 권한의 전면 승격이 승인되면 해당 명령어는 관리형 명령어 프록시를 우회할 수 있습니다. 프록시의 적용 범위는 네트워크 격리를 참고하세요.

UI에서 네트워크 설정 구성

1. 관리 콘솔 > 에이전트 보안으로 이동하세요. 정책을 선택한 다음 전역, 로컬 또는 Codex Cloud를 선택하세요. 공통 기준은 전역에서 설정하고, 환경별로 달라야 하는 설정은 해당 환경에서 재정의를 지원하는 경우에만 재정의하세요.
2. 요구 사항을 열고 네트워크 관리를 켜세요. 필요한 도메인 항목을 추가하고 각 항목에 대해 허용 또는 거부를 선택하세요. 일반 사용자 설정이나 도메인별 승인으로 관리형 프록시 허용 목록을 확장할 수 없도록 하려면 관리자가 추가한 도메인만 허용을 켜세요.
3. 저장하기 전에 실제로 적용될 설정과 상속된 규칙을 검토하세요. 환경 설정을 비워 두면 전역 설정이 지워지지 않고 그대로 상속됩니다. Codex Cloud에서는 로컬 및 사설 네트워크 연결도 별도로 확인하세요. 네트워크 관리를 끄는 것과 클라우드 환경의 인터넷 액세스를 끄는 것은 별개의 설정입니다.
4. Codex Cloud에서는 환경의 인터넷 액세스, 대상 및 메서드 설정도 확인하세요. 설정을 저장한 다음 허용하려는 요청과 차단하려는 요청을 각각 테스트하세요. 샌드박스 권한의 전면 승격을 허용하는 경우에는 이 경로도 별도로 테스트하세요.

실제로 허용되는 대상이 없는 경우

네트워크 관리와 관리자가 추가한 도메인만 허용을 모두 켜면 일반 관리형 명령어는 실제로 허용된 대상에만 연결할 수 있습니다. 직접 구성하거나 상속한 허용 항목이 없으면 이러한 명령어가 접근할 수 있는 대상도 없습니다. 거부 항목만 있는 정책이 나머지 인터넷 대상을 암묵적으로 허용하지는 않습니다. 저장하기 전에 필요한 허용 항목을 추가하고 상속된 규칙을 확인하세요. 이 제한은 관리형 명령어 프록시에 적용됩니다. 모든 도구나 승인된 샌드박스 권한 전면 승격에 일괄 적용되는 제한은 아닙니다.

Codex Cloud의 로컬 및 사설 네트워크 연결

로컬 및 사설 네트워크 연결을 명시적으로 끄면 대상 도메인을 허용했더라도 Codex Cloud가 업스트림 프록시에 연결하지 못할 수 있습니다. 최종 allow_local_binding 값을 확인하고 어느 정책이나 설정에서 이 값을 지정했는지 파악하세요. 지원되는 클라우드 프록시 경로에서는 적용 가능한 요구 사항, 선택한 네트워크 프로필, 프록시 기능 설정 중 어느 곳에서도 값을 지정하지 않은 경우에만 기본값이 true입니다. 상속된 false도 명시적인 설정값으로 간주합니다. 재정의를 지원하는 경우 우선순위가 더 높은 클라우드 설정으로 재정의하면 로컬에서 사용하는 전역 값은 유지하면서 Codex Cloud에 적용되는 값만 변경할 수 있습니다. 이렇게 해도 도메인 허용 항목이 추가되지는 않습니다. 재정의를 사용하기 전에 실행기가 이를 지원하는지 확인하세요. 이 클라우드 기본값을 로컬에 적용하지 마세요.

환경 기본값

기본값 편집기는 config.toml 필드를 사용합니다. 이 필드들은 requirements.toml의 제약 조건과 다릅니다. 환경에서 지원하는 최상위 기본값은 다음과 같습니다.

• 셸 동작: allow_login_shell 및 shell_environment_policy.

• 샌드박스 및 권한: sandbox_mode, sandbox_workspace_write, default_permissions 및 permissions.

• Windows 실행: windows.

기본값은 강제 적용되는 요구 사항을 재정의하지 않습니다. 승인 및 웹 검색 설정을 비롯한 오케스트레이터 기본값은 전역에 두세요.

여러 정책이 함께 적용되는 방식

• 여러 정책이 적용되면 우선순위가 높은 정책이 우선합니다. 우선순위가 낮은 정책이 더 구체적이어도 마찬가지입니다.

• 한 정책 안에서 지원되는 실행 설정의 우선순위는 특정 운영 체제에 대한 환경별 재정의, 모든 운영 체제에 대한 환경별 재정의, 전역 설정 순입니다.

• 로컬 실행에서는 MDM 및 기존 관리형 기기 요구 사항이 에이전트 보안보다 우선합니다. 기기의 시스템 요구 사항 파일은 에이전트 보안보다 우선순위가 낮습니다.

한 정책에서 동일한 도메인 규칙을 관리자가 환경별로 재정의하면 전역에서 거부한 도메인을 해당 환경에서 허용하거나 전역에서 허용한 도메인을 거부할 수 있습니다. 환경별로 재정의하지 않으면 전역 규칙을 상속합니다. 그 밖에 적용되는 거부 규칙이나 액세스 제어에 따라 요청이 차단될 수 있습니다.

이 설명은 한 정책 안에서 동일한 도메인 키를 비교하며, 우선순위가 더 높은 다른 정책이 결과를 바꾸지 않는 경우를 전제로 합니다. 동일한 키의 값은 우선순위가 더 높은 값으로 대체됩니다. 상속된 다른 키는 유지됩니다. 허용 규칙이 있어도 상속된 와일드카드처럼 요청과 일치하는 다른 거부 규칙은 우회할 수 없습니다. 환경별 규칙 맵을 비워 두어도 상속된 규칙은 지워지지 않습니다.

Work Cloud에 에이전트 보안이 적용되는 방식

클라우드 브라우저 사용 및 클라우드 네트워크 액세스 설정은 관리 콘솔 > 권한 및 역할 > 워크스페이스 기능 > 클라우드 컴퓨터 기능에서 구성하세요. Work Cloud와 dot은 이러한 기능을 공유하며, 기능 권한은 Work Cloud 액세스와 별도로 구성할 수 있습니다. Work 작업을 실행하려면 Work 액세스 권한과 작업에 필요한 각 기능의 사용 권한이 모두 있어야 합니다. 브라우저 액세스와 코드 또는 셸을 통한 네트워크 액세스를 각각 검토하세요. 한쪽을 비활성화해도 다른 쪽이 자동으로 비활성화되지는 않습니다.

Work Cloud 컨테이너와 dot의 클라우드 컴퓨터는 다른 유형의 실행기에서 사용하는 관리형 환경 번들 대신 자체 실행 구성과 요구 사항을 사용합니다. 로컬 파일 및 네트워크 제한은 이러한 클라우드 컴퓨터에 자동으로 적용되지 않습니다. 지원되는 전역 오케스트레이터 정책의 적용 범위는 별도입니다. 전역 정책이나 Codex Cloud 환경별 재정의로는 공유 클라우드 기능 권한을 구성할 수 없습니다. 해당 권한은 별도로 검토하세요.

구성원에게 실제로 적용되는 액세스 권한을 확인할 때는 워크스페이스 기본값, 직접 또는 그룹을 통해 할당된 모든 역할, 락다운 모드처럼 별도로 강제되는 제한을 함께 확인하세요.

Work Cloud에서 로컬 컴퓨터 액세스 허용을 활성화하기 전에 전역 기준 설정을 검토하고 조직에서 사용하는 제어 항목과 호환되는지 확인하세요. ChatGPT 데스크톱 앱에서 로컬로 Codex 사용을 먼저 활성화할 필요는 없습니다. 클라우드 정책 중 하나라도 enforce_residency가 활성화되어 있으면 Work와 dot 모두에서 로컬 컴퓨터 액세스 허용이 비활성화됩니다. 이 보호 조치는 워크스페이스의 데이터 레지던시를 설정하지 않으며, 이 조치만으로 Work Cloud나 dot이 비활성화되지는 않습니다. 별도의 설정 절차, 이용 조건, 연결 방식은 Work Cloud 및 dot의 로컬 컴퓨터 액세스를 참고하세요.

정책 API 및 Terraform

전역 설정은 정책 API로 관리하세요. 로컬 또는 Codex Cloud 설정은 에이전트 보안 UI에서 관리하세요. 마이그레이션 후에도 기존 전역 API 워크플로우를 계속 사용할 수 있습니다. 스크립트와 Terraform 연동을 테스트하고 정책 할당과 적용 순서가 그대로인지 확인하세요.

정책 마이그레이션은 SCIM 멤버십 동기화나 RBAC 역할을 변경하지 않습니다.

관련 가이드

• 관리형 구성: 정책 전달, 우선순위 및 필드별 병합 방식.

• 구성 레퍼런스: 필드 정의 및 Work 호환성.

• Work Cloud 및 dot의 로컬 컴퓨터 액세스: 사전 요구 사항 및 설정 절차.

• 역할 및 워크스페이스 권한: Work 및 Codex 기능에 대한 액세스.