# Аудит

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

## Структура записей [#структура-записей]

Каждая запись журнала аудита содержит следующие сведения:

| Поле | Описание |
|------|----------|
| **Дата и время** | Момент совершения действия |
| **Пользователь / API-ключ** | Идентификатор субъекта, выполнившего действие |
| **Тип действия** | Категория операции |
| **Объект** | Идентификатор затронутого ресурса (сессия, ключ, пользователь и т. д.) |
| **Детали** | Дополнительные сведения о выполненном действии |

## Типы событий [#типы-событий]

В журнале фиксируются следующие категории действий:

### Авторизация и доступ [#авторизация-и-доступ]
- Вход в систему (успешный и неуспешный).
- Выход из системы.
- Сброс пароля.

### Управление верификацией [#управление-верификацией]
- Создание, приостановка, возобновление и отмена сессий.
- Отправка сессии на ручную проверку.
- Одобрение или отклонение верификации в разделе «Ревью».

### Конфигурация [#конфигурация]
- Создание, редактирование и публикация сценариев (флоу).
- Создание и отзыв API-ключей.
- Создание, изменение и удаление эндпоинтов вебхуков.
- Создание и отзыв ссылок верификации.

### Управление командой [#управление-командой]
- Приглашение и удаление участников.
- Изменение ролей пользователей.

### Настройки [#настройки]
- Изменение параметров тенанта.
- Изменение профиля пользователя.

## Фильтрация [#фильтрация]

Для работы с журналом доступны следующие фильтры:

- **По периоду** — выбор временного диапазона (дата начала и окончания).
- **По пользователю** — отображение действий конкретного участника команды или API-ключа.
- **По типу действия** — фильтрация по категории операции.

Фильтры применяются совместно, что позволяет формировать точные выборки для анализа.

## Экспорт данных [#экспорт-данных]

Данные журнала аудита доступны для экспорта:

1. Задайте необходимые фильтры.
2. Нажмите **«Экспорт»**.
3. Выберите формат файла.

Экспортированные данные используются для формирования отчётности, передачи контролирующим органам и внутренних расследований.

## Полный перечень действий [#полный-перечень-действий]

Платформа фиксирует более 70 типов действий, охватывающих жизненный цикл всех сущностей (сессии, ревью, флоу, API-ключи, вебхуки, ссылки верификации, команда, биллинг, настройки тенанта, BYOB-хранилище и др.). Полный перечень доступен в фильтре «Действие» на странице **Аудит** в админ-панели. Описание ключевых действий — в разделе [Аудит (Tenant API)](/ru/api/audit).

## Дополнительные эндпоинты Admin API [#дополнительные-эндпоинты-admin-api]

- **`GET /v1/audit/stats`** — агрегированная статистика по записям (количество за период, распределение по категориям).
- **`GET /v1/audit/{id}`** — получение одной записи аудита по идентификатору со всеми полями `details`.

## Срок хранения [#срок-хранения]

Срок хранения записей аудита определяется тарифным планом тенанта (поле `data_retention_days` биллинг-плана). По истечении установленного срока записи автоматически удаляются.

> Для обеспечения долгосрочного хранения рекомендуется выполнять периодический экспорт записей. Текущее значение `data_retention_days` для вашего тенанта доступно в разделе **Настройки → Биллинг и использование**.