ООО «Ивент Хаб» · Москва · работаем по всей России
Пн—Пт, 10:00—19:00hello@gusi-lebedi.comРеквизиты
Практический разбор

Журнал действий в веб-системе: кто изменил заказ и что произошло

Как спроектировать audit log для заказов и кабинета: исполнитель, время, результат, связь событий, защита истории и секретов. Практические критерии приёмки.

Фирменный гусь изучает последовательность запечатанных событий в цифровом архиве

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

В компании «Гуси-Лебеди» рекомендуем выбирать события по вопросам поддержки и владельца процесса. Если в кабинете заказы меняют менеджеры и CRM, журнал должен различать их действия и связывать этапы обмена с итоговым состоянием заказа.

Выберите события, которые помогают объяснить изменения

Полезный журнал отвечает на конкретный вопрос. Например: «почему заказ стал отменённым», «кто изменил реквизиты получателя», «когда интеграции выдали доступ». Перечень стоит согласовать с владельцем процесса до выбора плагина или системы сбора логов.

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

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

Какие сведения нужны одной записи

OWASP рекомендует фиксировать «когда, где, кто и что» и учитывать результат действия. Для заказчика это можно перевести в понятную структуру: время, исполнитель, объект, операция и итог. Название события должно сохранять одинаковый смысл во всех компонентах.

Сведение Пример и назначение
Исполнитель Устойчивая учётная запись менеджера или имя служебной интеграции
Объект Идентификатор заказа, который можно найти даже после смены его названия
Действие Изменение статуса, суммы или полномочий
Результат Выполнено, отклонено, завершилось ошибкой или ещё ожидается
Связь событий Метка операции для поиска запроса, задания и результата обмена
Время Однозначная дата события; при задержке доставки отдельно время записи в журнал

Для выбранных полей можно хранить безопасную разницу «было и стало». Но полная копия заказа в каждой записи быстро превращает журнал в ещё одну базу клиентских сведений. Состав изменений и маскирование нужно проектировать отдельно.

Общая учётная запись отдела ограничивает расследование: журнал покажет аккаунт, а не конкретного сотрудника. IP-адрес тоже не доказывает личность. Надёжность вывода зависит от авторизации, полномочий и сохранности самих записей.

Успех на кнопке и сохранение заказа являются разными событиями

В условном кабинете менеджер меняет сумму, но база отклоняет сохранение. Запись «сумма изменена» будет вводить поддержку в заблуждение. Следует различать попытку, отказ и подтверждённое изменение. Конкретный момент фиксации согласуют с разработчиком.

Если операция продолжается в очереди, событие «задание принято» не должно означать «CRM обновлена». Общая метка помогает связать этапы, а конечный результат записывается отдельно. Похожее разделение видно в разборе пути письма с сайта: принятие задания ещё не подтверждает доставку.

Повторная доставка уведомления или повторный запрос не должны выглядеть как две независимые успешные правки одного заказа. Журнал должен позволять отличить попытки от бизнес-результата. При сбое записи логов заранее определите допустимое поведение: остановить критичную операцию, сохранить событие надёжным способом или явно сообщить об ограничении. Тихая потеря истории не должна обнаруживаться только при споре.

Не складывайте в журнал пароли и полные запросы

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

Режим «сохранять все запросы целиком» опасен тем, что секрет может попасть в адрес, поле формы или тело ответа. Ограничивайте состав записей заранее. Если для диагностики временно нужен расширенный режим, отдельно задайте его доступ, срок и способ отключения.

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

Разделите просмотр истории и возможность её менять

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

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

Исправление ошибочных бизнес-данных лучше отражать новым событием с причиной и связью с предыдущим, чем переписывать прошлое без следа. Журнал не заменяет резервную копию и не даёт автоматическую кнопку отмены всех изменений.

Как по журналу восстановить ход изменения прав

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

Если после выдачи роли запускается фоновое уведомление, передайте ему общий идентификатор операции. Тогда изменение прав и отправку письма можно найти вместе, при этом у каждого события останется свой результат. Если письмо не ушло, журнал должен показать, что доступ выдан, а сбой произошёл на шаге уведомления. Используйте технические идентификаторы и разрешённый набор полей. Тело письма и токен входа для расследования не нужны.

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

Проверьте историю на одном вымышленном заказе

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

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

В требованиях к личному кабинету свяжите вопросы поддержки с поиском по объекту и операции. При разработке веб-системы согласуйте эти связи вместе с перечнем событий, смыслом результата и доступом. После изменений повторяйте проверку цепочки и состава сохраняемых полей.

Начать проект

Обсудим вашу задачу

Ответим в течение рабочего дня. Можно без технического задания — достаточно цели и вводных.

Заполнить короткий бриф ↗
Навигация по экспертизе

Ещё направления для вашего проекта

Все 86 услуг →