Когда заказ изменён без объяснения, 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 рекомендуют защищать логи от несанкционированного доступа, модификации и удаления; простая таблица, которую любой администратор может очистить, не отвечает этой цели.

Тест восстанавливает историю без догадок

  1. Изменить одно поле заказа и найти событие по object_id.
  2. Повторить действие без прав и увидеть failed result.
  3. Запустить массовую операцию и связать summary с job id.
  4. Убедиться, что секреты и неразрешённые поля отсутствуют.
  5. Отключить получателя логов в тесте и проверить выбранную политику.
  6. Проверить, что читатель аудита не может редактировать запись.

Журнал готов, когда независимый сотрудник по одной записи отвечает на «когда, где, кто, что и чем закончилось», а доступ к данным ограничен. Для проектирования принесите список критичных операций, роли админки, требования хранения и два реальных обезличенных сценария расследования.

Проверенные источники