Когда заказ изменён без объяснения, web-server access log обычно покажет только endpoint и status. Приложение знает больше: какой администратор действовал, какой объект менялся, прошла ли проверка прав и завершилась ли транзакция. Поэтому аудит создают в бизнес-операции, а не пытаются восстановить его из одного HTTP-лога.
Начните с вопроса расследования. Для «кто снял роль менеджера» нужны actor, target user, старое и новое значение, время, результат и request_id. Полный снимок профиля, пароль и содержимое сессии этому вопросу не помогают и повышают риск.
Событие хранит атрибуцию и исход операции
{
"occurred_at": "2026-10-06T13:20:11Z",
"actor_id": "user:1842",
"actor_role": "support_admin",
"action": "order.status_changed",
"object_type": "order",
"object_id": "ORD-1042",
"changes": {"status": {"from": "paid", "to": "cancelled"}},
"result": "success",
"request_id": "req_7f2c"
}Пример обезличен. `actor_id` должен ссылаться на устойчивую учётную запись, а не только на отображаемое имя. Время лучше хранить с часовым поясом, обычно в UTC. Request ID связывает запись с техническими логами, но не заменяет идентификатор человека.
Не каждое чтение требует одинаковой детализации
| Операция | Что записать | Особенность |
|---|---|---|
| Изменение роли | actor, target, from/to, result | Высокий приоритет |
| Удаление записи | тип, id, reason, result | Ссылка на snapshot/backup по политике |
| Экспорт | actor, тип набора, объём, result | Не копировать выгруженные данные в лог |
| Просмотр чувствительных данных | actor, object class, purpose | Если требует политика |
| Массовое обновление | job id, фильтр-сводка, counts | Детали связывать по job id |
| Обычное чтение списка | По риску и требованиям | Избегать шумового журнала |
OWASP отмечает, что security, audit и transaction logs могут иметь разные цели и поля. Один поток на все случаи создаёт шум и затрудняет доступ. Определите назначение, срок хранения и круг читателей для каждой категории до реализации.
Before и after ограничивают конкретными полями
- Записывайте только изменённые бизнес-поля, нужные для расследования.
- Маскируйте или исключайте персональные и коммерчески чувствительные значения.
- Никогда не сохраняйте пароль, access token, session ID и ключ шифрования.
- Нормализуйте переносы строк и delimiters, чтобы исключить log injection.
- Фиксируйте failed попытки значимых операций, а не только успех.
- Для удаления связывайте аудит с разрешённым механизмом восстановления.
Полный JSON объекта до и после кажется удобным, но быстро копирует в аудит адреса, телефоны, токены интеграций и большие тексты. Лучше явная allowlist полей изменения. Если значение нельзя хранить, оставьте факт изменения и классификацию без содержимого.
Запись создаётся рядом с транзакцией
Журнал не должен сообщать success, если изменение откатилось. В реляционном приложении бизнес-изменение и audit row часто записывают в одной транзакции, а дальнейшую отправку в центральное хранилище выполняет надёжный фоновой механизм. Архитектура зависит от требований, но исход операции должен быть однозначным.
| Сбой | Что проверить | Ожидаемое поведение |
|---|---|---|
| Audit storage недоступно | Политика fail-open/fail-closed | Значимые операции не теряются молча |
| Повтор запроса | request/idempotency id | Понятно, одно это действие или два |
| Нет actor | Системная/анонимная классификация | Не подставлять фиктивного admin |
| Часы расходятся | Синхронизация и offset | Сохраняется сопоставимый timestamp |
| Log заполнен | Квота и alert | Приложение не раскрывает данные |
Чтение журнала само требует контроля
Audit log содержит карту действий и иногда идентификаторы объектов. Дайте чтение отдельной роли, регистрируйте экспорт и изменение политики хранения, ограничьте поиск по назначению. OWASP и NIST рекомендуют защищать логи от несанкционированного доступа, модификации и удаления; простая таблица, которую любой администратор может очистить, не отвечает этой цели.
Тест восстанавливает историю без догадок
- Изменить одно поле заказа и найти событие по object_id.
- Повторить действие без прав и увидеть failed result.
- Запустить массовую операцию и связать summary с job id.
- Убедиться, что секреты и неразрешённые поля отсутствуют.
- Отключить получателя логов в тесте и проверить выбранную политику.
- Проверить, что читатель аудита не может редактировать запись.
Журнал готов, когда независимый сотрудник по одной записи отвечает на «когда, где, кто, что и чем закончилось», а доступ к данным ограничен. Для проектирования принесите список критичных операций, роли админки, требования хранения и два реальных обезличенных сценария расследования.