관리자 배포 가이드

이 가이드를 사용하여 다음 관리 경계 전반에 걸친 ChatGPT Enterprise 배포를 계획하세요.

• 워크스페이스 액세스.
• ChatGPT 데스크톱 앱, Codex CLI 및 IDE 확장 프로그램에서 지원 대상 기능에 적용되는 로컬 런타임 정책.
• Codex cloud.
• Platform API 액세스.
• 플러그인 및 커넥터 액세스.
• 연결된 시스템의 권한.

새로 배포할 때는 단계를 순서대로 완료하고, 특정 경계 하나를 변경하려면 링크된 페이지를 사용하세요.

로컬 Codex 클라이언트용 모델 게이트웨이를 관리한다면, 게이트웨이를 통해 Codex 배포를 참조하여 게이트웨이의 적합성을 검증하고 자격 증명을 배포하며 클라이언트 인계를 진행하세요. 배포 환경에서 워크스페이스 기능을 사용하는 경우 워크스페이스 액세스를 별도로 구성하세요.

워크스페이스 설정에서 Codex and Work Local 은 로컬 Codex 및 Work 액세스를 Allow members to use Codex and Work Locally 아래에 통합합니다. 일부 워크스페이스는 대신 서로 독립된 Codex Local 및 Work Local 섹션을 제공합니다. 이 레이아웃에서는 Allow members to use Codex locally 가 Codex를 제어하고, Use Work locally 가 Work를 제어합니다. 어느 하나를 활성화해도 다른 하나는 활성화되지 않습니다. 이러한 레이블은 별도의 제품이나 클라이언트가 아니라 워크스페이스 권한을 나타냅니다. 토큰 권한과 자격 증명 유효 기간 제한은 워크스페이스에 따라 Access tokens 섹션 또는 로컬 액세스 섹션에 표시됩니다. 관리형 구성은 해당 클라이언트에서 관련 기능이 지원하는 런타임 동작을 제한할 수 있는 별도의 정책 계층입니다. 이 가이드에서는 동작이나 가용성이 다를 때 개별 화면의 이름을 명시합니다.

액세스 제어에 대한 개요는 역할 및 워크스페이스 권한을 참조하세요. 최신 ChatGPT 워크스페이스 절차는 도움말 센터 안내를 참조하고, 로컬 및 호스팅 런타임 동작은 링크된 개발자 문서를 참조하세요.

엔터프라이즈 보안, 개인정보 보호 및 런타임 보호에 관한 자세한 내용은 에이전트 승인 및 보안과 Codex 보안 백서를 참조하세요.

1단계: 담당자를 지정하고 배포 방식 선택하기

배포의 각 부분을 담당할 담당자를 지정하세요.

• 워크스페이스 액세스: 멤버십, 좌석, 역할 및 지원되는 워크스페이스 기능.
• 로컬 런타임 정책: 지원되는 로컬 클라이언트의 승인, 권한 프로필, 파일 시스템 및 네트워크 액세스와 기타 요구 사항.
• Codex cloud: 호스팅 환경, 저장소 연결 및 클라우드 런타임 정책.
• 연결된 시스템: 제공업체 측 애플리케이션 설치, 계정 및 권한.
• 보고 및 규정 준수: 분석 액세스, 감사 내보내기 및 다운스트림 데이터 처리.

각 사용자 그룹에 ChatGPT 데스크톱 앱, Codex CLI, IDE 확장 프로그램, Codex cloud에서 지원되는 로컬 기능 중 무엇이 필요한지, 또는 이들의 조합이 필요한지 결정하세요. 워크플로가 API key 인증을 사용하는 경우 Platform API 액세스는 별도의 조직 및 프로젝트 경계로 취급하세요.

2단계: 워크스페이스 액세스 및 ID 구성하기

