Compliance API 설정

Compliance API는 두 가지 키 유형을 사용하며, 어떤 키를 생성할지는 조직이 사용하는 Claude 제품에 따라 달라집니다. 기본 소유자와 조직 소유자는 claude.ai에서 Compliance Access Key를 생성하며, 이 키는 전체 Compliance API를 사용할 수 있게 합니다. 기본 소유자의 키는 상위 조직 아래의 모든 조직을 포괄할 수 있고, 조직 소유자의 키는 자신의 조직만 포괄합니다. 조직 관리자는 Claude Console에서 Admin API 키를 생성하며, 이 키는 Activity Feed만 사용할 수 있게 합니다.



어떤 키가 필요한가요?

Claude Enterprise 테넌트에는 하나의 상위 조직이 있으며, 이 조직은 그 아래의 모든 워크로드 조직에 대한 ID, SSO, SCIM을 중앙에서 관리합니다. 이러한 워크로드 조직은 상위 조직의 연결된 조직입니다.



Compliance API 설정

설정은 하나의 흐름으로 진행됩니다. 조직에 Compliance API를 활성화한 다음, claude.ai에서 Compliance Access Key를 생성하세요. Claude Console 조직은 활성화 후 대신 Admin API 키를 생성합니다. Admin API 키는 Activity Feed에만 접근할 수 있습니다.



Admin API 키 생성

Admin API 키 생성의 단계를 따른 다음, 키를 환경 변수로 설정하세요.

export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-...

별도의 변수 이름을 사용하면 두 키를 모두 프로비저닝할 때 Admin API 키가 Compliance Access Key를 덮어쓰지 않습니다. 이 가이드의 cURL 예제는 $ANTHROPIC_COMPLIANCE_ACCESS_KEY에서 키를 읽습니다. Admin API 키로 Activity Feed를 호출할 때는 $ANTHROPIC_ADMIN_KEY로 대체하세요.

Admin API 키는 키가 생성된 시점에 조직에 Compliance API가 활성화되어 있었던 경우에만 read:compliance_activities 범위를 가집니다. Compliance API 설정을 참조하세요. 다른 Compliance API 범위는 부여될 수 없으므로 Activity Feed 이외의 엔드포인트를 호출하면 403 Forbidden이 반환됩니다.

동일한 키가 Claude Console 조직 관리에서 수행하는 역할에 대해서는 Admin API를 참조하세요.



키의 범위 확인

이미 보유한 키의 범위를 확인하려면 다음 방법 중 하나를 사용하세요.

• 키 접두사. sk-ant-admin01-은 Admin API 키입니다(앞 섹션의 활성화 시점 조건에 따라 read:compliance_activities만 가짐). sk-ant-api01-은 Compliance Access Key이며, 해당 범위는 생성 시 선택한 하위 집합입니다.
• 설정 UI. claude.ai > Organization settings > API의 Keys 섹션 또는 Claude Console > Settings > Admin keys의 Admin keys 섹션을 열고 해당 키의 Scopes 열을 확인하세요.
• 오류 응답. 키의 범위를 초과하는 호출은 Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>] 형식의 메시지와 함께 403을 반환합니다. 전체 오류 목록은 Compliance API 오류 처리를 참조하세요.

{
  "error": {
    "type": "permission_error",
    "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
  }
}



키 관리 및 교체

Compliance Access Key는 생성한 것과 동일한 Keys 테이블에서 삭제하세요. claude.ai > Organization settings > API로 이동하세요. Admin API 키는 Claude Console > Settings > Admin keys에서 삭제하세요.

키 삭제는 다음 요청부터 적용되며 유예 기간은 없습니다. Compliance Access Key는 자체적으로 만료되지 않습니다.

중단 없이 키를 교체하려면 다음을 수행하세요.

1. 동일한 범위로 새 키를 생성하세요.
2. 통합이 새 키를 사용하도록 업데이트하세요.
3. 통합이 새 키로 성공하는지 확인하세요.
4. 이전 키를 삭제하세요.

교체 전에 저장된 페이지네이션 커서는 유효하게 유지됩니다. 커서는 키가 아닌 조직에 범위가 지정됩니다.

Compliance Access Key가 유출된 경우 즉시 삭제하고, 손상된 키에 의한 compliance_api_accessed 활동에 대해 Activity Feed를 감사하고, 유출된 키가 접근할 수 있었던 모든 다운스트림 자격 증명을 교체하세요. activity_types[]=compliance_api_accessed를 전달하여 쿼리 범위를 지정한 다음, 클라이언트에서 actor.type이 api_actor이고 actor.api_key_id가 손상된 키와 일치하는 활동을 필터링하세요. actor 스키마는 Activity 객체 이해하기를 참조하세요.



다음 단계