OpenAI 연동하기

OpenAI API Platform 비용·사용량과 ChatGPT Workspace 사용자 할당·활동을 관리하기 위한 연동 가이드

OpenAI 연동은 서로 다른 두 관리 영역을 따로 연결합니다.

연동	심플리가 가져오는 정보	필요한 자격증명
API Platform (Admin)	API 조직, 구성원, 프로젝트, 비용, 토큰 사용량	API Platform 조직 Admin API Key
ChatGPT Workspace (Admin)	ChatGPT·Codex 사용자 할당과 활동 메타데이터	필요한 권한을 부여한 ChatGPT Workspace Admin API Key + Workspace ID

ChatGPT 워크스페이스와 API Platform 조직은 제품 권한이 서로 다릅니다. 한쪽 관리자 권한이나 API Key로 다른 쪽 정보를 읽을 수 없습니다.

API Platform (Admin) 연동

OpenAI Admin Console에 로그인합니다.
테넌트와 연동할 ChatGPT Workspace를 선택합니다.
Credentials → Admin keys → Create new admin key로 이동합니다.
Users → Read와 심플리에서 확인할 Compliance 로그 권한을 함께 선택합니다. 대화 활동을 보려면 Conversation messages, 활동 이력을 보려면 감사·인증 로그 읽기 권한이 필요합니다.
만료일을 정하고 키를 생성한 뒤 비밀값을 복사합니다. 전체 값은 다시 볼 수 없습니다.
선택한 Workspace의 ID도 복사합니다.

하나의 Admin API Key를 두 수집 작업이 함께 사용합니다. 사용자 할당과 활동 수집의 마지막 동기화 상태는 각각 기록하므로 한쪽 실패가 다른 쪽의 수집 이력을 덮어쓰지 않습니다.

사용자의 시트 종류가 바뀌면 이전 제품 할당은 종료된 것으로 표시하고 새 제품 할당을 추가합니다. 이후 원천에서 사용자가 사라져도 과거 할당 행은 삭제하지 않아 변경 이력을 보존합니다.

ChatGPT Workspace용 Admin API Key인지 확인하세요. API Platform 조직의 Admin API Key는 사용할 수 없습니다.
키에 Users → Read와 필요한 Compliance 로그 읽기 권한이 모두 있는지 확인하세요.
키를 만든 Workspace와 입력한 Workspace ID가 같은지 확인하세요.
키가 만료되거나 회수되지 않았는지 확인하세요.
키를 만든 계정이 해당 Workspace에서 여전히 Owner인지 확인하세요.

OpenAI Admin API의 변경 사항은 즉시 반영되지 않을 수 있습니다. 심플리는 동기화가 완전하게 끝난 응답만 반영하며, 중간 페이지 조회가 실패하면 기존 사용자를 종료된 것으로 바꾸지 않습니다.

Q: ChatGPT와 Codex를 같은 제품으로 보나요?

아니요. OpenAI가 사용자마다 seat_type을 chatgpt 또는 codex로 구분해 반환하므로, 심플리도 별도의 소프트웨어 제품과 사용자 할당으로 관리합니다.

Q: 여러 ChatGPT Workspace를 연결할 수 있나요?

현재는 고객사마다 하나만 연결할 수 있습니다. 다른 Workspace를 연결하려면 기존 연동을 해제한 뒤 다시 연결해야 합니다.

Q: 연동을 해제하면 이미 수집한 데이터도 삭제되나요?

아니요. 자격증명과 이후 동기화만 중단하며, 이미 수집한 관측 이력은 유지합니다.

Q: Compliance API Key를 따로 등록해야 하나요?

아니요. 필요한 권한을 부여한 ChatGPT Workspace Admin API Key 하나로 사용자 할당과 Compliance 활동을 함께 수집합니다.