Журналы аудита - Perplexity Help Center

Обзор

Журналы аудита доступны организациям Enterprise с 50 и более местами или хотя бы с одним местом Enterprise Max. Администраторы могут использовать их для расследования действий и отслеживания административных изменений. Вы можете получать записанные события через вебхук. Текст запросов и ответов ограничен первыми 500 символами. Журналы аудита фиксируют не все действия. Журналы аудита не записывают изменения тарифного уровня мест, выполненные через SCIM, который синхронизирует состав участников с вашим поставщиком удостоверений, или через инструменты массовых операций. Добавление и удаление участников при массовых операциях с CSV также не фиксируется.

Перед началом

Убедитесь, что организация соответствует указанным выше требованиям к местам.
Попросите администратора с доступом к настройкам организации включить ведение журнала.
Для доставки через вебхук подготовьте конечную точку HTTPS и значение для аутентификации.

Конфиденциальность и безопасность данных

Данные вебхука могут содержать персональную информацию и записанное содержимое, а не только идентификаторы действий. В зависимости от события метаданные могут включать текст запросов и ответов, имена файлов, адреса электронной почты затронутых участников, значения настроек организации и сведения о задачах Perplexity Computer. Ограничьте доступ к собранным журналам в соответствии с политиками конфиденциальности вашей организации. Сохраняйте конфиденциальность URL вебхуков и значений аутентификации. Общие правила работы с данными в Enterprise описаны в статье Хранение данных и конфиденциальность для Enterprise. В Центре доверия представлена документация по безопасности и соответствию требованиям, а Дополнение об обработке данных определяет договорные условия обработки данных, если оно включено в ваше соглашение.

Включение журналов аудита

Перейдите в Настройки организации.
Откройте Данные и конфиденциальность.
В разделе Настройки журнала аудита включите переключатель ведения журнала аудита.

Рисунок 1. Переключатель ведения журнала в настройках журнала аудита.

Для доставки через вебхук выполните следующие действия:

Введите адрес вашей конечной точки HTTPS в поле URL-адрес вебхука.

Рисунок 2. Настройки URL-адреса вебхука и заголовка авторизации.
Нажмите Сохранить рядом с полем URL-адрес вебхука.
Если конечная точка требует аутентификации, введите значение в поле Заголовок Authorization.
Нажмите Сохранить рядом с полем Заголовок Authorization.

Если вы не укажете схему авторизации, введённое значение будет отправлено как токен Bearer. О двух поддерживаемых форматах см. в разделе Аутентификация вебхука.

Проверка результата

После поддерживаемого действия убедитесь, что принимающая конечная точка получает событие вебхука и возвращает ответ HTTP 2xx.

Аутентификация вебхука

Вы можете защитить конечную точку вебхука с помощью токена Bearer или полного значения авторизации. Настройте значение, которое ожидает ваша принимающая конечная точка.

Токен Bearer

Укажите токен без префикса, например YOUR_WEBHOOK_TOKEN. Perplexity добавит перед ним Bearer и отправит Authorization: Bearer YOUR_WEBHOOK_TOKEN.

Пользовательский заголовок авторизации

Укажите полное значение авторизации, включающее схему. Например, Splunk YOUR_HEC_TOKEN будет отправлено как Authorization: Splunk YOUR_HEC_TOKEN.

Доставка через вебхук

Формат запроса

Журналы аудита доставляются на URL-адрес вашего вебхука в виде HTTP-запросов POST. Тело запроса использует application/json.

Заголовок аутентификации

Если вы настроили значение для аутентификации, Perplexity включает его в заголовок Authorization. Форматы Bearer и пользовательских схем описаны в разделе Аутентификация вебхука.

Обработка ответов

Ваша конечная точка вебхука должна возвращать ответ HTTP 2xx для подтверждения получения в течение 1 секунды. Perplexity регистрирует ошибки доставки, включая ответы HTTP 4xx и 5xx, но не повторяет автоматически неудачные доставки или доставки с истёкшим временем ожидания. Отслеживайте сбои и пропущенные события на принимающей конечной точке.

Схема журнала аудита вебхука

События вебхука используют приведённые ниже поля.

Поле	Тип	Обязательно	Описание
`uuid`	Строка	Да	Идентификатор события
`timestamp`	Строка	Да	Метка времени RFC 3339
`event_type`	Строка	Да	Тип события
`user_email`	Строка	Да	Электронная почта участника, выполнившего действие
`ip_address`	Строка	Да	Адрес клиента или маркер, не являющийся IP-адресом
`user_agent`	Строка	Да	User-Agent клиента
`session_id`	Строка или null	Нет	Идентификатор связанных событий
`user_id`	Строка или null	Нет	Идентификатор пользователя, если записан
`metadata`	Объект или null	Нет	Данные конкретного события

