Security posture в Compliance API
Узнайте, какие данные о странице Security posture (Security Center) в claude.ai предоставляет Compliance API и с чего начать.
Страница Security posture в разделе Настройки организации на claude.ai сравнивает настройки Claude вашей организации с рекомендуемыми Anthropic мерами безопасности. Через Compliance API ваши инструменты безопасности могут считывать изменения, которые фиксирует эта страница. Они также могут считывать текущие результаты. Security posture сообщает о ваших настройках и не меняет их. Пункт боковой панели называется Security posture, а открываемая им страница озаглавлена Security Center.
Выберите свой путь
Чтобы передавать изменения на странице в вашу систему «security information and event management» (управление информацией и событиями безопасности), или SIEM, начните со страницы Отправка событий Security posture в вашу SIEM. Если вы уже принимаете всю ленту активности целиком, эти события у вас уже есть; проверьте две вещи.
- Чтобы настроить оповещения о рискованных изменениях, см. Обнаружение изменений в Security posture.
- Чтобы нормализовать данные к «Open Cybersecurity Schema Framework» (открытая платформа схем кибербезопасности), или OCSF, см. Сопоставление событий Security posture с OCSF.
- Чтобы узнать, кто принял какой риск, когда и до какого срока, см. Справочник по событиям Security posture; действующие риски см. в разделе Текущие результаты.
Чтобы работать с текущими результатами от конечной точки, используйте следующие страницы:
- Для дашбордов см. Справочник по результатам Security posture.
- Чтобы проверить сохранённые события, см. Сверка сохранённых событий Security posture с текущими результатами.
- Если конечная точка и страница расходятся, см. Как подтверждение отображается в ответе.
Чтобы разобраться в данных, читайте дальше.
Что оценивает Security posture
Security posture оценивает список мер безопасности и выставляет каждой из них результат.
Меры
Мера — это одна рекомендуемая настройка или практика, например единый вход. У каждой меры есть отображаемое имя и идентификатор. Идентификатор одинаков для всех организаций. У меры также может быть текущее значение (current_value) и рекомендуемое значение (desired_state). Меры бывают трёх видов:
| Вид | Что определяет её результат | Пример |
|---|---|---|
| Автоматически проверяемая мера | Автоматическая проверка текущего значения на соответствие рекомендуемому значению, кроме случаев, когда действует подтверждение. | sso_enabled |
| Вручную подтверждаемая мера | Человек, поскольку Anthropic не может прочитать настройку, например когда она находится в консоли другого поставщика. | oauth_conditional_access |
| Справочная мера | Ничто: рекомендуемого значения нет, поэтому мера включается в отчёт, но не получает результат. | allowed_invite_domains |
Подтверждения
Подтверждение — это зафиксированное заявление человека о том, в каком состоянии находится организация в отношении меры; это не результат проверки. Подтверждение может быть у большинства мер, включая автоматически проверяемые, независимо от результата их проверки. Подтверждение имеет одно из трёх значений:
- Выполнено (
completed): мера внедрена. - Принятый риск (
accepted_risk): мера не внедрена, и организация принимает риск. - Не пройдено (
control_failed): мера не внедрена.
Пользователь, имеющий право подтверждать, делает это на странице. API считывает подтверждения, но не может их создавать. Когда кто-то выполняет подтверждение, страница может задать вопрос, иногда требуя ответа, и хранит ответ вместе с подтверждением как его комментарий длиной не более 2 000 символов. Активность в ленте активности никогда не включает комментарий и не показывает, что он существует. Конечная точка также не возвращает комментарии.
Результаты
Каждая мера имеет один из четырёх результатов.
| Результат | Значение |
|---|---|
Пройдено (passed) | Соответствует рекомендуемому значению или действует подтверждение со значением «Выполнено» или «Принятый риск». |
Не пройдено (failed) | Не соответствует рекомендуемому значению или подтверждена со значением «Не пройдено» (control_failed). |
Не подтверждено (not_attested) | Вручную подтверждаемая мера, для которой нет действующего подтверждения. |
Справочно (descriptive) | Не получает результат, даже при наличии подтверждения; сюда относятся справочные меры, а также меры, которые неприменимы или значения которых не удалось прочитать. |
Действующий принятый риск для автоматически проверяемой или вручную подтверждаемой меры засчитывается как «Пройдено», хотя мера не внедрена. В ответе автоматически проверяемая мера, подтверждённая как «Выполнено», пока её автоматическая проверка завершается неуспешно, имеет значение failed.
Когда подтверждение перестаёт действовать
Подтверждение действует, пока не выполнится одно из трёх условий:
- Кто-то снимает или изменяет его.
- Наступает его дата окончания (
review_date). Человек, выполняющий подтверждение, выбирает 90 дней или отсутствие даты окончания. - Для автоматически проверяемой или справочной меры меняется текущее значение или, при принятом риске для некоторых автоматически проверяемых мер, автоматическая проверка завершается успешно.
Если действующего подтверждения нет, результат автоматически проверяемой меры определяется её проверкой, а вручную подтверждаемая мера получает результат «Не подтверждено».
Изменения во времени: лента активности
Лента активности отвечает на вопросы, что изменилось, когда и кто это изменил. Она фиксирует активность, когда кто-то подтверждает меру, изменяет подтверждение или снимает его, а иногда — когда подтверждение автоматически перестаёт действовать.
В заголовках этих страниц активности называются событиями. Для их чтения нужна область действия read:compliance_activities или read:org_audit. Их поля перечислены на странице Справочник по событиям Security posture. Чтобы собирать их, см. Отправка событий Security posture в вашу SIEM.
Текущие результаты: конечная точка
Конечная точка отвечает на вопрос, каков результат меры на момент запроса. Используйте её для отчётности по организациям, входящим в вашу родительскую организацию. Каждый вызов считывает данные одной организации и не возвращает историю. Для каждой меры, которую он перечисляет, ответ содержит её id, display_name и результат в rating, указанный с помощью идентификаторов из таблицы результатов.
Для вызова нужна область действия read:compliance_org_data или read:org_audit.
Страница, конечная точка и лента не всегда показывают одно и то же, поскольку в ответ не попадают некоторые меры и некоторые подтверждения. См. Как подтверждение отображается в ответе и Сверка сохранённых событий Security posture с текущими результатами.
Доступность
Security posture находится в стадии бета-тестирования.
Если ваша организация использует тариф Claude Enterprise, ей доступен Security posture и в её родительской организации включён Compliance API, лента активности фиксирует для неё активности подтверждений, а конечная точка возвращает результаты вашей организации.
Вам также нужен Compliance Access Key с соответствующей областью действия. На этих страницах предполагается, что вы ознакомились со страницами Настройка Compliance API и Запросы к ленте активности.
Если ваша организация использует другой тариф или является организацией Claude Console, лента активности не фиксирует для неё активностей Security posture, а конечная точка возвращает 404.
Если для вашей организации страницу Security posture отключили, конечная точка возвращает 404 для вашей организации, пока страницу не включат. Даже ключ для родительской организации получает этот 404.
Для некоторых организаций конечная точка возвращает 404, даже если все три условия выполнены и страницу не отключали.
Кто может видеть, кто выполнил подтверждение
Каждая активность подтверждения, вызванная человеком, фиксирует его идентификатор пользователя, его адрес электронной почты на тот момент, а также IP-адрес и user agent запроса. Любой ключ, который охватывает организацию и имеет область действия read:compliance_activities или read:org_audit, может считывать эти данные, даже после того как человек покинет организацию или его учётная запись будет удалена. Удаление организации не убирает эти активности из ленты активности, где активности хранятся в течение 6 лет. Собственные ключи организации перестают работать при её удалении.
Любой ключ, имеющий либо одновременно read:compliance_org_data и read:compliance_user_data, либо read:org_audit, может считывать в поле attested_by конечной точки идентификатор пользователя, выполнившего подтверждение, там, где конечная точка его возвращает, даже для подтверждений, выполненных до того, как у вас появился доступ.
Эти значения являются персональными данными; ваши копии сохраняются и после того, как человек перестанет быть участником организации. Прежде чем вы начнёте собирать эти данные, сообщите людям, выполняющим подтверждения.
Что хранит Anthropic, когда кто-то выполняет подтверждение
Anthropic хранит одно подтверждение для каждой меры, в том числе его значение, время его выполнения, дату окончания, если она задана, и учётную запись человека, выполнившего подтверждение. Повторное подтверждение меры заменяет сохранённое подтверждение.
Anthropic продолжает хранить подтверждение после наступления его даты окончания или после того, как оно автоматически перестаёт действовать, пока кто-то не снимет его или пока Anthropic не удалит его при удалении организации. Если учётная запись человека, выполнившего подтверждение, удалена, Anthropic продолжает хранить подтверждение, но в нём больше не указано, кто выполнил подтверждение. Любые активности в ленте активности, которые вызвал этот человек, по-прежнему указывают на этого человека. Снятие или замена подтверждения ничего не удаляет из ленты активности (см. Кто может видеть, кто выполнил подтверждение).
Ключи шифрования, управляемые клиентом (CMEK), нулевое хранение данных (ZDR) для Claude Code и план Enterprise, готовый к HIPAA, не меняют того, что Anthropic хранит о мере, значении, датах и учётной записи подтверждения. Ни одно из трёх не сокращает срок, в течение которого Anthropic хранит эти сведения. CMEK не шифрует эти поля.
Anthropic хранит комментарий к подтверждению до тех пор, пока кто-то не снимет подтверждение или пока Anthropic не удалит комментарий при удалении организации. Повторное подтверждение может заменить или удалить комментарий. Пока Security posture недоступен организации, Anthropic продолжает хранить её подтверждения и комментарии, и никто не может ни увидеть, ни снять их на странице Security posture. Пользовательский период хранения разговоров не сокращает срок, в течение которого Anthropic хранит подтверждение или комментарий. Активности в ленте активности никогда не включают комментарий (см. Что не записывает лента).
Эта страница была полезной?