--- title: Compliance API 설정하기 url: https://platform.claude.com/docs/ko/manage-claude/compliance-api-access description: 조직에 Compliance API를 활성화한 다음, Compliance Access Key(범위가 지정된 권한 포함) 또는 Admin API 키를 생성하고, 어떤 키를 사용해야 하는지 알아보세요. --- Claude Enterprise 조직 및 자격을 갖춘 독립형 Claude Console 조직은 Compliance API에 셀프 서비스로 액세스할 수 있습니다. 이 페이지에서는 조직에 Compliance API를 활성화하고 API 키를 생성하는 방법을 설명합니다. **필요한 역할:** 조직 관리자(Claude Console), 또는 기본 소유자나 조직 소유자(claude.ai). Compliance API는 두 가지 키 유형을 사용하며, 어떤 키를 생성할지는 조직이 사용하는 Claude 제품에 따라 달라집니다. 기본 소유자와 조직 소유자는 claude.ai에서 Compliance Access Key를 생성하며, 이 키는 전체 Compliance API를 사용할 수 있게 합니다. 기본 소유자의 키는 상위 조직 아래의 모든 조직을 포괄할 수 있고, 조직 소유자의 키는 자신의 조직만 포괄합니다. 조직 관리자는 Claude Console에서 Admin API 키를 생성하며, 이 키는 [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)만 사용할 수 있게 합니다. ## 어떤 키가 필요한가요? | 키 유형 | 생성 위치 | 용도 | Compliance API와 함께 작동하나요? | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------- | | **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, 채팅, 파일, 프로젝트, 세션(Cowork 및 Claude Code 같은 앱 내), 사용자, 조직 메타데이터, 조직 설정 | 예(모든 엔드포인트) | | **Admin API 키** (`sk-ant-admin01-...`) | Claude Console의 [Admin keys](https://platform.claude.com/settings/admin-keys) 페이지(`platform.claude.com/settings/admin-keys`) | [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api) 및 Compliance API Activity Feed | Activity Feed만 | | **Analytics API 키** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Claude Enterprise Analytics API([Analytics API](https://platform.claude.com/docs/ko/manage-claude/analytics-api) 참조) | 아니요 | | **Claude API 키** (`sk-ant-api03-...`) | Claude Console의 [API keys](https://platform.claude.com/settings/keys) 페이지(`platform.claude.com/settings/keys`) | [Claude API](https://platform.claude.com/docs/ko/api/overview)를 통한 Claude 모델 호출 | 아니요 | Claude Enterprise 테넌트에는 하나의 **상위 조직(parent organization)**이 있으며, 이 조직은 그 아래의 모든 워크로드 조직에 대한 ID, SSO, SCIM을 중앙에서 관리합니다. 이러한 워크로드 조직이 상위 조직의 **연결된 조직(linked organizations)**입니다. **Claude Enterprise 상위 조직은 Claude Console(`platform.claude.com`)에 표시되지 않습니다.** 상위 조직에는 워크로드, Claude API 키, Admin API 키가 없습니다. Compliance Access Key는 Claude Console이 아닌 claude.ai **Organization settings**에서 생성하세요. ## Compliance API 설정하기 설정은 하나의 흐름으로 이루어집니다. 조직에 Compliance API를 활성화한 다음 claude.ai에서 Compliance Access Key를 생성합니다. Claude Console 조직은 대신 활성화 후 [Admin API 키를 생성](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access#create-an-admin-api-key)하며, Admin API 키는 [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)에만 접근할 수 있습니다. `read:compliance_user_data`가 있는 Compliance Access Key는 기본 소유자가 본 적 없는 콘텐츠를 포함하여 모든 연결된 조직의 모든 채팅, 파일, 프로젝트, 세션 트랜스크립트를 읽을 수 있습니다. `delete:compliance_user_data`가 있는 키는 채팅, 파일, 프로젝트를 영구적으로 삭제할 수 있습니다. Compliance Access Key를 프로덕션 데이터베이스 자격 증명처럼 취급하세요. 시크릿 관리자에 저장하고, 소스 제어나 SIEM 포워더 구성에는 절대 저장하지 마세요. Compliance API를 활성화하는 위치는 조직이 어떻게 설정되어 있는지에 따라 다릅니다. * **Claude Enterprise 조직:** 기본 소유자가 [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)에서 Compliance API를 활성화합니다. 활성화는 상위 조직 수준에서 이루어지며 claude.ai와 Claude Console 모두의 모든 연결된 조직에 전파됩니다. * **독립형 Claude Console 조직:** 조직 관리자가 Claude Console의 [Compliance](https://platform.claude.com/settings/security) 페이지(`platform.claude.com/settings/security`)에서 **Compliance API** 토글을 켭니다. 자격을 갖춘 조직은 셀프 서비스로 활성화할 수 있으며, 변경 사항은 즉시 적용됩니다. 해당 페이지에 페이지를 찾을 수 없다는 오류가 표시되거나 **Compliance API** 섹션이 표시되지 않는 경우, 관리자 역할이 없거나, 조직이 상위 조직에 연결되어 있거나(이 경우 Compliance API는 상위 조직에서 활성화됨), 조직이 셀프 서비스 활성화 자격을 갖추지 못한 것입니다. 어느 경우에 해당하는지 확실하지 않다면 계정 팀이나 [Anthropic 지원팀](https://support.claude.com)에 문의하세요. * **상위 조직에 연결된 Claude Console 조직:** Claude Console에서 켤 것이 없습니다. 상위 조직의 기본 소유자에게 claude.ai에서 Compliance API를 활성화해 달라고 요청하거나, 계정 팀에 문의하세요. **Compliance API를 끄면 활동 기록이 중지됩니다.** 조직 관리자는 Compliance API를 켜는 것과 동일한 **Compliance API** 토글로 언제든지 Compliance API를 끌 수 있습니다. Compliance API가 꺼져 있는 동안에는 조직의 활동 이벤트가 기록되지 않으므로 [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)는 새 이벤트를 받지 않습니다. 조직이 [Access Transparency](https://platform.claude.com/docs/ko/manage-claude/access-transparency)에 등록되어 있다면, Compliance API를 끄면 Access Transparency 이벤트 전달도 중지됩니다. Compliance API가 꺼져 있는 동안 기록되지 않은 활동은 나중에 복구할 수 없습니다. Compliance API를 다시 켜면 그 시점부터 기록이 재개되며, 이미 기록된 활동은 삭제되지 않습니다. Claude Enterprise 조직의 경우, claude.ai의 Compliance API 설정은 [로컬 세션](https://platform.claude.com/docs/ko/manage-claude/compliance-sessions#retrieve-local-sessions)(사용자 기기의 세션)에 대한 트랜스크립트 캡처도 제어합니다. 캡처는 Compliance API가 활성화되면 시작되고 꺼져 있는 동안 중지되며, 꺼져 있는 동안 실행된 세션의 트랜스크립트 콘텐츠는 캡처되지 않고 나중에 복구할 수 없습니다. 독립형 Claude Console 조직은 Compliance Access Key 대신 Admin API 키를 사용합니다. 활성화 후 나머지 단계를 건너뛰고 대신 [새 Admin API 키를 생성](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access#create-an-admin-api-key)하세요. 나머지 단계는 Compliance Access Key를 프로비저닝하며, 이는 Claude Enterprise 테넌트에 속한 조직에서만 사용할 수 있습니다. 키의 액세스 권한은 생성 시 설정됩니다. 키가 어떤 조직을 포괄할지 결정하세요. * **상위 조직**용 키는 상위 조직 아래의 모든 조직에 액세스할 수 있습니다. * **단일 조직**용 키는 해당 조직에만 액세스할 수 있습니다. claude.ai에 로그인하세요. 상위 조직의 기본 소유자는 두 범위 중 어느 것으로든 키를 생성할 수 있습니다. 조직 소유자는 자신의 조직으로만 제한된 키를 생성할 수 있습니다. 다음 단계에서 설명하는 **API** 페이지가 보이지 않거나 키를 생성할 때 컴플라이언스 범위를 사용할 수 없다면, 역할이 Compliance Access Key를 생성할 수 없거나 조직에 Compliance API가 아직 활성화되지 않은 것입니다(첫 번째 단계로 돌아가세요). [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)로 이동하여 **Keys** 섹션을 찾으세요. **Create key**를 클릭하고, 키 이름을 지정한 다음, 아래 표에서 하나 이상의 범위를 선택하세요. **Create**를 클릭하세요. | 범위 | 부여 권한 | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `read:compliance_activities` | Activity Feed 읽기. 상위 조직을 포괄하는 키는 상위 조직 및 모든 연결된 조직의 이벤트를 읽습니다. | | `read:compliance_user_data` | 사용자 채팅, 메시지, 파일, 프로젝트, 세션 메타데이터 및 트랜스크립트, 조직 사용자, 사용자 기본 설정, 그룹 구성원 읽기 | | `delete:compliance_user_data` | 사용자 채팅, 파일, 프로젝트 삭제 | | `read:compliance_org_data` | 조직 메타데이터(이름, 유형, 역할, 그룹) 및 상위 조직 아래 조직에 적용 중인 유효 설정 읽기. 사용자 목록 및 그룹 구성원 정보에는 `read:compliance_user_data`가 필요합니다. | Plugins API를 사용하면 `read:compliance_org_data`로 Admin API를 통해 구성원의 개인 플러그인과 해당 파일을 포함한 조직의 플러그인 및 플러그인 마켓플레이스 인벤토리도 읽을 수 있습니다. 이 인벤토리는 구성원을 식별합니다. 플러그인을 소유하거나 생성한 구성원, 또는 플러그인이 개별적으로 공유된 구성원의 사용자 ID와, 플러그인 생성자가 아직 구성원인 경우 그 이메일 주소를 포함합니다. [플러그인 및 플러그인 마켓플레이스 읽기](https://platform.claude.com/docs/ko/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces)를 참조하세요. 통합에 필요한 최소한의 범위 집합을 선택하세요. * Activity Feed만 읽는 감사 파이프라인에는 `read:compliance_activities`만 필요합니다. * 채팅과 파일을 읽지만 삭제하지 않는 eDiscovery 도구에는 `delete:compliance_user_data`가 필요하지 않습니다. * 워크플로가 읽기와 삭제를 모두 수행한다면, 유출된 읽기 키로 데이터를 삭제할 수 없도록 별도의 범위를 가진 **두 개의 키**를 사용하세요. Compliance Access Key 범위는 생성 후 변경할 수 없습니다. 범위를 변경하려면 원하는 범위로 새 키를 생성한 다음 이전 키를 삭제하세요. 표시된 시크릿 키(`sk-ant-api01-`로 시작)를 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다. 이 가이드의 셸 샘플이 읽을 수 있도록 키를 환경 변수로 설정하세요. ```bash export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-... ``` ## Admin API 키 생성하기 Admin API 키로 Activity Feed를 호출하려면 먼저 Compliance API가 [Claude Console 조직에 활성화](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access#set-up-the-compliance-api)되어 있어야 합니다. [Admin API 키 생성하기](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization)의 단계를 따른 다음, 키를 환경 변수로 설정하세요. ```bash export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-... ``` 별도의 변수 이름을 사용하면 두 키를 모두 프로비저닝하는 경우 Admin API 키가 Compliance Access Key를 덮어쓰지 않습니다. 이 가이드의 cURL 예제는 `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`에서 키를 읽습니다. Admin API 키로 [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)를 호출할 때는 `$ANTHROPIC_ADMIN_KEY`로 대체하세요. Admin API 키는 키가 생성된 시점에 조직에 Compliance API가 활성화되어 있었던 경우에만 `read:compliance_activities` 범위를 가집니다. [Compliance API 설정하기](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access#set-up-the-compliance-api)를 참조하세요. 다른 Compliance API 범위는 부여할 수 없으므로, Activity Feed 이외의 엔드포인트를 호출하면 [403 Forbidden](https://platform.claude.com/docs/ko/manage-claude/compliance-errors#403-forbidden)이 반환됩니다. Claude Console 조직 관리에서 동일한 키의 역할에 대해서는 [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api)를 참조하세요. ## 키의 범위 확인하기 이미 가지고 있는 키의 범위를 확인하려면 다음 신호 중 하나를 사용하세요. * **키 접두사.** `sk-ant-admin01-`는 Admin API 키입니다(앞 섹션의 활성화 시점 조건에 따라 `read:compliance_activities`만 가짐). `sk-ant-api01-`는 Compliance Access Key이며, 범위는 생성 시 선택한 하위 집합입니다. * **설정 UI.** Compliance Access Key의 경우 [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)에서 **Keys** 섹션을 열고 해당 키의 **Scopes** 열을 확인하세요. Claude Console의 [Admin keys](https://platform.claude.com/settings/admin-keys) 페이지(`platform.claude.com/settings/admin-keys`)에 나열된 Admin API 키에는 선택 가능한 범위가 없습니다. * **오류 응답.** 키의 범위를 초과하는 호출은 `Missing required scopes. Got: [] Needed one of: []` 형식의 메시지와 함께 403을 반환합니다(삭제 엔드포인트에서는 `Needed: [...]`). 전체 오류 목록은 [Compliance API 오류 처리](https://platform.claude.com/docs/ko/manage-claude/compliance-errors#403-forbidden)를 참조하세요. ```json { "error": { "type": "permission_error", "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']" } } ``` ## 키 관리 및 교체 Compliance Access Key는 생성한 곳과 동일한 **Keys** 표에서 삭제합니다. [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)로 이동하세요. Admin API 키는 Claude Console의 [Admin keys](https://platform.claude.com/settings/admin-keys) 페이지(`platform.claude.com/settings/admin-keys`)에서 삭제합니다. 키 삭제는 다음 요청부터 적용되며, 유예 기간은 없습니다. Compliance Access Key는 자체적으로 만료되지 않습니다. 중단 없이 키를 교체하려면 다음과 같이 하세요. 1. 동일한 범위로 새 키를 생성합니다. 2. 새 키를 사용하도록 통합을 업데이트합니다. 3. 새 키로 통합이 성공하는지 확인합니다. 4. 이전 키를 삭제합니다. 교체 전에 저장된 페이지네이션 커서는 계속 유효합니다. 커서는 키가 아닌 조직에 범위가 지정되어 있습니다. Compliance Access Key가 유출되면 즉시 삭제하고, [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)에서 손상된 키에 의한 `compliance_api_accessed` 활동을 감사하고, 유출된 키가 접근할 수 있었던 모든 다운스트림 자격 증명을 교체하세요. 쿼리 범위를 지정하려면 `activity_types[]=compliance_api_accessed`를 전달한 다음, 클라이언트에서 `actor.type`이 `api_actor`이고 `actor.api_key_id`가 손상된 키와 일치하는 활동만 남기세요. actor 스키마는 [Activity 객체 이해하기](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed#understand-the-activity-object)를 참조하세요. ## 다음 단계 `read:compliance_activities`가 있는 모든 키로 조직 전체의 활동 이벤트를 읽으세요. `read:compliance_user_data`가 있는 Compliance Access Key를 사용하여 claude.ai 채팅, 파일, 프로젝트를 조회하고, `delete:compliance_user_data`로 삭제하세요. `read:compliance_user_data`가 있는 Compliance Access Key를 사용하여 Cowork 및 Claude Code 같은 Claude 앱과 에이전트에서 사용자가 실행하는 세션을 나열하고 트랜스크립트를 조회하세요.