이 가이드를 사용해 다음 관리 영역별로 ChatGPT Enterprise 도입을 계획하세요.
- 워크스페이스 액세스
- ChatGPT 데스크톱 앱, Codex CLI, IDE 확장 프로그램에서 정책 적용 대상 기능을 제어하는 로컬 런타임 정책
- Codex Cloud
- Platform API 액세스
- 플러그인 및 커넥터 액세스
- 연결된 시스템의 권한
처음 도입할 때는 단계를 순서대로 진행하세요. 특정 영역의 설정만 변경하려면 해당 영역에 연결된 문서를 참고하세요.
로컬 Codex 클라이언트용 모델 게이트웨이를 관리한다면 게이트웨이 배포를 참고해 게이트웨이의 적합성을 검증하고, 자격 증명을 배포하고, 클라이언트 측 설정을 인계하세요. 워크스페이스 기능을 사용하는 배포 환경에서는 워크스페이스 액세스를 별도로 구성하세요.
워크스페이스 설정의 Codex 및 Work 로컬 섹션에서는 멤버의 로컬 Codex 및 Work 사용 허용 설정 하나로 두 기능의 로컬 액세스를 관리합니다. 일부 워크스페이스에서는 Codex 로컬 섹션과 Work 로컬 섹션이 따로 표시됩니다. 이 경우 멤버의 로컬 Codex 사용 허용 설정은 Codex에, 로컬에서 Work 사용 설정은 Work에 적용됩니다. 하나를 켜도 다른 하나가 켜지지는 않습니다. 이 이름은 각각의 워크스페이스 권한을 가리키며, 별도의 제품이나 클라이언트를 뜻하지 않습니다. 토큰 권한과 자격 증명의 유효 기간 제한은 워크스페이스에 따라 액세스 토큰 섹션이나 로컬 액세스 섹션에 표시됩니다. 관리형 구성은 이와 별개로 적용되는 정책으로, 해당 클라이언트에서 정책 적용 대상 기능의 런타임 동작을 지원 범위 내에서 제한할 수 있습니다. 동작이나 지원 여부가 다른 경우에는 이 가이드에서 해당 앱이나 도구를 명시합니다.
액세스 제어에 대한 개요는 역할 및 워크스페이스 권한을 참고하세요. ChatGPT 워크스페이스의 최신 관리 절차는 도움말 센터에서, 로컬 및 호스팅 런타임의 동작은 연결된 개발자 문서에서 확인하세요.
엔터프라이즈 보안, 개인정보 보호, 런타임 보호에 대해서는 에이전트 승인 및 보안과 Codex 보안 백서를 참고하세요.
1단계: 담당자 지정 및 도입 범위 결정
도입 영역별로 담당자를 지정하세요.
- 워크스페이스 액세스: 멤버십, 시트, 역할 및 지원되는 워크스페이스 기능
- 로컬 런타임 정책: 지원되는 로컬 클라이언트의 승인, 권한 프로필, 파일 시스템 및 네트워크 액세스, 기타 요구 사항
- Codex Cloud: 호스팅 환경, 리포지터리 연결 및 클라우드 런타임 정책
- 연결된 시스템: 서비스 제공자 측의 애플리케이션 설치, 계정 및 권한
- 보고 및 규정 준수: 분석 데이터 액세스, 감사 기록 내보내기 및 후속 시스템에서의 데이터 처리
사용자 그룹별로 ChatGPT 데스크톱 앱, Codex CLI, IDE 확장 프로그램의 정책 적용 대상 로컬 기능과 Codex Cloud 중 무엇이 필요한지 결정하세요. 여러 환경을 함께 사용할 수도 있습니다. API 키 인증을 사용하는 워크플로우에서는 Platform API 액세스를 조직 및 프로젝트 단위로 별도 관리하세요.
2단계: 워크스페이스 액세스 및 ID 구성
ChatGPT 워크스페이스의 멤버십, 시트, 그룹, 지원되는 역할 기반 접근 제어(RBAC) 권한을 사용해 대상 사용자가 지원되는 워크스페이스 기능을 사용할 수 있도록 하세요. 모든 환경에 같은 역할이 적용된다고 가정하지 말고, 최신 워크스페이스 지침에 따라 로컬 클라이언트와 Codex Cloud의 액세스 권한을 각각 확인하세요. 기본 제공 관리자 역할은 워크스페이스를 관리하는 사람에게만 부여하세요.
워크스페이스의 제어 항목과 표시 이름은 변경될 수 있습니다. 최신 절차는 다음 문서에서 확인하세요.
부여하려는 권한을 가진 멤버 계정으로 로그인과 기능 액세스를 테스트하세요. 워크스페이스 액세스만으로는 연결된 서비스에서 리포지터리나 파일에 접근하거나 작업을 수행할 권한이 부여되지 않습니다.
Work Cloud에서 로컬 컴퓨터 액세스 설정
Work 또는 dot의 로컬 컴퓨터 액세스를 도입하려면 먼저 에이전트 보안에서 정책을 검토하세요. 정책 마이그레이션과 기능 액세스 설정은 별개입니다. 액세스를 활성화하는 확인 절차에서 정책을 만들 필요는 없습니다. 관리형 정책을 사용하면 지원되는 전역 정책이 클라우드 오케스트레이션에 적용됩니다. 연결된 컴퓨터에는 로컬 실행 요구 사항과 기기 제어 설정이 적용됩니다. Work 클라우드 컨테이너와 dot 클라우드 컴퓨터는 각각 자체 실행 구성과 요구 사항을 사용합니다. 각 기능의 설정 방법과 사용 조건은 Work Cloud 및 dot의 로컬 컴퓨터 액세스를 참고하세요.
전역 설정은 정책 API에서 관리하세요. 로컬 또는 Codex Cloud 설정은 에이전트 보안 UI에서 관리하세요. 마이그레이션 후에도 기존 전역 API 워크플로우를 사용할 수 있습니다. 스크립트와 Terraform 연동을 테스트하고 정책 할당과 적용 순서가 그대로인지 확인하세요.
동기화를 활성화하기 전에 호환성을 확인하세요.
-
네트워크 정책. 환경별로 정책을 재정의하는 경우 네트워크 정책의 우선순위와 런타임 제한이 어떻게 적용되는지 테스트하세요. 특정 환경에서 허용한 연결에도 전역 제한이 계속 적용될 수 있습니다.
-
엔터프라이즈 훅. 도입하려는 워크플로우에 훅이 필요하다면 클라우드 오케스트레이션에서 어떤 핸들러가 실행되는지 확인하세요. 액세스를 활성화하기 전에 워크플로우에서 사용하는 이벤트와 처리해야 할 실패 상황을 테스트하세요. 감사 기록의 범위는 별도로 검토하세요.
-
데이터 요구 사항. Work Cloud의 로컬 컴퓨터 액세스는 엄격한 데이터 비보관을 보장하지 않습니다. 데이터 레지던시와 추론 레지던시는 적격 콘텐츠 및 지원되는 워크로드, 리전, 구성에만 적용됩니다. 엔터프라이즈 키 관리(EKM)는 적격 워크스페이스에 저장된 콘텐츠 중 지원 대상에만 적용됩니다. UAE 추론 레지던시에서는 Work를 지원하지 않습니다. 클라우드 정책 중 하나라도
enforce_residency가 활성화되어 있으면 Work와 dot 모두에서 로컬 컴퓨터 액세스 허용 설정이 비활성화됩니다. 이 보호 조치로 워크스페이스 레지던시가 구성되지는 않으며, 이 조치만으로 Work Cloud나 dot이 비활성화되지도 않습니다. 조직에 데이터 비보관(ZDR)이 필수라면 이 기능을 활성화하지 마세요.
워크스페이스 소유자는 대상 사용자 또는 그룹의 Work 권한을 검토하세요. Work Cloud를 활성화한 다음 로컬 컴퓨터 액세스 허용 설정을 켜세요. 지원되는 역할을 할당해 액세스 권한을 부여하세요. 역할 및 워크스페이스 권한을 참고하세요.
3단계: 로컬 런타임 요구 사항 구성
사용자가 ChatGPT 데스크톱 앱, Codex CLI 또는 IDE 확장 프로그램에서 지원되는 작업을 로컬로 실행하면 로컬 요구 사항에 따라 런타임 동작이 제한됩니다. 지원되는 클라우드, 기기 또는 시스템 채널을 통해 requirements.toml 파일을 배포하세요. 이 정책은 ChatGPT 워크스페이스 역할 및 그룹과 별도로 관리하세요.
새 배포 환경에서는 기존 샌드박스 모드의 제한을 기준으로 구성을 설계하는 대신, 지원되는 로컬 클라이언트에 권한 프로필을 사용하세요. 예를 들면 다음과 같습니다.
default_permissions = ":workspace"
[allowed_permission_profiles]
":read-only" = true
":workspace" = true지원되는 브라우저 및 데스크톱 기능 전반에서 컴퓨터 사용을 비활성화하려면 해당 기능에 관여하는 공개 기능 키를 모두 제한하세요.
[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 Cloud(레거시)의 기존 클라우드에서 Codex 사용 설정은 그대로 유지됩니다. 이미 클라우드를 활성화한 워크스페이스는 계속 액세스할 수 있으며, 클라우드가 꺼져 있던 워크스페이스에서는 관리자가 활성화할 때까지 꺼진 상태로 유지됩니다. 액세스에는 도입 범위와 워크스페이스 제한이 계속 적용됩니다.
각 관리 영역을 다음과 같이 계획하세요.
- 대상 사용자에게 클라우드에서 Codex 사용 권한을 부여하세요. 워크스페이스 공유 환경을 만들고 편집하는 사람에게는 워크스페이스 환경 관리 권한을 별도로 부여하세요. 워크스페이스 역할 지침을 참고하세요.
- 소스 시스템에서 지원하는 연동을 설치하고 구성하세요.
- 소스 시스템에서 각 사용자 그룹이 필요한 리포지터리에만 접근할 수 있도록 제한하세요.
- 해당 리포지터리의 클라우드 환경, 시크릿, 인터넷 액세스 및 클라우드에서 관리할 수 있는 요구 사항을 구성하세요.
- 코드 검토 등 선택적으로 사용할 호스팅 워크플로우를 구성하세요.
- 대상 그룹을 대표하는 멤버 계정으로 작업 액세스를 테스트하고, 지정된 관리자 계정으로 환경 관리를 테스트하세요. 각 계정의 워크스페이스, 환경 및 리포지터리 권한을 확인하세요.
클라우드 환경은 로컬 기기 정책, MDM 설정 또는 로컬 네트워크 액세스 권한을 상속하지 않습니다. 클라우드에서 관리할 수 있는 요구 사항은 사용자 컴퓨터에 설치된 요구 사항과 별도로 검토하세요. 연결 대상에 대한 액세스는 서비스에 연결을, 워크스페이스 요구 사항이 클라우드 환경을 제한하는 방식은 에이전트 보안을 참고하세요.
Codex Cloud에는 연결된 소스 시스템이 제공하는 리포지터리 권한과 보호 규칙이 적용됩니다. 워크스페이스 액세스로 이러한 제어를 우회할 수 없습니다. 설정 방법과 런타임 동작은 클라우드 환경을 참고하세요.
6단계: 플러그인 및 연결 기능 구성
플러그인 설치, 함께 제공되는 스킬, 커넥터 기반 기능, 커넥터 작업, 소스 시스템의 권한 부여 여부를 각각 검토하세요. 커넥터 기반 기능을 비활성화해도 플러그인이나 함께 제공되는 스킬이 반드시 제거되는 것은 아닙니다.
플러그인이나 스킬을 도입 범위에 포함하기 전에 다음을 확인하세요.
- 출처, 책임자, 대상 사용자 및 검토 일자를 확인하세요.
- 함께 제공되는 스킬, 커넥터, MCP 서버, 훅을 검토하고 각 기능에 필요한 데이터와 작업을 확인하세요.
- 민감하지 않은 데이터와 필요한 최소 권한으로 테스트하세요.
- 재검토 및 사용 종료 담당자를 기록하세요.
플러그인은 웹, 데스크톱, 모바일용 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 키와 기타 연동용 자격 증명을 조직의 시크릿 관리 시스템에 저장하세요.
- 승인된 사용자만 후속 시스템과 보존 데이터에 접근할 수 있도록 제한하세요.
- 내보낸 Compliance API 기록은 데이터 민감도와 조직의 보존 정책에 따라 보호하세요. 수집 및 삭제 워크플로우가 현행 API 명세에 맞게 동작하는지 테스트하세요.
8단계: 도입 결과 검증 및 유지 관리
시범 사용자에게 새 Work 작업을 시작하고 다른 기기에서 같은 작업을 이어가도록 요청하세요. 컴퓨터가 연결된 상태에서 허용되는 작업과 차단되는 작업을 하나씩 실행해 승인, 파일 시스템 액세스 및 네트워크 제한을 확인하세요. 컴퓨터 연결을 끊고 새 턴을 시작하세요. 클라우드 컨테이너가 로컬 파일에 접근할 수 없는지, 컨테이너 자체의 실행 요구 사항이 적용되는지 확인하세요.
실제로 적용된 설정과 각 테스트 결과를 기록하세요. 제한이 예상대로 작동하지 않으면 사용자가 해당 제한에 의존하기 전에 문제를 해결하세요. 동기화를 비활성화할 때는 문서에 명시된 동작을 확인하고 따르세요. 액세스 권한 회수, 작업 중단, 데이터 보존은 별개의 조치로 다루세요.
대상 사용자를 대표하는 계정으로 해당하는 모든 관리 영역을 검증하세요.
- ChatGPT 워크스페이스 멤버십, 시트 및 지원되는 역할 권한
- ChatGPT 데스크톱 앱, Codex CLI, IDE 확장 프로그램의 정책 적용 대상 로컬 기능과 각 클라이언트의 로그인 및 실제로 적용되는 런타임 요구 사항
- Codex Cloud 액세스, 환경 구성 및 리포지터리 권한
- API 키를 사용하는 워크플로우의 Platform API 조직 및 프로젝트 액세스
- 플러그인 설치, 함께 제공되는 스킬, 커넥터 액세스 및 지원되는 작업
- 연결된 시스템의 권한 부여 및 데이터 액세스
- 담당 관리자의 분석 데이터 및 규정 준수 기록 액세스
각 제어 항목의 담당자와 최신 절차를 확인할 수 있는 출처를 기록하세요. 이 기록이 있으면 UI나 정책이 변경될 때 관리 체계는 유지하면서 절차를 업데이트할 수 있습니다.
초기 도입 후에는 액세스 권한, 연결된 기능, 크레딧 사용량, 지원 과정에서 접수된 의견, 팀에서 실제로 사용하는 워크플로우를 검토하세요. 변화가 있으면 도입 범위와 관리자 지침을 조정하세요.
Work Cloud의 로컬 컴퓨터 액세스를 꺼야 하는 경우
로컬 컴퓨터 액세스 허용 설정을 끄면 실행 중인 턴이 중단된다는 점을 영향을 받는 사용자에게 알리세요. Work 액세스 권한이 유지되는 멤버는 기존 클라우드 대화에 새 메시지를 보내 로컬 파일 없이 작업을 이어갈 수 있습니다.