조직, 사용자, 역할 및 그룹 나열

이 페이지의 엔드포인트는 Claude Enterprise 조직의 디렉터리 측면을 노출합니다. 즉, 연결된 조직, 각 조직의 사용자, 각 조직에 정의된 역할, 그리고 "role-based access control"(역할 기반 접근 제어), 즉 RBAC 또는 "System for Cross-domain Identity Management"(교차 도메인 ID 관리 시스템), 즉 SCIM으로 프로비저닝된 그룹과 그 멤버를 제공합니다. 이를 사용하여 eDiscovery 사용자 목록을 시드하고, 보고 대시보드를 구축하며, 외부 기록 시스템과 그룹 멤버십을 대조할 수 있습니다. Compliance Access Key는 상위 조직에 바인딩되며 그 아래의 모든 연결된 조직에서 데이터를 반환하므로, 단일 키로 전체 트리에 접근할 수 있습니다.

조직 나열

List organizations 엔드포인트는 키가 바인딩된 상위 조직 아래의 모든 조직을 반환합니다.

다음 호출은 상위 조직 아래의 모든 조직을 나열합니다. 응답은 created_at 오름차순으로 정렬된 조직 레코드의 단일 data 배열입니다. 이 엔드포인트는 한 번의 호출로 최대 1,000개의 조직을 반환합니다. 트리가 이를 초과하면 500 오류를 반환합니다.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "name": "Acme Engineering",
      "created_at": "2025-06-01T10:00:00Z"
    },
    {
      "uuid": "5a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Acme Legal",
      "created_at": "2025-07-15T14:30:00Z"
    }
  ]
}

uuid 필드는 다운스트림 조회를 위한 표준 식별자입니다. 다음 표는 Compliance API 전반에서 이를 다른 조직 식별자와 매핑합니다.

대부분의 다른 Anthropic API는 org_ 접두사 형식을 사용합니다.

트리가 1,000개 조직 한도를 초과하는 경우 Anthropic 지원팀에 문의하세요. 시간 경과에 따른 조직 멤버십 변경 사항을 추적하려면 이 엔드포인트를 주기적으로 다시 나열하세요. Activity Feed는 또한 org_deletion_requested, org_deleted_via_bulk, org_parent_join_proposal_created, org_join_proposal_decided 활동 유형을 통해 멤버십 이벤트를 표시합니다. Activity Feed 쿼리를 참조하세요.

조직 사용자 나열

List organization users 엔드포인트는 한 조직에 대한 페이지네이션된 사용자 레코드 목록을 반환합니다.

이 엔드포인트는 read:compliance_org_data가 아닌 read:compliance_user_data가 필요합니다. 디렉터리 열거에 사용하려는 경우 두 스코프를 모두 포함하여 Compliance Access Key를 생성하세요. 그렇지 않으면 호출이 403 Forbidden을 반환합니다.

limit 및 page 쿼리 매개변수의 기본값과 범위는 API 레퍼런스의 List organization users를 참조하세요.

결과는 조직 가입 날짜 오름차순으로 정렬됩니다. Activity Feed의 before_id/after_id 커서(결과 페이지네이션 참조)와 달리, 디렉터리 엔드포인트는 next_page 토큰으로 페이지네이션합니다. has_more가 true인 경우 다음 요청에서 next_page를 변경 없이 page 쿼리 매개변수로 다시 전달하세요.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/users" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=500"

{
  "data": [
    {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "full_name": "Priya Sharma",
      "email": "[email protected]",
      "organization_role": "admin",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_8aW5kZXgicG9zaXRpb25fdG9rZW5fOTE0"
}

여기서 반환된 사용자 ID는 Activity Feed 쿼리의 actor_ids[] 필터와 채팅 및 메시지 검색의 user_ids[] 필터에서 허용하는 것과 동일한 user_... 식별자입니다. organization_role 필드는 나열된 조직 내에서 사용자의 기본 제공 멤버십 수준(admin, billing, claude_code_user, developer, managed, membership_admin, owner, primary_owner, user 중 하나)을 나타내며, 이는 역할 나열에서 반환되는 사용자 지정 RBAC 역할 할당과는 독립적인 축입니다. 일반적인 eDiscovery 흐름은 하나 이상의 조직에 대한 사용자를 나열하고, 자체 외부 레코드와 대조하여 필터링한 다음, 결과 ID를 채팅 및 프로젝트 쿼리에 입력합니다.

사용자는 조직의 활성 멤버인 동안에만 여기에 표시됩니다. 제거된 사용자는 즉시 목록에서 삭제됩니다. 해당 사용자의 과거 활동은 동일한 user_... ID로 인덱싱되어 전체 보존 기간 동안 Activity Feed를 통해 계속 쿼리할 수 있습니다.

역할 나열

List Compliance Roles 엔드포인트는 한 조직에 정의된 역할 레코드의 페이지네이션된 목록을 반환하며, Get Compliance Role은 ID로 하나의 역할을 반환합니다.

두 역할 엔드포인트 모두 read:compliance_org_data가 필요합니다. 목록 엔드포인트는 조직 사용자 나열과 동일한 limit 및 page 매개변수를 허용합니다.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/${org_uuid}/roles" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh",
      "name": "Compliance Reviewer",
      "description": "Read-only access to chat and project content for legal review.",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

전체 역할 레코드 형태는 List Compliance Roles 응답 스키마를 참조하세요. 역할에 현재 부여된 권한을 나열하려면 List Compliance Role Permissions를 사용하세요. 과거 역할 할당 및 권한 변경 사항을 감사하려면 Activity Feed를 통해 RBAC 활동 유형(예: rbac_role_assigned 및 rbac_role_permission_added)을 쿼리하세요. 활동 필터링을 참조하세요.

그룹 및 멤버 나열

List Compliance Groups 엔드포인트는 RBAC 및 SCIM으로 프로비저닝된 그룹의 페이지네이션된 목록을 반환하며, Get Compliance Group은 ID로 하나의 그룹을 반환합니다. List Compliance Group Members 엔드포인트는 한 그룹의 멤버를 반환합니다.

그룹 목록 및 검색 엔드포인트는 read:compliance_org_data가 필요합니다. 멤버 엔드포인트는 read:compliance_user_data가 필요합니다. 그룹을 처음부터 끝까지 순회하려면 두 스코프를 모두 포함하여 키를 생성하세요. 두 목록 엔드포인트 모두 조직 사용자 나열과 동일한 limit 및 page 매개변수를 허용합니다.

전체 그룹 레코드 형태는 List Compliance Groups 응답 스키마를 참조하세요. roles 배열은 그룹에 할당된 역할 ID를 나열하며, 역할 나열의 ID와 일치합니다. source_type은 claude.ai를 통해 수동으로 생성된 그룹(direct)과 SCIM을 통해 외부 ID 공급자에서 동기화된 그룹(scim)을 구분하는 판별자입니다.

그룹을 나열한 다음 각 그룹에 대해 멤버를 나열합니다.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK",
      "name": "Engineering",
      "description": "Engineering team members",
      "source_type": "scim",
      "roles": ["rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh"],
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

각 그룹 ID에 대해 멤버를 나열합니다.

group_id="rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups/$group_id/members" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "user_id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email": "[email protected]",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

전체 멤버 레코드 형태는 List Compliance Group Members 응답 스키마를 참조하세요. user_id 필드는 Activity Feed 및 채팅 목록에서 허용하는 것과 동일한 user_... 식별자입니다. 멤버의 전체 이름을 얻으려면 조직 사용자 목록을 통해 조회하세요.

다음 단계