ChatGPT 워크스페이스 멤버십, 좌석, 그룹 및 지원되는 RBAC 권한을 사용하여 대상 사용자 그룹에 지원되는 워크스페이스 기능을 부여하세요. 모든 환경이 동일한 역할로 제어된다고 가정하지 말고, 최신 워크스페이스 안내에 따라 로컬 클라이언트 및 Codex cloud 액세스를 확인하세요. 기본 제공 관리 역할은 워크스페이스를 관리하는 사람에게만 부여하세요.

워크스페이스 제어와 레이블은 시간이 지나면서 변경됩니다. 최신 절차는 다음 자료를 참조하세요.

• 멤버, 시트 유형, 역할 및 액세스 관리
• 역할 기반 액세스 제어 구성
• 워크스페이스 설정 관리
• 그룹 및 프로비저닝
• 사용자 수명 주기 관리
• 인증

의도한 권한을 가진 구성원과 함께 로그인 및 기능 액세스를 테스트하세요. 워크스페이스 액세스가 있어도 연결된 서비스의 저장소, 파일 또는 작업에 대한 액세스가 부여되지는 않습니다.

Work Cloud의 로컬 컴퓨터 액세스 설정

도입 범위에 Work 또는 dots의 로컬 컴퓨터 액세스가 포함된다면 도입 전에 Agent Security에서 정책을 검토하세요. 정책 마이그레이션과 기능 액세스는 별개의 변경 사항이며, 확인 절차에서 액세스를 활성화하기 위해 정책을 만들 필요는 없습니다. 관리형 정책이 활성화되면 지원되는 Global 정책이 클라우드 오케스트레이션을 제어합니다. 연결된 컴퓨터에는 로컬 실행 요구 사항과 기기 제어가 적용됩니다. Work 클라우드 컨테이너와 dots 클라우드 컴퓨터는 자체 실행 구성과 요구 사항을 사용합니다. 각각의 설정 및 사용 자격 요구 사항은 Work Cloud 및 dots의 로컬 컴퓨터 액세스를 따르세요.

Global 설정은 정책 API를 사용하여 관리합니다. Local 또는 Codex Cloud 설정은 Agent Security UI를 사용하여 관리합니다. 기존 Global API 워크플로는 마이그레이션 후에도 계속 사용할 수 있습니다. 스크립트와 Terraform 통합을 테스트하고 정책 할당과 순서가 변경되지 않았는지 확인하세요.

동기화를 활성화하기 전에 호환성을 확인하세요:

네트워크 정책. 환경별 재정의가 가능한 경우 관리형 구성에 설명된 experimental_network 예외를 테스트하세요. 환경에서 허용하더라도 전역 제한은 계속 적용될 수 있습니다.

• Enterprise 훅. 워크스페이스에서 활성화된 경우, Work Cloud의 로컬 컴퓨터 액세스는 지원되는 수명 주기 및 도구 이벤트에 대해 클라우드 코디네이터(오케스트레이터)에서 실행되는 관리자 정의 MCP 훅을 지원합니다. 도구가 로컬에서 실행되더라도 클라우드 오케스트레이션에서는 명령 훅과 로컬 구성 또는 플러그인의 훅을 지원하지 않습니다.

• 지원되지 않는 훅. 도구가 로컬에서 실행되더라도 클라우드 오케스트레이션에서는 명령 훅과 로컬 구성 또는 플러그인의 훅을 지원하지 않습니다. 오케스트레이션과 실행이 모두 로컬에서 이루어지는 경우, 기존에 지원되던 훅은 로컬 전용 Work 및 Codex 스레드에서 계속 작동합니다. 관리자는 이러한 워크플로에 대해 Agent Security에서 지원되는 관리형 훅을 계속 구성할 수 있습니다.

• 감사. 이러한 훅에 의존하기 전에 콜백 연결을 테스트하고, 수신하는 이벤트를 확인하고, 실패가 작업에 미치는 영향을 점검하세요. MCP 훅은 완전한 Compliance API 감사 추적을 제공하지 않습니다.

