---
title: Настройка Compliance API
url: https://platform.claude.com/docs/ru/manage-claude/compliance-api-access
description: Включите Compliance API для вашей организации, затем создайте Compliance Access Key (с ограниченными разрешениями) или ключ Admin API и узнайте, какой из них использовать.
---
Организации Claude Enterprise и соответствующие требованиям автономные организации Claude Console имеют самостоятельный доступ к Compliance API. На этой странице описано, как включить Compliance API для вашей организации и создать ключи API.
**Требуемая роль:** администратор организации (Claude Console) либо основной владелец или владелец организации (claude.ai).
Compliance API использует два типа ключей, и то, какой из них вы создаёте, зависит от того, какой продукт Claude использует ваша организация. Основные владельцы и владельцы организаций создают Compliance Access Keys (ключи доступа для соответствия требованиям) в claude.ai; эти ключи открывают доступ ко всему Compliance API. Ключ основного владельца может охватывать все организации в рамках родительской организации; ключ владельца организации охватывает только его собственную организацию. Администраторы организаций создают ключи Admin API в Claude Console; эти ключи открывают доступ только к [Activity Feed](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed) (ленте активности).
## Какой ключ вам нужен?
| Тип ключа | Где создаётся | Для чего используется | Работает с Compliance API? |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, чаты, файлы, проекты, сессии (в приложениях, таких как Cowork и Claude Code), пользователи, метаданные организации и настройки организации | Да (все конечные точки) |
| **Ключ Admin API** (`sk-ant-admin01-...`) | Страница [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) в Claude Console | [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) и Activity Feed в Compliance API | Только Activity Feed |
| **Ключ Analytics API** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Claude Enterprise Analytics API (см. [Analytics API](https://platform.claude.com/docs/ru/manage-claude/analytics-api)) | Нет |
| **Ключ Claude API** (`sk-ant-api03-...`) | Страница [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) в Claude Console | Вызов моделей Claude через [Claude API](https://platform.claude.com/docs/ru/api/overview) | Нет |
Тенант Claude Enterprise имеет одну **родительскую организацию**, которая централизует управление идентификацией, SSO и SCIM для каждой рабочей организации под ней. Эти рабочие организации являются **связанными организациями** родительской организации.
**Родительские организации Claude Enterprise не отображаются в Claude Console (`platform.claude.com`).** Родительская организация не несёт рабочих нагрузок, не имеет ключей Claude API и ключей Admin API. Создавайте Compliance Access Keys в разделе **Organization settings** в claude.ai, а не в Claude Console.
## Настройка Compliance API
Настройка представляет собой единый процесс: включите Compliance API для вашей организации, затем создайте Compliance Access Key в claude.ai. Организация Claude Console вместо этого [создаёт ключ Admin API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access#create-an-admin-api-key) после включения; ключи Admin API имеют доступ только к [Activity Feed](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed).
Compliance Access Key с областью `read:compliance_user_data` может читать каждый чат, файл, проект и транскрипт сессии в каждой связанной организации, включая содержимое, которое основной владелец не видел. Ключ с `delete:compliance_user_data` может безвозвратно удалять чаты, файлы и проекты. Относитесь к Compliance Access Keys как к учётным данным производственной базы данных: храните их в менеджере секретов, никогда — в системе контроля версий или конфигурации форвардера SIEM.
Где именно включается Compliance API, зависит от того, как настроена ваша организация:
* **Организации Claude Enterprise:** основной владелец включает Compliance API в разделе [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Включение происходит на уровне родительской организации и распространяется на каждую связанную организацию — как claude.ai, так и Claude Console.
* **Автономные организации Claude Console:** администратор организации включает переключатель **Compliance API** на странице [Compliance](https://platform.claude.com/settings/security) (`platform.claude.com/settings/security`) в Claude Console. Для соответствующих требованиям организаций включение выполняется самостоятельно, и изменение вступает в силу немедленно. Если на странице отображается ошибка «страница не найдена» или не отображается раздел **Compliance API**, значит, у вас нет роли администратора, ваша организация связана с родительской организацией (в этом случае Compliance API включается из родительской организации) или ваша организация не соответствует требованиям для самостоятельного включения; если вы не уверены, какой из вариантов применим, обратитесь к вашей аккаунт-команде или в [службу поддержки Anthropic](https://support.claude.com).
* **Организации Claude Console, связанные с родительской организацией:** в Claude Console ничего включать не нужно. Попросите основного владельца вашей родительской организации включить Compliance API в claude.ai или обратитесь к вашей аккаунт-команде.
**Отключение Compliance API останавливает запись активности.** Администратор организации может отключить Compliance API в любое время с помощью того же переключателя **Compliance API**, которым он включается. Пока Compliance API отключён, события активности для вашей организации не записываются, поэтому [Activity Feed](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed) не получает новых событий. Если ваша организация подключена к [Access Transparency](https://platform.claude.com/docs/ru/manage-claude/access-transparency), отключение Compliance API также останавливает доставку событий Access Transparency. Активность, не записанная в период, когда Compliance API отключён, не может быть восстановлена позднее. Повторное включение Compliance API возобновляет запись с этого момента; уже записанная активность не удаляется. Для организаций Claude Enterprise настройка Compliance API в claude.ai также управляет захватом транскриптов для [локальных сессий](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions) (сессий на компьютерах пользователей): захват начинается при включении Compliance API и прекращается, пока он отключён, а содержимое транскриптов сессий, выполняемых в период отключения, не захватывается и не может быть восстановлено позднее.
Автономная организация Claude Console использует ключи Admin API, а не Compliance Access Keys: после включения пропустите оставшиеся шаги и вместо этого [создайте новый ключ Admin API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access#create-an-admin-api-key). Оставшиеся шаги предназначены для создания Compliance Access Keys, которые доступны только организациям, входящим в тенант Claude Enterprise.
Доступ ключа задаётся при его создании. Решите, какие организации охватывает ключ:
* Ключ для **родительской организации** может получать доступ к каждой организации в рамках родительской организации.
* Ключ для **одной организации** может получать доступ только к этой организации.
Войдите в claude.ai. Основной владелец родительской организации может создать ключ с любой из двух областей действия. Владелец организации может создать ключ, ограниченный только его собственной организацией.
Если страница **API**, описанная в следующем шаге, не отображается или области соответствия (compliance scopes) недоступны при создании ключа, значит, либо ваша роль не позволяет создавать Compliance Access Keys, либо Compliance API ещё не включён для вашей организации (вернитесь к первому шагу).
Перейдите в [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) и найдите раздел **Keys**.
Нажмите **Create key**, задайте имя ключа и выберите одну или несколько областей (scopes) из следующей таблицы. Нажмите **Create**.
| Область | Предоставляет |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read:compliance_activities` | Чтение Activity Feed. Ключ, охватывающий родительскую организацию, читает события для родительской организации и всех связанных организаций. |
| `read:compliance_user_data` | Чтение пользовательских чатов, сообщений, файлов, проектов, метаданных и транскриптов сессий, пользователей организации, пользовательских настроек и участников групп |
| `delete:compliance_user_data` | Удаление пользовательских чатов, файлов и проектов |
| `read:compliance_org_data` | Чтение метаданных организации (названий, типов, ролей и групп) и действующих настроек для организаций в рамках родительской организации. Для списков пользователей и состава групп требуется `read:compliance_user_data`. |
С Plugins API область `read:compliance_org_data` также позволяет читать через Admin API перечень плагинов и маркетплейсов плагинов вашей организации, включая личные плагины участников и их файлы. Этот перечень идентифицирует участников: он содержит идентификатор пользователя каждого участника, который владеет плагином или создал его либо которому доступ к плагину был предоставлен в индивидуальном порядке, а также адрес электронной почты создателя плагина, пока он остаётся участником; см. [Чтение плагинов и маркетплейсов плагинов](https://platform.claude.com/docs/ru/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces).
Выберите минимальный набор областей, необходимый вашей интеграции:
* Конвейеру аудита, который только читает Activity Feed, нужна лишь область `read:compliance_activities`.
* Инструменту eDiscovery, который читает чаты и файлы, но никогда их не удаляет, не нужна область `delete:compliance_user_data`.
* Если ваш рабочий процесс и читает, и удаляет данные, используйте **два ключа** с раздельными областями, чтобы утечка ключа для чтения не позволила удалить данные.
Области Compliance Access Key неизменяемы после создания. Чтобы изменить области, создайте новый ключ с нужными областями, затем удалите старый.
Скопируйте отображённый секретный ключ (начинающийся с `sk-ant-api01-`) и сохраните его в вашем менеджере секретов. Полный секрет отображается только один раз.
Задайте ключ как переменную окружения, чтобы примеры для командной оболочки в этом руководстве могли его прочитать:
```bash
export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-...
```
## Создание ключа Admin API
Compliance API должен быть уже [включён для вашей организации Claude Console](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access#set-up-the-compliance-api), прежде чем ключ Admin API сможет обращаться к Activity Feed.
Выполните шаги из раздела [Создание ключа Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization), затем задайте ключ как переменную окружения:
```bash
export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-...
```
Отдельное имя переменной не позволяет ключу Admin API перезаписать Compliance Access Key, если вы создаёте оба. Примеры cURL в этом руководстве читают ключ из `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`; подставьте `$ANTHROPIC_ADMIN_KEY` при обращении к [Activity Feed](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed) с ключом Admin API.
Ключи Admin API имеют область `read:compliance_activities` только в том случае, если Compliance API был включён для организации на момент создания ключа; см. [Настройка Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access#set-up-the-compliance-api). Им нельзя предоставить никакую другую область Compliance API, поэтому вызовы любой конечной точки, кроме Activity Feed, возвращают [403 Forbidden](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#403-forbidden).
О роли того же ключа в управлении вашей организацией Claude Console см. [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api).
## Проверка областей вашего ключа
Чтобы проверить области уже имеющегося у вас ключа, используйте один из следующих признаков.
* **Префикс ключа.** `sk-ant-admin01-` — это ключ Admin API (имеет только `read:compliance_activities` с учётом момента включения, описанного в предыдущем разделе). `sk-ant-api01-` — это Compliance Access Key; его области действия — это подмножество, выбранное вами при создании.
* **Интерфейс настроек.** Для Compliance Access Key откройте раздел **Keys** в [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) и посмотрите столбец **Scopes** для ключа. Ключи Admin API, перечисленные на странице [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) в Claude Console, не имеют выбираемых областей действия.
* **Ответы с ошибками.** Вызов, выходящий за пределы областей действия ключа, возвращает 403 с сообщением в формате `Missing required scopes. Got: [] Needed one of: []` (`Needed: [...]` для конечных точек удаления). Полный каталог ошибок см. в разделе [Обработка ошибок Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#403-forbidden).
```json
{
"error": {
"type": "permission_error",
"message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']"
}
}
```
## Управление ключами и их ротация
Удаляйте Compliance Access Key в той же таблице **Keys**, где вы его создали: перейдите в [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Удаляйте ключ Admin API на странице [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) в Claude Console.
Удаление ключа вступает в силу при следующем запросе: льготного периода нет. Compliance Access Keys не истекают сами по себе.
Чтобы выполнить ротацию ключа без простоя:
1. Создайте новый ключ с теми же областями.
2. Обновите вашу интеграцию, чтобы она использовала новый ключ.
3. Убедитесь, что интеграция успешно работает с новым ключом.
4. Удалите старый ключ.
Курсоры пагинации, сохранённые до ротации, остаются действительными: курсоры привязаны к организации, а не к ключу.
Если произошла утечка Compliance Access Key, немедленно удалите его, проверьте [Activity Feed](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed) на наличие активностей `compliance_api_accessed` со стороны скомпрометированного ключа и выполните ротацию всех нижестоящих учётных данных, к которым мог получить доступ утёкший ключ. Передайте `activity_types[]=compliance_api_accessed`, чтобы ограничить запрос, затем в вашем клиенте оставьте активности, у которых `actor.type` равен `api_actor`, а `actor.api_key_id` совпадает со скомпрометированным ключом; схему actor см. в разделе [Структура объекта Activity](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed#understand-the-activity-object).
## Следующие шаги
Читайте события активности по всей организации с помощью любого ключа, имеющего `read:compliance_activities`.
Используйте Compliance Access Key с `read:compliance_user_data` для получения чатов, файлов и проектов claude.ai и `delete:compliance_user_data` для их удаления.
Используйте Compliance Access Key с `read:compliance_user_data`, чтобы получить список сессий, которые ваши пользователи запускают в приложениях и агентах Claude, таких как Cowork и Claude Code, и получить их транскрипты.