Таблица 1. Поля полезной нагрузки вебхука.

Обязательное строковое поле может быть пустым, если значение не было записано. Не следует считать каждое значение ip_address IP-адресом.

Типы событий

В следующих таблицах описаны документированные типы событий вебхука. Это не гарантирует, что каждое действие записывается.

События активности пользователей

Тип события	Описание
`login`	Успешный вход
`query`	Отправлен поисковый запрос
`answer_generated`	Возвращён ответ
`file_upload`	Файл загружен в запрос или проект
`file_download`	Файл скачан из проекта
`file_delete`	Файл удалён из запроса или проекта

Таблица 2. События активности пользователей.

События запросов могут включать metadata.attachments с file_uuid и file_name для каждого прикреплённого файла.

События тредов

Тип события	Описание
`thread_forked`	Тред скопирован
`thread_exported`	Тред экспортирован
`thread_shared`	Предоставлен доступ к треду
`thread_deleted`	Тред удалён

Таблица 3. События тредов.

События участников

Тип события	Описание
`member_invited`	Участник приглашён
`member_invite_rescinded`	Ожидающее приглашение отозвано
`member_removed`	Участник удалён
`member_role_changed`	Роль участника изменена

Таблица 4. События участников.

События организации

Тип события	Описание
`organization_settings_update`	Настройка организации изменена

Таблица 5. События организации.

События ролей и групп

Тип события	Описание
`role_created`	Пользовательская роль создана
`role_updated`	Сведения о роли или её разрешения обновлены
`role_deleted`	Пользовательская роль удалена
`role_users_changed`	Пользователи добавлены в роль или удалены из неё
`role_groups_changed`	Группы добавлены в роль или удалены из неё
`group_created`	Группа пользователей создана
`group_deleted`	Группа пользователей удалена
`group_members_changed`	Состав группы изменён

Таблица 6. События ролей и групп.

Для role_users_changed и role_groups_changed метаданные могут включать поле action со значением added или removed. Используйте это поле, чтобы отличить добавление от удаления.

События агента Comet

Тип события	Описание
`comet_agent_action`	Автоматическое действие Comet

Таблица 7. События агента Comet.

События коннекторов

Тип события	Описание
`connector_connected`	Сторонний коннектор подключён
`connector_disconnected`	Сторонний коннектор отключён

Таблица 8. События коннекторов.

События Computer

Тип события	Описание
`computer_task_started`	Задача Computer запущена
`computer_agent_action`	Автоматическое действие в ходе задачи
`computer_task_completed`	Задача успешно завершена
`computer_task_error`	Задача завершилась с ошибкой

Таблица 9. События Computer.

Пример полезной нагрузки вебхука

Этот иллюстративный пример полезной нагрузки JSON представляет событие запроса, доставленное на обычный вебхук.

{
  "uuid": "6ba7b810-9dad-41d1-80b4-00c04fd430c8",
  "timestamp": "2026-10-28T09:05:31+00:00",
  "event_type": "query",
  "user_email": "member@example.com",
  "ip_address": "203.0.113.45",
  "user_agent": "ExampleClient/1.0",
  "session_id": "query_abc123",
  "metadata": {
    "query_str": "What are the best practices for API security?"
  }
}

Форматирование для отдельных платформ

Вебхуки Slack

Для URL-адреса вебхука, начинающегося с https://hooks.slack.com, Perplexity использует формат Block Kit от Slack. Массив blocks содержит разделы с типом события, сведениями об участнике и клиенте, а также метаданными события, если они есть. В названиях типов событий каждое слово начинается с заглавной буквы, а подчёркивания удаляются. При форматировании для Slack отдельные значения метаданных сокращаются до 500 символов, а раздел метаданных до 2500 символов; для длинных значений выводится уведомление о сокращении.

Splunk HTTP Event Collector

Когда значение авторизации начинается с Splunk, Perplexity помещает полезную нагрузку в объект event для HTTP Event Collector (HEC) от Splunk. Этот иллюстративный пример показывает внешнюю структуру:

{
  "event": {
    "uuid": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
    "timestamp": "2026-10-28T09:05:31+00:00",
    "event_type": "login",
    "user_email": "member@example.com",
    "ip_address": "203.0.113.45",
    "user_agent": "ExampleClient/1.0",
    "session_id": null,
    "metadata": {}
  }
}