• 데이터 요구 사항. Work Cloud의 로컬 컴퓨터 액세스는 엄격한 데이터 무보존을 제공하지 않습니다. 데이터 레지던시와 추론 레지던시는 적격 콘텐츠와 지원되는 워크로드, 리전, 구성에만 적용됩니다. Enterprise Key Management(EKM)는 적격 워크스페이스에 저장된 지원 대상 콘텐츠에 적용됩니다. Work는 UAE 추론 레지던시에서 지원되지 않습니다. 클라우드 정책 중 하나라도 enforce_residency가 활성화되어 있으면 Work와 dots 모두에서 로컬 컴퓨터 액세스 허용 이 비활성화됩니다. 이 보호 조치는 워크스페이스 레지던시를 구성하지 않으며, 그 자체로 Work Cloud나 dots를 비활성화하지도 않습니다. 조직에서 ZDR을 요구하는 경우 이 기능을 활성화하지 마세요.

워크스페이스 소유자는 대상 사용자 또는 그룹의 Work 권한을 검토하세요. Work Cloud를 활성화한 다음 로컬 컴퓨터 액세스 허용 을 켜세요. 지원되는 역할 할당을 통해 액세스 권한을 부여하세요. 역할 및 워크스페이스 권한을 참고하세요.

3단계: 로컬 런타임 요구 사항 구성하기

사용자가 ChatGPT 데스크톱 앱, Codex CLI 또는 IDE 확장 프로그램에서 지원되는 로컬 실행을 시작하면 로컬 요구 사항이 런타임 동작을 제한합니다. 지원되는 클라우드, 기기 또는 시스템 채널을 통해 requirements.toml을 제공하세요. 이 정책은 ChatGPT 워크스페이스 역할 및 그룹과 별도로 유지하세요.

레거시 샌드박스 모드 제한을 기반으로 새 배포를 구성하는 대신 지원되는 로컬 클라이언트용 권한 프로필을 사용하세요. 예시는 다음과 같습니다.

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true

지원되는 브라우저 및 데스크톱 기능 환경 전반에서 Computer Use를 비활성화하려면 해당 경험에 관여하는 각 공개 기능 키를 제한하세요.

[features]
browser_use = false
browser_use_full_cdp_access = false
browser_use_external = false
in_app_browser = false
computer_use = false

공식 키 목록, 제공 동작, 우선순위 및 추가 예시는 관리형 구성과 requirements.toml 참조를 확인하세요.

4단계: 저장소 구성 표준화하기

저장소 범위 구성을 사용하면 모든 사용자가 설정을 중복하지 않고도 프로젝트 기본값, 규칙 및 스킬을 공유할 수 있습니다. 기능에 문서화된 위치에 따라 구성을 .codex 또는 .agents에 체크인하세요.

저장소 구성은 기본값과 재사용 가능한 워크플로를 제공할 수 있습니다. 하지만 워크스페이스, 모델, Platform API 또는 연결된 시스템에 대한 액세스를 부여할 수는 없습니다.

5단계: Codex cloud 구성하기

Codex cloud는 호스팅 환경과 연결된 소스 저장소를 사용합니다.

Enterprise 워크스페이스에서는 Codex Cloud가 기본적으로 꺼져 있습니다. 기존 클라우드에서 Codex 사용 설정은 Codex Cloud (Legacy)에서 그대로 유지됩니다. 이미 Cloud를 활성화한 워크스페이스는 액세스 권한을 유지하며, Cloud가 비활성화된 워크스페이스는 관리자가 활성화할 때까지 꺼진 상태로 유지됩니다. 액세스에는 계속해서 출시 범위와 워크스페이스 제한이 적용됩니다.

각 경계에 대한 계획을 수립하세요:

