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 액세스 요청

액세스를 요청하려면 Anthropic 담당자에게 문의하세요. 활성화는 상위 조직 수준에서 이루어지며 claude.ai와 Claude Console 모두의 모든 연결된 조직에 적용됩니다. 활성화 후 변경되는 사항은 조직이 사용하는 Claude 제품에 따라 다릅니다.

활성화 후: claude.ai 조직

Anthropic이 상위 조직에 대해 Compliance API를 활성화한 후, 기본 소유자는 claude.ai > Organization settings > API의 Keys 섹션에서 Compliance Access Key를 생성할 수 있습니다.

활성화 후: Claude Console 조직

Anthropic이 상위 조직에 대해 Compliance API를 활성화한 후, 그 이후에 생성된 Admin API 키는 read:compliance_activities 범위를 가집니다. 활성화 이전에 생성된 Admin API 키는 Admin API와 계속 작동하지만, 해당 키로 Activity Feed를 호출하면 403 Forbidden이 반환됩니다. 범위를 적용하려면 새 Admin API 키를 생성하세요.

Compliance Access Key 생성

Admin API 키 생성

Admin API 키는 키가 생성되기 전에 조직에 대해 Compliance API가 활성화된 경우에만 read:compliance_activities 범위를 가집니다. 활성화 후: Claude Console 조직을 참조하세요. 다른 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 객체 이해하기를 참조하세요.

다음 단계