Логи аудита
Просматривайте историю действий, меняющих состояние организации: кто, что, когда и откуда сделал. Записи доступны только для добавления, а следы вмешательства можно обнаружить.
Логи аудита показывают хронологию поддерживаемых административных действий в организации с поиском и фильтрами: назначений ролей, изменений движков и выпуска ключей API. См. ограничения охвата. Доступны на плане Enterprise вместе с ролями и разрешениями.
На уровне базы данных в лог можно только добавлять записи: через подключение приложения нельзя обновлять или удалять строки аудита и очищать таблицу. Всё записанное остаётся неизменным.
Что записывается #
В каждом событии фиксируются исполнитель, действие, объект и HTTP-контекст поступившего запроса.
| Поле | Примечания |
|---|---|
| Исполнитель | Пользователь, выполнивший действие, или ключ API, с помощью которого оно выполнено |
| Действие | Типизированное значение, например engine.created или member.role_changed |
| Объект | Сущность, которую затронуло действие (например, движок, роль или запись глоссария) |
| Метаданные | Только ИД связанных сущностей — никаких имён, адресов почты или фрагментов контента |
| Контекст запроса | request_id, IP-адрес, агент пользователя — фиксируются, если вызов поступил по HTTP |
| Метка времени | Время в UTC и монотонно возрастающий порядковый номер для обнаружения пропусков |
Только ИД — так задумано
В столбце метаданных хранятся ИД, а не значения для чтения человеком. При просмотре интерфейс подставляет текущие имена, поэтому переименование движка или пользователя не меняет историю. Это также позволяет избежать конфликтов с правом на удаление данных по GDPR: в строках аудита нет контента, который нужно удалять.
Какие действия фиксируются #
События сгруппированы по тем же категориям, что и в фильтре на панели управления.
| Категория | Действия, которые уже фиксируются |
|---|---|
| Организация | org.created, org.settings_updated, org.deleted |
| Участники | member.invited, member.removed, member.role_changed |
| Роли | role.created, role.updated, role.deleted |
| Движки | engine.created, engine.updated, engine.deleted |
| Ключи API | api_key.created, api_key.revoked |
| Контент | glossary_item.*, instruction.*, brand_voice.* (только операции с отдельными объектами) |
Как открыть лог #
Пункт Лог аудита всегда отображается в разделе Настройки, в подразделе Администрирование. Если у организации нет права доступа, вместо хронологии на странице появится сообщение «Лог аудита недоступен на вашем плане». На странице доступны:
- Список с фильтрами — отбирайте события по Действию, Исполнителю и Периоду (готовый вариант, например Последние 7 дней, или диапазон дат С / По). Будущие даты недоступны для выбора.
- Загрузить более ранние события — сначала показаны самые новые события. Выберите Загрузить более ранние события внизу списка, чтобы загрузить следующую страницу.
- Подробности события — выберите любую строку, чтобы развернуть её прямо в списке и увидеть все метаданные, ИД запроса, IP-адрес и агент пользователя.
- Возможность поделиться — фильтры и открытое событие сохраняются в URL, поэтому вы можете поделиться ссылкой на любое представление.
Кому доступен просмотр #
Для доступа к странице нужны два условия:
- Право доступа — для организации должна быть включена функция логов аудита (план Enterprise).
- Разрешение — роль участника должна включать
org:view_audit_logs. В предустановленной роли Полный доступ это разрешение есть по умолчанию. У владельцев оно есть всегда.
Участники без разрешения видят страницу «Нет доступа» вместо хронологии. Участники организации без права доступа видят предложение перейти на нужный план.
Если срок действия плана Enterprise истёк
Логи аудита доступны по тому же праву доступа уровня RBAC. Прошлые события остаются в базе данных, но на странице появляется сообщение «Лог аудита недоступен на вашем плане», а конечные точки чтения возвращают код 403, пока действие плана не возобновится.
Как обнаружить вмешательство #
Логи аудита не просто хранят историю — изменить её задним числом действительно сложно.
- Только добавление на уровне базы данных. Миграция, создающая таблицу, выполняет
REVOKE UPDATE, DELETE, TRUNCATEдля роли API. Любая попытка изменить строку — из-за ошибки в коде, через новую конечную точку или даже с помощью SQL-инъекции — будет отклонена Postgres ещё до изменения. - Монотонная последовательность. В каждой строке есть столбец
seqсо строго возрастающим значением. Проверяя последовательность, аудитор может обнаружить удаления по пропускам.
Этого достаточно для мер контроля уровня SOC 2. Но это не защищает от злоумышленников с учётными данными для прямого доступа к рабочей базе данных. Более строгие меры защиты — отдельная роль владельца и зеркало WORM — доступны по запросу.
Срок хранения #
По умолчанию события аудита хранятся бессрочно. На плане Enterprise можно настроить срок хранения — обычно 1, 3 или 7 лет. Свяжитесь с нами, если вам нужна определённая политика хранения для соблюдения нормативных требований или заполнения анкет по безопасности.
Что пока не поддерживается #
В первой версии есть несколько намеренных ограничений:
- Запись без гарантии, вне транзакции. Транзакционную запись планируем добавить в ближайшее время. Событие аудита записывается после действия, которое оно описывает, а не в рамках той же транзакции базы данных. В редких случаях действие может выполниться, а запись события — завершиться сбоем. Тогда действие останется без соответствующего события.
- Некоторые типы действий пока не фиксируются. Изменения состава участников движка, подключение, обновление и отключение интеграций, изменения конфигурации модели, изменения платёжной подписки и массовые операции с контентом (загрузка CSV,
createMany/updateMany/deleteMany) пока не создают событий. Значения действий уже зарезервированы: когда мы добавим их запись, они появятся в существующих категориях фильтра. - Чтение не фиксируется. Просмотр самого лога аудита, просмотр логов запросов движка или скачивание глоссария не создают событий. Фиксируются только действия, меняющие состояние.
- Экспорта пока нет. Данные аудита доступны на панели управления. Экспорт в CSV, вебхук SIEM и зеркало S3 запланированы — сообщите нам, если они вам нужны.
- Нет отдельного представления для движка. Все события аудита организации собраны в одной хронологии. Чтобы сузить выборку, используйте фильтр по действию или исполнителю.
- Нет обновлений в реальном времени. Кнопки Обновить и потока WebSocket нет — перезагрузите страницу, чтобы увидеть новые события.