1. 대상 사용자에게 클라우드에서 Codex 사용 권한을 부여하세요. 별도로 워크스페이스 환경 관리 권한을 워크스페이스 공유 환경을 만들고 편집하는 사용자에게 부여하세요. 자세한 내용은 워크스페이스 역할 안내를 참고하세요.
2. 지원되는 소스 시스템 통합을 설치하고 구성하세요.
3. 소스 시스템의 저장소 액세스를 각 대상 사용자에게 필요한 저장소로 제한하세요.
4. 해당 저장소에 대한 클라우드 환경, 비밀 정보, 인터넷 액세스 및 지원되는 클라우드 관리형 요구 사항을 구성하세요.
5. 코드 검토와 같은 선택적 호스팅 워크플로를 구성하세요.
6. 대표 구성원으로 작업 액세스를 테스트하고 지정된 관리자로 환경 관리를 테스트하세요. 각 사용자의 워크스페이스, 환경, 저장소 권한을 확인하세요.

클라우드 환경은 로컬 기기 정책, MDM 설정 또는 로컬 네트워크 액세스를 상속하지 않습니다. 지원되는 클라우드 관리형 요구 사항은 사용자의 컴퓨터에 설치된 요구 사항과 별도로 검토하세요. 자세한 내용은 서비스 연결에서 대상 액세스를 확인하고, Agent Security에서 워크스페이스 요구 사항이 클라우드 환경을 제한하는 방식을 확인하세요.

Codex cloud는 연결된 소스 시스템에서 제공하는 저장소 권한과 보호 조치를 준수합니다. 워크스페이스 액세스 권한으로 이러한 제어를 우회할 수는 없습니다. 클라우드 환경에서 설정 및 런타임 안내를 확인하세요.

6단계: 플러그인 및 연결된 기능 구성하기

플러그인 설치, 번들 스킬, 커넥터 기반 기능, 커넥터 작업 및 소스 시스템 권한 부여를 각각 별개의 결정 사항으로 검토하세요. 커넥터 기반 기능을 비활성화해도 플러그인이나 번들 스킬이 반드시 제거되는 것은 아닙니다.

배포에 플러그인이나 스킬을 포함하기 전에 다음을 수행하세요.

1. 출처, 책임 담당자, 대상 사용자 그룹 및 검토 날짜를 확인합니다.
2. 번들 스킬, 커넥터, MCP server, 후크와 각 기능에 필요한 데이터 및 작업을 검토합니다.
3. 민감하지 않은 데이터와 필요한 최소 액세스 권한으로 테스트합니다.
4. 재검토 및 사용 종료 담당자를 기록합니다.

플러그인은 웹, 데스크톱 및 모바일용 ChatGPT의 Chat과 Work에서, ChatGPT 데스크톱 앱의 Codex에서, 그리고 Codex CLI 플러그인 브라우저를 통해 작동합니다. IDE 확장 프로그램에서는 사용할 수 없습니다. ChatGPT와 Codex는 하나의 범용 공개 플러그인 디렉터리를 공유하며, 워크스페이스 제어를 통해 구성원이 이러한 플러그인 중 어떤 항목에 액세스할 수 있는지 결정합니다.

전체 모델은 플러그인 제어와 스킬 제어를 참조하세요.

7단계: 거버넌스 및 관찰 가능성 설정하기

질문에 적합한 보고 환경을 선택하세요.

• 대화형 ChatGPT 워크스페이스 분석 및 Codex 분석에는 워크스페이스 분석을 사용합니다.
• Codex Analytics API를 통한 프로그래밍 방식의 집계 보고에는 Analytics API를 사용합니다.
• 감사 및 조사 기록에는 Compliance API를 사용합니다.
• 요금제에 따라 달라지는 Codex 활동이 사용 가능한 ChatGPT 워크스페이스 크레딧을 소비하는 경우 ChatGPT 사용량 한도 및 지출 제어를 사용합니다.

통합을 구축할 때는 인증이 필요한 API 참조 문서에서 최신 액세스 요구 사항, 스키마, 필드, 보존 정책 및 요청 동작을 확인하세요.

