Журнал действий в веб-системе нужен, чтобы восстановить последовательность значимых изменений: кто поменял статус заказа, когда исправили сумму и чем закончилась операция. Для этого недостаточно записи «пользователь нажал кнопку». Нужна связь между человеком или интеграцией, конкретным объектом и подтверждённым результатом.
В компании «Гуси-Лебеди» рекомендуем выбирать события по вопросам поддержки и владельца процесса. Если в кабинете заказы меняют менеджеры и CRM, журнал должен различать их действия и связывать этапы обмена с итоговым состоянием заказа.
Выберите события, которые помогают объяснить изменения
Полезный журнал отвечает на конкретный вопрос. Например: «почему заказ стал отменённым», «кто изменил реквизиты получателя», «когда интеграции выдали доступ». Перечень стоит согласовать с владельцем процесса до выбора плагина или системы сбора логов.
Это отличается от записи посещений в Вебвизоре, которая помогает увидеть взаимодействие с интерфейсом. Журнал бизнес-действий должен описывать результат в самой системе, включая операции без браузера: обмен с CRM, фоновое задание или административное изменение.
Не нужно сохранять каждое движение мыши, чтобы понять историю заказа. Отдельно выделите события входа, изменения прав, опасные административные действия и важные изменения данных. Разные журналы могут иметь разные задачи и правила доступа.
Какие сведения нужны одной записи
OWASP рекомендует фиксировать «когда, где, кто и что» и учитывать результат действия. Для заказчика это можно перевести в понятную структуру: время, исполнитель, объект, операция и итог. Название события должно сохранять одинаковый смысл во всех компонентах.
| Сведение | Пример и назначение |
|---|---|
| Исполнитель | Устойчивая учётная запись менеджера или имя служебной интеграции |
| Объект | Идентификатор заказа, который можно найти даже после смены его названия |
| Действие | Изменение статуса, суммы или полномочий |
| Результат | Выполнено, отклонено, завершилось ошибкой или ещё ожидается |
| Связь событий | Метка операции для поиска запроса, задания и результата обмена |
| Время | Однозначная дата события; при задержке доставки отдельно время записи в журнал |
Для выбранных полей можно хранить безопасную разницу «было и стало». Но полная копия заказа в каждой записи быстро превращает журнал в ещё одну базу клиентских сведений. Состав изменений и маскирование нужно проектировать отдельно.
Общая учётная запись отдела ограничивает расследование: журнал покажет аккаунт, а не конкретного сотрудника. IP-адрес тоже не доказывает личность. Надёжность вывода зависит от авторизации, полномочий и сохранности самих записей.
Успех на кнопке и сохранение заказа являются разными событиями
В условном кабинете менеджер меняет сумму, но база отклоняет сохранение. Запись «сумма изменена» будет вводить поддержку в заблуждение. Следует различать попытку, отказ и подтверждённое изменение. Конкретный момент фиксации согласуют с разработчиком.
Если операция продолжается в очереди, событие «задание принято» не должно означать «CRM обновлена». Общая метка помогает связать этапы, а конечный результат записывается отдельно. Похожее разделение видно в разборе пути письма с сайта: принятие задания ещё не подтверждает доставку.
Повторная доставка уведомления или повторный запрос не должны выглядеть как две независимые успешные правки одного заказа. Журнал должен позволять отличить попытки от бизнес-результата. При сбое записи логов заранее определите допустимое поведение: остановить критичную операцию, сохранить событие надёжным способом или явно сообщить об ограничении. Тихая потеря истории не должна обнаруживаться только при споре.
Не складывайте в журнал пароли и полные запросы
OWASP отдельно перечисляет данные, которые обычно нельзя записывать напрямую: пароли, токены доступа, секреты и чувствительные сведения. Для понимания операции чаще нужны безопасный идентификатор, тип изменения и результат, а не содержимое заголовка авторизации.
Режим «сохранять все запросы целиком» опасен тем, что секрет может попасть в адрес, поле формы или тело ответа. Ограничивайте состав записей заранее. Если для диагностики временно нужен расширенный режим, отдельно задайте его доступ, срок и способ отключения.
Не используйте журнал как скрытую копию документов. Срок хранения выбирайте по задачам поддержки и применимым требованиям; единого числа дней для любого бизнеса нет.
Разделите просмотр истории и возможность её менять
Принцип минимальных привилегий OWASP применим и к журналу. Менеджеру может быть нужна история его заказов, поддержке более широкий поиск, а техническому компоненту только запись событий. Доступ ко всем клиентам и выгрузке всего журнала не должен возникать автоматически.
Если человек может незаметно исправить запись о собственной правке, доверие к истории ограничено. Рассмотрите отдельные права и хранилище, ограничение удаления, контроль целостности и регистрацию действий с самим журналом. Эти меры уменьшают риск, но одна надпись «неизменяемый» не доказывает защиту.
Исправление ошибочных бизнес-данных лучше отражать новым событием с причиной и связью с предыдущим, чем переписывать прошлое без следа. Журнал не заменяет резервную копию и не даёт автоматическую кнопку отмены всех изменений.
Как по журналу восстановить ход изменения прав
Проверьте журнал на операции «выдать доступ к проекту». Запись должна связывать инициатора, целевой аккаунт, проект, старую и новую роль и итог операции. Для отказа зафиксируйте причину и убедитесь, что состояние прав не изменилось. Событие успешного изменения должно отражать подтверждённую запись в базе.
Если после выдачи роли запускается фоновое уведомление, передайте ему общий идентификатор операции. Тогда изменение прав и отправку письма можно найти вместе, при этом у каждого события останется свой результат. Если письмо не ушло, журнал должен показать, что доступ выдан, а сбой произошёл на шаге уведомления. Используйте технические идентификаторы и разрешённый набор полей. Тело письма и токен входа для расследования не нужны.
На тестовом окружении повторите запрос на выдачу той же роли и проверьте, что журнал позволяет отличить повтор от второго фактического изменения. Затем проверьте две роли читателя журнала: уполномоченный сотрудник видит цепочку, обычный участник проекта не получает чужие записи через интерфейс или API.
Проверьте историю на одном вымышленном заказе
При приёмке создайте разрешённую тестовую запись и пройдите обычную правку, отказ из-за прав, ошибку сохранения и изменение через интеграцию. Затем найдите каждую операцию по заказу и общей метке. Убедитесь, что попытка не показана как успех и что служебный запрос не приписан человеку.
Отдельно проверьте недоступность хранилища журналов, задержку доставки событий, заполнение диска и запрет просмотра чужих заказов. Выгрузка должна сохранять ограничения доступа и не раскрывать скрытые поля. Зафиксируйте фактический результат каждого случая.
В требованиях к личному кабинету свяжите вопросы поддержки с поиском по объекту и операции. При разработке веб-системы согласуйте эти связи вместе с перечнем событий, смыслом результата и доступом. После изменений повторяйте проверку цепочки и состава сохраняемых полей.
