Получение доступа к Compliance API

Compliance API использует два типа ключей, и то, какой из них вы создаёте, зависит от того, какой продукт Claude использует ваша организация. Основные владельцы создают ключи Compliance Access Key в claude.ai; эти ключи открывают доступ ко всему Compliance API. Администраторы организации создают ключи Admin API в Claude Console; эти ключи открывают доступ только к Activity Feed.

Какой ключ вам нужен?

У тенанта Claude Enterprise есть одна родительская организация, которая централизует управление идентификацией, SSO и SCIM для всех рабочих организаций под ней. Эти рабочие организации являются связанными организациями родительской.

Запрос доступа к Compliance API

Свяжитесь с вашим представителем Anthropic, чтобы запросить доступ. Включение происходит на уровне родительской организации и распространяется на все связанные организации — как в claude.ai, так и в Claude Console. Что изменится после включения, зависит от того, какой продукт Claude использует ваша организация.

После включения: организации claude.ai

После того как Anthropic включит Compliance API для вашей родительской организации, основной владелец сможет создавать ключи Compliance Access Key в разделе Keys на странице claude.ai > Organization settings > API.

После включения: организации 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 имеют область действия read:compliance_activities только в том случае, если Compliance API был включён для организации до создания ключа; см. После включения: организации 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; его области действия — это подмножество, которое вы выбрали при создании.
• Интерфейс настроек. Откройте раздел Keys на странице claude.ai > Organization settings > API или раздел Admin keys на странице Claude Console > Settings > Admin keys и посмотрите столбец Scopes для ключа.
• Ответы с ошибками. Вызов, превышающий области действия ключа, возвращает 403 с сообщением в формате Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>]. Полный каталог ошибок см. в разделе Обработка ошибок 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, немедленно удалите его, проверьте Activity Feed на наличие активностей compliance_api_accessed от скомпрометированного ключа и выполните ротацию всех нижестоящих учётных данных, к которым мог получить доступ утёкший ключ. Передайте activity_types[]=compliance_api_accessed, чтобы ограничить запрос, затем в вашем клиенте оставьте активности, у которых actor.type равен api_actor, а actor.api_key_id совпадает со скомпрометированным ключом; схему актора см. в разделе Понимание объекта Activity.

Дальнейшие шаги