Обычные вебхуки

Для других адресов назначения вебхука Perplexity отправляет стандартную полезную нагрузку JSON без внешней структуры, специфичной для платформы. Формат см. в разделе Пример полезной нагрузки вебхука.

Типичные сценарии работы с вебхуками

Отслеживание сеансов исследования

Используйте session_id, чтобы сопоставить запрос с ответом.

Найдите событие запроса

Прочитайте query_str в метаданных события. Сохраните его session_id, чтобы найти связанные события.

Сопоставьте событие ответа

Найдите событие answer_generated с тем же session_id. Если значение записано, answer содержит не более первых 500 символов ответа; рядом в поле model указана использованная модель.

Мониторинг доступа к файлам

Используйте идентификаторы файлов, чтобы сопоставлять загрузки и скачивания. Метаданные событий вебхука могут включать записанные сведения о файлах и проектах.

Найдите загрузку файла

Прочитайте file_uuid события загрузки. Сохраните идентификатор для сравнения с последующими событиями.

Сопоставьте скачивания файла

Найдите события скачивания с тем же file_uuid. Используйте поля автора действия и метки времени, чтобы определить, кто и когда обращался к файлу.

Аудит изменений конфигурации

Для organization_settings_update поле key определяет, какая настройка изменилась. Метаданные вебхука могут включать old_value и new_value. Фильтруйте сохранённые данные вебхука по user_email в собственной системе анализа, чтобы отслеживать, какие администраторы вносили изменения.

Устранение неполадок

Проблема	Возможная причина	Следующий шаг
События вебхука не поступают	Настройка ведения журнала или конечной точки может быть не завершена	Проверьте, что ведение журнала включено и конечная точка HTTPS сохранена
Конечная точка возвращает HTTP `4xx` или `5xx`	Принимающая конечная точка отклонила запрос или столкнулась с ошибкой	Проверьте журналы получателя и настроенное значение аутентификации
После сбоя доставки отсутствуют события	Неудачные доставки не повторяются автоматически	Отслеживайте ошибки на стороне получателя; не полагайтесь на автоматическую повторную доставку

Таблица 10. Распространённые проблемы доставки через вебхук.

При обращении в поддержку укажите точную ошибку, время затронутого события или сбоя доставки, часовой пояс, а также уже выполненные действия. Не включайте значения аутентификации, токены и конфиденциальное содержимое событий.

Часто задаваемые вопросы

Можно ли использовать журналы аудита, если в организации меньше 50 мест?

Да. Организация, в которой менее 50 мест, может получить доступ к журналам аудита, если хотя бы одно место использует план Enterprise Max. Условия доступа см. в статье Что такое Enterprise Max?.

Что делать, если журналы аудита были включены по ошибке и появилось неожиданное списание?

Обратитесь к команде по работе с вашим аккаунтом или через Справка > Связаться со службой поддержки, чтобы проверить списание и возможность возврата средств. См. статью Возврат средств; отключение журналов аудита не гарантирует отмену списания.

Дополнительные материалы

Нужна дополнительная помощь?

Обратитесь к команде по работе с вашим аккаунтом или свяжитесь с нами через Справка > Связаться со службой поддержки. Документацию по безопасности и соответствию требованиям можно найти в Центре доверия.

Последнее изменение 29 октября 2026 г.

⌘I

​Обзор

​Перед началом

​Конфиденциальность и безопасность данных

​Включение журналов аудита

​Проверка результата

​Аутентификация вебхука

​Токен Bearer

​Пользовательский заголовок авторизации

​Доставка через вебхук

​Формат запроса

​Заголовок аутентификации

​Обработка ответов

​Схема журнала аудита вебхука

​Типы событий

​События активности пользователей

​События тредов

​События участников

​События организации

​События ролей и групп

​События агента Comet

​События коннекторов

​События Computer

​Пример полезной нагрузки вебхука

​Форматирование для отдельных платформ

​Вебхуки Slack

​Splunk HTTP Event Collector

​Обычные вебхуки

​Типичные сценарии работы с вебхуками

​Отслеживание сеансов исследования

​Мониторинг доступа к файлам

​Аудит изменений конфигурации

​Рекомендации

​Реализация конечной точки вебхука

​Хранение и анализ собранных журналов

​Устранение неполадок

​Часто задаваемые вопросы

​Можно ли использовать журналы аудита, если в организации меньше 50 мест?

​Что делать, если журналы аудита были включены по ошибке и появилось неожиданное списание?

​Дополнительные материалы

​Нужна дополнительная помощь?