Журнал фишинговых писем

Этот отчет представляет собой журнал фишинга уровня событий: одна строка соответствует одному зафиксированному взаимодействию в рамках симуляции (дата, действие, адрес электронной почты получателя, тема, отправитель, сложность). Отчет остается в длинном формате: история отдельного сотрудника не сворачивается в единый результат. Запрос охватывает последние 12 календарных месяцев в occurred_after (полночь UTC в тот же день месяца двенадцать месяцев назад, а не период в 365 дней). Настройка, учетные данные, постраничная выборка и повторные попытки при ограничении частоты запросов такие же, как в руководстве по подключению Power BI / Excel. Сначала добавьте общий запрос Fn_FetchAll; этот отчет вызывает его по имени.

​

Необходимые области действия ключа

Ключ, которому предоставлена только область simulation:read, не может обращаться к конечной точке событий отчетности (API возвращает 403). См. выбор подходящей детализации.

​

Исходные конечные точки

Допустимые фильтры для списка событий (любые другие возвращают 400): limit, page_token, simulation, entity, event_type, occurred_after. Это семейство отчетности является предварительным набором данных. Схему набора данных и политики данных можно просмотреть по адресам GET /v1/reporting/datasets и GET /v1/reporting/datasets/simulation_events.

​

Детализация

Одна строка соответствует одному событию симуляции в отчетности. Если сотрудник открыл, а затем нажал на одно и то же сообщение, создаются две строки. События с пустым значением entity_id (нет инициатора / получателя / целевого участника) также отображаются — при этом email имеет пустое значение. Окно API расширено на одну минуту; точная граница occurred_at >= WindowStart повторно применяется локально, чтобы последний год не зависел от того, считает ли сервер occurred_after включительным или исключительным. Бюджет запросов: один постраничный обход событий в рамках окна и один обход сущностей. Всегда задавайте limit = "500".

​

Сопоставление столбцов

Названия прежних столбцов взяты из экспорта вашего предыдущего поставщика. Поля /v1 — это имена в публичном API; запрос присваивает некоторым из них псевдонимы для отчета.

​

Токены действий

action — закрытый токен отчетности. Прежнему значению «Email Sent» соответствует simulation.delivered (delivered — публичный глагол; передаваемый токен — simulation.delivered). Дополнительные поля, сохраненные, поскольку они есть в API: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, а также entity_type и entity_status из сопоставления сущностей.

​

Отличия от прежнего экспорта

• Необработанный IP-адрес недоступен. /v1 не раскрывает необработанный IP-адрес клиента — это решение принято из соображений конфиденциальности по умолчанию, а не ожидающее реализации сопоставление. Запрос не добавляет столбец-заполнитель для IP-адреса.
• Тип устройства является производным, а не необработанным. device_type — это производный класс устройства для событий нажатия, отправки и сообщения о письме. Наблюдаемые токены включают desktop, mobile, tablet и unknown, однако источник сохраняет произвольную строку — рассматривайте ее как свободный текст, а не как закрытое перечисление. Значение пусто, если у события нет производного класса, а необработанная строка user_agent остается закрытой.
• «Email Sent» — это simulation.delivered. Используйте этот токен при фильтрации или подсчете отправок. Не ищите прежнюю строку email_sent.
• Адрес электронной почты получателя определяется сопоставлением, а не полем события. Событие отчетности не содержит адрес электронной почты; запрос обходит /entities, чтобы заполнить его.
• Последние 12 календарных месяцев, а не период в 365 дней и не вся история.
• Длинный формат без сворачивания. Одна строка на взаимодействие, а не один результат на сотрудника.

​

Дальнейшие шаги