통합 경계를 보호하세요.

• API key 및 기타 통합 자격 증명을 조직의 비밀 관리 시스템에 저장합니다.
• 다운스트림 시스템 및 보존 데이터에 대한 액세스를 승인된 사용자 그룹으로 제한합니다.
• 내보낸 Compliance API 기록을 민감도 및 조직의 보존 정책에 따라 보호하고, 최신 계약을 기준으로 수집 및 삭제 워크플로를 테스트합니다.

8단계: 배포 검증 및 유지 관리하기

Work Cloud의 로컬 컴퓨터 액세스를 활성화한 후 새 작업을 만들고 지원되는 다른 기기에서 대화를 이어가세요. 기존 작업은 마이그레이션되지 않으며 원래의 로컬 전용 또는 클라우드 전용 동작을 유지합니다. 컴퓨터의 파일이나 도구가 필요한 단계를 수행하려면 컴퓨터를 온라인 상태로 유지하세요. 정책에서 허용해야 하는 동작과 차단해야 하는 동작을 테스트하고, 로컬 실행과 클라우드 실행 각각에 적용되는 승인, 파일 시스템 및 네트워크 제한을 별도로 확인하세요. 로컬 컴퓨터를 사용할 수 없는 상태에서 새 턴을 시작하는 것도 테스트하세요. 적격 작업은 해당 컴퓨터의 로컬 파일이나 도구에 액세스하지 않고도 클라우드 컨테이너에서 계속 진행할 수 있습니다. 작업은 턴이 진행되는 도중에 로컬 실행에서 클라우드로 전환할 수 없습니다.

실제로 적용된 설정과 각 테스트 결과를 기록하세요. 제한이 예상대로 작동하지 않으면 사용자가 해당 제한에 의존하기 전에 문제를 해결하세요. 동기화를 비활성화할 때는 문서에 명시된 동작을 따르세요. 액세스 권한 제거, 작업 중단, 데이터 보존은 별개의 조치로 다루세요.

대표 ID를 사용하여 적용 가능한 모든 경계를 검증하세요.

• ChatGPT 워크스페이스 멤버십, 좌석 및 지원되는 역할 권한.
• 로그인 및 유효한 런타임 요구 사항을 포함하여 ChatGPT 데스크톱 앱, Codex CLI 및 IDE 확장 프로그램에서 지원되는 로컬 기능.
• Codex cloud 액세스, 환경 구성 및 저장소 권한.
• API key 워크플로를 위한 Platform API 조직 및 프로젝트 액세스.
• 플러그인 설치, 번들 스킬, 커넥터 액세스 및 지원되는 작업.
• 연결된 시스템의 권한 부여 및 데이터 액세스.
• 담당 관리자의 분석 및 규정 준수 액세스.

각 제어의 담당자와 현재 절차의 출처를 기록하세요. 이 기록을 사용하면 관리 모델을 변경하지 않고도 UI 또는 정책이 변경될 때 관리자가 절차를 업데이트할 수 있습니다.

초기 배포 후에는 액세스, 연결된 기능, 크레딧 사용량, 지원 피드백 및 팀에서 실제로 사용하는 워크플로를 검토하세요. 이러한 신호가 변경되면 배포 범위와 관리자 안내를 조정하세요.

Work Cloud의 로컬 컴퓨터 액세스를 꺼야 하는 경우

Work Cloud의 로컬 컴퓨터 액세스를 끄면 현재 실행 중인 턴이 중단됩니다. 사용자는 기존 클라우드 대화에서 새 턴을 시작할 수 있습니다. 이 턴은 로컬 파일에 액세스하지 않고 자동으로 Work Cloud를 사용합니다. 사용자에게 중단 후 새 턴을 시작하도록 안내하고, 클라우드 스레드에서 더 이상 로컬 파일을 사용할 수 없다고 설명하세요.