감사 가능한 기록이 필요한 보안, 법무, 거버넌스 및 조사 워크플로우에는 Compliance API를 사용하세요. 도입 현황과 추세를 파악할 때는 컴플라이언스 기록 대신 분석 데이터를 사용하세요.
현재 액세스 요건, 지원되는 이벤트 범위, API 경로, 스키마, 필터, 데이터 보존 및 요청 처리 방식은 관리자 API 레퍼런스를 기준으로 확인하세요.
사용 가능한 컴플라이언스 기능과 일반적인 통합 방식은 컴플라이언스 플랫폼 가이드를 참고하세요.
Compliance API를 사용해야 하는 경우
다음과 같은 작업에는 Compliance API가 적합합니다.
- 지원되는 기록을 감사 또는 조사 시스템으로 내보내기
- 조직의 데이터 보존 절차와 법적 보존 조치 적용하기
- Codex 활동과 다른 보안 또는 ID 데이터 간의 연관성 분석하기
- 승인된 보안, 법무 또는 거버넌스 조사 지원하기
Compliance API는 생산성을 측정하는 대시보드가 아닙니다. 이 API의 기록으로 코드 품질이나 개인의 성과를 판단하지 마세요. 도입 현황을 보고할 때는 워크스페이스 분석이나 Analytics API를 사용하세요.
시작하기
- 관리자 API 레퍼런스를 열고 현재 관리자 역할로 필요한 컴플라이언스 리소스에 액세스할 수 있는지 확인하세요.
- 로그를 지속적으로 수집하려면 새 항목만 추가할 수 있는 컴플라이언스 로그 스트림을 사용하세요. 현재 지원되는 리소스와 조회 방식은 API 레퍼런스에서 확인하세요.
- 로그 파일을 다운로드한 후 비프로덕션 환경의 보안 정보 및 이벤트 관리(SIEM) 시스템이나 데이터 레이크로 파일을 수집할 수 있는지 테스트하세요.
- 로그를 지속적으로 수집하도록 일정을 설정하고, 내보낸 기록에 조직의 액세스 제어, 데이터 보존 및 법적 보존 조치를 적용하세요. 원본 기록의 보존 기간이 조직의 보존 정책을 대신한다고 가정하지 마세요.
예를 들어 보안팀은 변경할 수 없는 컴플라이언스 이벤트를 SIEM으로 스트리밍해 조사에 활용하거나, 승인된 전자 증거개시 워크플로우로 보낼 수 있습니다. 이 가이드에서 엔드포인트 명세를 복사하는 대신 API 레퍼런스에서 최신 경로와 스키마를 확인하세요.
로그 다운로드
Bash 스크립트 또는 PowerShell 스크립트를 다운로드하세요. 두 스크립트 모두 결과를 페이지별로 조회하여 지정한 타임스탬프 이후의 사용 가능한 로그 파일을 모두 나열하고 다운로드합니다. 결과는 JSONL 형식으로 표준 출력에 쓰고, 오류는 표준 오류로 출력합니다.
COMPLIANCE_API_KEY를 Enterprise Compliance API 키로 설정하세요. <workspace_or_org_id>를 ChatGPT 워크스페이스 ID 또는 API 플랫폼 조직 ID로 바꾸고, <after>를 시간대가 포함된 ISO 8601 타임스탬프로 바꾸세요. 다음 예제에서는 AUTH_LOG 파일을 한 번에 100개씩 가져옵니다.
macOS 또는 Linux에서는 Bash, curl, jq를 설치한 후 다음 명령어를 실행하세요.
bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonlWindows용 스크립트는 PowerShell 5.1 이상을 지원합니다. 다운로드한 파일을 검토하세요. Windows에서 파일을 차단했고 조직의 실행 정책이 차단 해제를 허용한다면 Unblock-File -Path .\download_compliance_files.ps1을 실행하세요. 다음 예제에서는 PowerShell 7을 사용해 바이트 순서 표시 없이 UTF-8로 저장합니다.
.\download_compliance_files.ps1 "<workspace_or_org_id>" AUTH_LOG 100 "<after>" |
Set-Content -Encoding utf8NoBOM output.jsonlWork 클라우드에서 로컬 컴퓨터에 액세스할 때의 감사 기록
Work 클라우드에서 로컬 컴퓨터에 액세스할 때도 Compliance API의 지원 범위는 Work 클라우드와 같습니다. 기록은 conversation_message와 codex_log 이벤트 유형으로 표시됩니다. 로컬에서 실행하면 OpenTelemetry(OTel) 이벤트도 생성됩니다. OTel 수집기 엔드포인트를 구성하면 이 이벤트를 수집할 수 있습니다. 로컬 이벤트는 Compliance API 기록과 별도로 수집하세요. 이 두 출처의 기록만으로는 로컬에서 실행한 모든 명령어, 파일 작업, 스크린샷, 승인 및 외부 작업을 빠짐없이 확인할 수 없습니다.
기록 수집을 설정할 때는 다음 단계를 따르세요.
-
지원되는 Work 기록을 수집하려면
conversation_message와codex_log를 사용하세요. 각 이벤트 유형의 스키마, 작업 식별자, 타임스탬프는 API 레퍼런스에서 확인하세요. -
해당 워크플로우에서 기록이 어떻게 보존되고 삭제되는지 확인하세요.
-
대표적인 작업을 실행한 후 내보낸 기록을 실제로 수행한 작업과 비교하세요.
정책 자동화. 전역 설정은 정책 API로 관리하세요. 로컬 및 Codex Cloud 설정은 에이전트 보안 UI에서 관리하세요. 마이그레이션 후에도 전역 설정에 사용하던 API 워크플로우를 계속 사용할 수 있습니다. 스크립트와 Terraform 통합을 테스트하고 정책 할당과 적용 순서가 그대로인지 확인하세요. 정책 자동화는 감사 기록 조회와 별도로 검토하세요. 정책 API 지원 여부는 Compliance API가 제공하는 이벤트 범위에 영향을 주지 않습니다.
훅 기반 감사. 워크스페이스에서 이 기능이 활성화되어 있다면, 지원되는 수명 주기 이벤트와 도구 이벤트에 관리자가 정의한 MCP 훅을 사용하세요. 이 훅은 클라우드 코디네이터(오케스트레이터)에서 실행됩니다. 기존 감사 워크플로우를 교체하기 전에 콜백 연결, 기록되는 이벤트 범위, 실패 시 동작을 테스트하세요. 훅이 생성한 기록은 Compliance API의 이벤트 지원 범위와 별도로 확인하세요.
관리 범위 확인
컴플라이언스 적용 범위는 ChatGPT 워크스페이스와 최신 API 레퍼런스에 명시된 제품을 기준으로 정해집니다. API 플랫폼의 조직 데이터에는 별도의 API 데이터 제어 및 관리 체계가 적용됩니다.
현재 API 경로, 지원되는 이벤트 범위, 스키마, 필터, 데이터 보존 방식, 권한 요건 및 요청 처리 방식은 API 레퍼런스에 정의되어 있습니다. 이 페이지에서는 해당 명세를 중복해서 다루지 않습니다.