Наиболее уязвимые пользователи

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

​

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

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

​

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

Разрешенные фильтры в списке результатов: limit, page_token, simulation, entity. В этом списке нет delivered_after / start_date, поэтому ограничение последними 12 месяцами применяется в Power Query после полного обхода. Поля, используемые в каждом результате: id, simulation, entity, status, targeted_at, delivered_at, bounced_at, opened_at, clicked_at, attachment_opened_at, credential_submitted_at, reported_at, reported_before_interaction, bot_activity_detected, email_subject, sender_email, difficulty_level, created_at, updated_at.

​

Уровень детализации

Одна строка на каждую сущность, у которой есть хотя бы один результат с delivered_at за последние 12 календарных месяцев. Пользователь, который был выбран целевым, но которому ничего не было доставлено, не отображается. Несколько симуляций для одного и того же пользователя здесь объединяются. Расход запросов: один постраничный обход всех результатов симуляций в организации плюс один обход сущностей. Всегда задавайте limit = "500".

​

Приоритет результатов (last_5_assessments)

Каждый из пяти последних доставленных результатов (delivered_at по убыванию) обобщается как YYYY-MM-DD: <outcome>. Побеждает первая подходящая временная метка, начиная с наивысшего приоритета: Только доставка — это no action (сообщение дошло, пользователь ничего не сделал). Пользователь, который перешел по ссылке, а затем сообщил о фишинге, получает метку clicked: сообщение о фишинге не имеет приоритета над рискованным взаимодействием в этом списке. Строки, помеченные как бот, также получают метку результата по имеющимся временным меткам; они лишь не увеличивают счетчики кликов и ввода учетных данных. Текущая серия кликов: просматривайте те же доставленные результаты от новых к старым и подсчитывайте подряд идущие строки, в которых clicked_at не равно null и bot_activity_detected не равно true. Остановитесь на первой строке, не удовлетворяющей условию.

​

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

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

​

Отличия от прежней выгрузки

• Активность ботов исключена из подсчета кликов и ввода учетных данных. Выгрузка предыдущего поставщика учитывала взаимодействия автоматических сканеров и ботов как клики и ввод учетных данных. Этот запрос их не учитывает. Результат с bot_activity_detected = true по-прежнему является доставленной симуляцией — он учитывается в total_received и в агрегатах сообщений о фишинге, — но рассматривается как отсутствие клика и отсутствие ввода данных: он не входит в clicks / credential_submissions и прерывает текущую серию кликов. Не «исправляйте» это, учитывая ботов ради соответствия прежней выгрузке.
• Сообщение о фишинге не имеет приоритета над кликом в last_5_assessments. Пользователь, который перешел по ссылке, а затем сообщил о фишинге, получает метку clicked.
• Дополнительные данные каталога опускаются, а не заполняются null. Подразделение и аналогичные поля отсутствуют в /v1.
• Нет фильтра по времени на стороне сервера. В GET /v1/simulation_results нет delivered_after. Запрос обходит все результаты, а затем оставляет delivered_at за последние 12 календарных месяцев. Для крупной организации с большой историей это может потребовать большего расхода лимита запросов на ключ, чем при использовании отфильтрованного списка.

​

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