관리자 키를 사용하면 권한이 있는 워크스페이스 소유자와 관리자가 도구 및 서비스를 지원되는 ChatGPT 및 Codex 관리 API에 연결할 수 있습니다. 선택한 워크스페이스와 권한에 따라 키를 분석, 사용자 및 그룹 관리, 초대, 사용량 한도, 컴플라이언스 및 활동 로그 또는 서비스 계정 관리에 사용할 수 있습니다.
각 관리자 키는 하나의 ChatGPT 워크스페이스에 적용됩니다. 다른 워크스페이스, 테넌트 전체 관리, API 플랫폼 조직, 광고 계정, 모델 또는 모델 추론에 대한 액세스 권한은 부여되지 않습니다.
테넌트 또는 워크스페이스 선택에 관한 도움말은 관리자 콘솔에서 테넌트 관리를 참조하세요.
워크스페이스 사용 가능 여부 및 액세스 확인
관리자 키는 ChatGPT Enterprise, ChatGPT Edu, 의료 서비스용 ChatGPT 워크스페이스를 비롯해 사용 요건을 충족하는 관리형 ChatGPT 워크스페이스에서 제공됩니다. 관리하려는 특정 워크스페이스에서 소유자 또는 관리자 역할이 있어야 합니다.
액세스 권한은 선택한 ChatGPT 워크스페이스에서 할당된 소유자 또는 관리자 역할에 따라 달라집니다. 글로벌 관리자, API 플랫폼 조직 소유자 또는 사용자 지정 워크스페이스 역할이 있다는 이유만으로 관리자 키 액세스 권한이 부여되지는 않습니다.
기본 제공 워크스페이스 역할에 관한 자세한 내용은 멤버, 워크스페이스 역할 및 라이선스 관리를 참조하세요.
역할별 액세스 이해
워크스페이스 소유자는 모두, 읽기 전용 또는 사용자 지정 권한이 있는 키를 생성할 수 있습니다. 소유자는 워크스페이스의 모든 관리자 키를 수정하거나 취소할 수 있습니다.
워크스페이스 관리자는 각 권한 카테고리에서 사용 가능한 액세스 수준을 선택해 범위가 사용자 지정된 키를 생성합니다. 생성된 키에는 사용자 지정이라는 라벨이 표시됩니다. 관리자는 자신이 생성한 키만 수정하거나 취소할 수 있으며, 키의 권한을 현재 역할에서 사용할 수 있어야 합니다.
선택한 워크스페이스에서 소유자 또는 관리자 역할이 없는 글로벌 관리자는 해당 워크스페이스의 관리자 키를 생성하거나 관리할 수 없습니다.
관리자 키 권한 선택
소유자 권한 프리셋
워크스페이스 소유자는 다음 권한 프리셋 중 하나를 선택할 수 있습니다.
모두를 선택하면 선택한 워크스페이스에서 사용할 수 있는 관리자 권한이 부여되며, 가능한 경우 소유자 전용 권한도 포함됩니다.
읽기 전용을 선택하면 선택한 워크스페이스에서 사용할 수 있는 읽기 전용 권한이 부여됩니다.
사용자 지정을 선택하면 각 권한 카테고리에서 사용할 수 있는 액세스 수준을 선택할 수 있습니다.
카테고리별 관리자 권한
워크스페이스 관리자에게는 모두, 읽기 전용, 사용자 지정 프리셋 선택기가 표시되지 않습니다. 관리자는 권한에서 사용 가능한 각 카테고리에 대해 없음, 읽기, 쓰기 중 하나를 선택합니다. 생성된 키에는 사용자 지정이라는 라벨이 표시됩니다.
워크스페이스에 따라 앱, 사용량 한도, 그룹 관리, 사용자, 초대, Codex 분석 API, 엔터프라이즈 분석 API, 워크스페이스 분석, 비용, 서비스 계정 등의 카테고리를 사용할 수 있습니다. 일부 카테고리는 읽기 또는 쓰기만 지원하며, 관련 기능을 사용할 수 있을 때만 표시되는 카테고리도 있습니다.
일반적인 권한 매핑은 다음과 같습니다.
Codex 분석 API > 읽기:
codex.enterprise.analytics.read.사용량 한도 > 읽기:
chatgpt.enterprise.usage_limit.read.사용량 한도 > 쓰기:
chatgpt.enterprise.usage_limit.write및chatgpt.enterprise.usage_limit.read.사용자 > 읽기: 사용 가능한 경우
chatgpt.enterprise.user.read.
지원되는 경우 광범위한 컴플라이언스 권한, 대화 메시지, 역할 및 권한은 워크스페이스 소유자만 사용할 수 있습니다. 워크스페이스 관리자는 감사 또는 인증 로그와 같은 개별 활동 로그 카테고리를 선택할 수 있습니다.
그룹 관리 권한
사용 가능한 ChatGPT 워크스페이스에서 Groups Admin API를 통해 그룹을 생성, 업데이트 또는 삭제하려면 해당 워크스페이스의 관리자 키를 사용하세요.
키 권한을 선택할 때 그룹 관리를 검토하고 엔드포인트에 필요한 권한을 부여하세요. 읽기 전용 키로는 그룹을 변경할 수 없습니다.
그룹 관리자로 지정된 것만으로는 관리자 키를 생성하거나 Groups Admin API를 사용할 권한이 부여되지 않습니다. 관리자 키는 워크스페이스 소유자와 관리자만 생성할 수 있으며, API 요청에는 필수 권한이 있는 키가 필요합니다.
위임된 그룹 관리에 관한 내용은 그룹 및 그룹 관리자 관리를 참조하세요.
엔드포인트 경로, 지원되는 작업, 요청 필드 및 필수 범위는 Admin API 참조 문서를 확인하세요. 동기화된 그룹은 ID 공급자의 SCIM 워크플로를 통해 관리하세요. 동기화에 관한 안내는 SCIM 프로비저닝 및 관리를 참조하세요.
관리자 키 생성
관리자 콘솔에 로그인합니다.
필요한 경우 테넌트를 선택한 다음 소유자 또는 관리자 역할이 있는 ChatGPT 워크스페이스를 선택합니다.
자격 증명을 연 다음 관리자 키를 선택합니다.
새 관리자 키 만들기를 선택하고 알아보기 쉬운 이름을 입력합니다.
만료 기간으로 없음, 30일, 60일, 90일 또는 사용자 지정을 선택합니다. 사용자 지정 만료 기간은 1~365일로 설정할 수 있습니다.
통합에 필요한 권한을 선택합니다. 워크스페이스 소유자는 모두, 읽기 전용 또는 사용자 지정을 선택할 수 있으며, 워크스페이스 관리자는 각 카테고리에서 사용 가능한 권한을 선택합니다.
제출을 선택한 다음 비밀 값을 복사하여 안전하게 보관합니다. 비밀 값은 다시 확인할 수 없습니다.
워크스페이스 소유자 키의 기본 권한은 모두로, 기본 만료 설정은 없음으로 지정될 수 있습니다. 키를 만들기 전에 두 설정을 모두 검토하세요.
관리자 키 검토, 수정 또는 취소
관리자 콘솔에서 ChatGPT 워크스페이스를 연 다음 자격 증명 > 관리자 키로 이동합니다. 각 키의 이름, 상태, 추적 ID, 마스킹된 비밀 값, 생성자, 권한, 마지막 사용일 및 만료일을 검토합니다.
키 이름이나 권한을 변경하려면 더보기 메뉴(•••)를 열고 수정을 선택한 다음 변경 사항을 적용하고 변경 사항 저장을 선택합니다.
키 사용을 중단하려면 더보기 메뉴(•••)를 열고 취소를 선택한 다음 관리자 키 취소를 눌러 확인합니다.
워크스페이스 소유자는 선택한 워크스페이스의 모든 키를 수정하거나 취소할 수 있습니다. 워크스페이스 관리자는 자신이 생성한 키만 수정하거나 취소할 수 있으며, 키의 권한을 현재 역할에서 사용할 수 있어야 합니다. 소유자 전용 권한이 있는 키는 워크스페이스 소유자에게 관리를 요청하세요. 기존 만료일은 변경할 수 없습니다.
취소된 키는 변경 사항이 적용된 후 작동을 멈춥니다. 사용 중인 키를 취소하기 전에 대체 키를 만들고 영향을 받는 모든 통합을 업데이트하세요.
컴플라이언스 및 민감한 데이터 이해
일부 관리자 키 권한으로 인해 민감한 워크스페이스 활동이나 콘텐츠가 노출될 수 있습니다. 광범위한 컴플라이언스 액세스 권한 또는 대화 메시지 액세스 권한은 워크스페이스 소유자만 부여할 수 있습니다.
워크스페이스 관리자는 감사, 인증 또는 앱 로그를 비롯해 지원되는 개별 로그 카테고리에 대한 액세스 권한을 부여할 수 있습니다. 개별 로그에도 민감한 정보가 포함될 수 있으므로 각 카테고리를 신중하게 검토하세요.
컴플라이언스 API 및 데이터 액세스에 관한 자세한 내용은 엔터프라이즈 및 교육 고객용 OpenAI 컴플라이언스 플랫폼을 참조하세요.
ChatGPT 워크스페이스 Admin API 요청은 https://api.chatgpt.com/v1을 사용합니다. 예를 들어 현재 워크스페이스 멤버를 나열하려면 /manage/workspaces/{workspace_id}/users를 사용하세요. /v1/organization/ 아래의 엔드포인트는 API 플랫폼 조직을 관리하며 API 플랫폼 조직 관리자 키가 필요합니다.
엔드포인트 경로, 요청 및 응답 스키마, 필수 범위는 Admin API 참조 문서를 확인하세요.
관리자 키와 다른 자격 증명 구분
워크스페이스 관리자 키는 하나의 ChatGPT 워크스페이스에서 지원되는 ChatGPT 및 Codex 관리 API를 인증합니다. 모델 추론에 대한 액세스 권한은 부여되지 않습니다.
Codex 서비스 계정 액세스 토큰은 Codex 자동화를 위한 비사용자 워크스페이스 ID를 인증합니다. Admin API 요청을 인증하지는 않습니다. 설정 방법은 Codex 서비스 계정 생성 및 관리를 참조하세요.
API 플랫폼 조직 관리자 키는 API 플랫폼에서 별도로 관리되며 ChatGPT 워크스페이스를 관리하지 않습니다.
API 플랫폼 조직용 키가 필요하면 API 플랫폼 조직 관리자 키를 여세요. 워크스페이스 관리자 키는 워크스페이스 전용 ChatGPT Admin API 엔드포인트에 사용하세요. API 플랫폼 조직 엔드포인트에는 별도의 자격 증명이 필요합니다.
액세스 및 누락된 권한 문제 해결
올바른 OpenAI 계정으로 로그인했고 원하는 테넌트와 ChatGPT 워크스페이스를 선택했는지 확인하세요.
워크스페이스 멤버십이 활성 상태이고 워크스페이스 역할이 소유자 또는 관리자인지 확인하세요.
ChatGPT 워크스페이스에서 관리자 키를 사용할 수 있는지 확인하세요. 사용 가능 여부는 요금제와 출시 단계에 따라 달라질 수 있습니다.
권한 카테고리가 표시되지 않으면 선택한 워크스페이스에서 해당 기능을 사용할 수 있고 본인의 역할에 액세스 권한이 있는지 확인하세요. 필요한 카테고리를 여전히 사용할 수 없다면 관련 없는 권한을 선택하지 말고 OpenAI 지원팀에 문의하세요.
키를 수정하거나 취소할 수 없다면 본인이 키를 생성했는지, 키의 권한을 현재 역할에서 사용할 수 있는지 확인하세요. 소유자 전용 권한이 있는 키는 워크스페이스 소유자에게 관리를 요청하세요.
이전에 작동하던 키가 작동하지 않으면 상태와 만료를 확인하고, 키가 만료되거나 취소되지 않았는지 확인한 다음 키 생성자가 필수 권한이 있는 활성 워크스페이스 역할을 계속 보유하고 있는지 확인하세요.
문제가 계속되면 OpenAI 지원팀에 문의하세요. 요청받은 경우 테넌트 ID, 워크스페이스 이름 또는 ID와 스크린샷을 포함하되 관리자 키의 비밀 값은 절대 공유하지 마세요.
관리자 키 보호
사용자 지정 권한을 선택하고 통합에 필요한 액세스 권한만 부여하세요.
가능하면 만료 기간을 설정하세요. 없음은 키에 예정된 만료일이 없다는 의미입니다. 키가 취소되거나, 생성자가 필요한 워크스페이스 액세스 권한을 잃거나, 생성자의 계정이 비활성화된 경우에도 키가 작동을 멈출 수 있습니다.
통합 또는 워크플로마다 별도의 키를 사용하세요.
비밀 값은 안전한 비밀 관리자에 저장하세요. 이메일, 채팅 또는 지원 요청을 통해 절대 전송하지 마세요.
사용량과 만료일을 정기적으로 검토하고 더 이상 필요하지 않은 키는 취소하세요.