Compliance API 설정

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



어떤 키가 필요한가요?

Claude Enterprise 테넌트에는 하위의 모든 워크로드 조직에 대한 ID, SSO 및 SCIM을 중앙 집중화하는 하나의 상위 조직이 있습니다. 이러한 워크로드 조직은 상위 조직의 연결된 조직입니다.



Compliance API 설정

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



Admin API 키 생성

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

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

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

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

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



키의 범위 확인

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

• 키 접두사. sk-ant-admin01-은 Admin API 키입니다(앞 섹션의 활성화 시점 조건에 따라 read:compliance_activities만 가집니다). sk-ant-api01-은 Compliance Access Key이며, 해당 범위는 생성 시 선택한 하위 집합입니다.
• 설정 UI. claude.ai > 조직 설정 > API의 Keys 섹션 또는 Claude Console > 설정 > Admin 키의 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 > 조직 설정 > API로 이동하세요. Admin API 키는 Claude Console > 설정 > Admin 키에서 삭제하세요.

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

중단 없이 키를 교체하려면:

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

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

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



다음 단계