Compliance API는 Claude Enterprise 고객에게 조직의 "Activity Feed"(활동 피드), 연결된 모든 조직에 걸친 사용자, 역할 및 그룹 디렉터리, 각 조직에 적용되는 유효 설정, 그리고 claude.ai 조직의 경우 기반이 되는 채팅, 파일, 프로젝트에 대한 프로그래밍 방식의 액세스를 제공합니다. 보안, 법무 및 규정 준수 팀은 이를 사용하여 활동을 감사하고, 콘텐츠를 검색하거나 삭제하고, 이벤트를 다운스트림 도구로 전달합니다.
두 가지 키 유형으로 Compliance API를 사용할 수 있습니다. Compliance Access Key(claude.ai에서 생성)는 모든 엔드포인트에 접근할 수 있고, Admin API key(Claude Console에서 생성)는 Activity Feed에만 접근할 수 있습니다. 전체 키 유형 비교는 어떤 키가 필요한가요?를 참조하세요.
다음 호출은 조직에서 가장 최근의 활동 이벤트를 반환합니다. read:compliance_activities 범위를 가진 모든 키로 호출할 수 있습니다. 키를 생성하고 해당 범위를 부여하려면 Compliance API 설정을 참조하세요.
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=1" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"성공적인 응답은 data(Activity 레코드의 배열), has_more, first_id, last_id를 포함하는 JSON 객체를 반환합니다:
{
"data": [
{
"id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"created_at": "2026-04-10T08:09:10Z",
"organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
"organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
"actor": {
"type": "user_actor",
"email_address": "[email protected]",
"user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
"ip_address": "192.0.2.34",
"user_agent": "Mozilla/5.0..."
},
"type": "claude_chat_created",
"claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
"claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
}
],
"has_more": true,
"first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}모든 엔드포인트는 https://api.anthropic.com의 /v1/compliance/* 아래에 있으며 x-api-key 헤더를 통해 인증합니다. 키를 프로비저닝하려면 Compliance API 설정을 참조하세요.
Activity Feed(GET /v1/compliance/activities)는 read:compliance_activities 범위를 가진 모든 키에서 사용할 수 있습니다. 필터, 페이지네이션 및 전체 Activity 객체에 대해서는 Activity Feed 쿼리를 참조하세요. 나머지 엔드포인트는 관련 범위를 가진 Compliance Access Key가 필요합니다.
Claude Enterprise 테넌트에는 하나의 상위 조직(ID를 중앙 집중화하는 최상위 컨테이너)과 두 가지 종류의 연결된 조직이 있습니다. 사용자가 채팅하고 콘텐츠를 저장하는 claude.ai 조직과 사용자가 Claude API 워크로드를 관리하는 Claude Console 조직입니다. 상위 조직을 포괄하는 키의 경우, 디렉터리 엔드포인트(조직, 사용자, 역할 및 그룹)는 두 종류의 모든 연결된 조직에서 데이터를 반환합니다. 콘텐츠 엔드포인트(채팅, 파일, 프로젝트 및 프로젝트 첨부 파일)는 claude.ai 데이터만 제공합니다.
모든 /v1/compliance/* 엔드포인트는 상위 조직당 분당 600개 요청의 단일 속도 제한을 공유합니다. 응답 헤더와 재시도 규약에 대해서는 429 Too Many Requests를 참조하세요.
Compliance API와 겹치는 두 가지 인접 기능이 있습니다. 다음은 선택 방법입니다.
감사 로그 내보내기는 claude.ai > 조직 설정 > 데이터 및 개인정보에 있는 별도의 기능으로, 소유자와 기본 소유자가 조직 이벤트의 CSV를 다운로드할 수 있게 합니다. 이는 Compliance API보다 훨씬 제한적입니다. 조회 기간이 제한되어 있고, CSV 다운로드만 가능하며, 채팅, 파일 또는 프로젝트 콘텐츠에 접근할 수 없습니다. 지속적인 프로그래밍 방식 사용에는 Compliance API를 표준으로 사용하세요.
Anthropic은 두 가지 분석 API를 제공합니다. Claude Enterprise Analytics API와 Claude Code Analytics API입니다. 둘 다 IT, FinOps 및 플랫폼 팀을 위한 집계된 사용량 및 비용 수치를 반환하는 반면, Compliance API는 보안, 법무 및 규정 준수 팀을 위한 이벤트별 레코드를 반환합니다. 두 API 제품군은 서로 다른 질문에 답하고, 서로 다른 키를 사용하며, 별도로 프로비저닝됩니다.
조직에서 Compliance API를 활성화한 다음, Compliance Access Key(범위가 지정된 권한 포함) 또는 Admin API key를 생성하고 어떤 것을 사용해야 하는지 알아봅니다.
공유 Activity Feed를 검색, 필터링 및 페이지네이션합니다. 두 가지 키 유형 모두 지원됩니다.
채팅 콘텐츠와 첨부 파일을 읽은 다음 필요에 따라 삭제합니다. Compliance Access Key가 필요합니다.
연결된 조직, 구성원, 역할 및 디렉터리 그룹을 열거하고 각 조직의 유효 설정을 읽습니다.
피드 소비 패턴을 선택하고, SIEM 상관 관계를 계획하고, 보존 접근 방식을 결정합니다.
Compliance API가 반환하는 모든 400, 401, 403, 404, 409, 429 및 5xx 응답과 각각의 해결 방법입니다.
모든 Compliance API 호출에 대한 엔드포인트 경로, 매개변수 및 응답 스키마입니다.
일반적인 키, 범위, 가용성 및 통합 질문에 대한 답변입니다.
Was this page helpful?