> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Наиболее уязвимые пользователи > Воспроизведение сводного отчета предыдущего поставщика о наиболее уязвимых пользователях за 12 месяцев на основе результатов симуляций и сущностей /v1. Этот отчет представляет собой сводку уязвимости по каждому пользователю за 12 месяцев: одна строка на каждого сотрудника, получившего хотя бы одну симуляцию за последний год, с количеством и долей кликов, ввода учетных данных и сообщений о фишинге, текущей серией кликов и объединенным списком результатов последних 5 симуляций. Окно охватывает **12 календарных месяцев** (полночь по UTC того же числа месяца двенадцатью месяцами ранее), а не промежуток в 365 дней. Взаимодействия автоматических сканеров и ботов исключаются из подсчета кликов и ввода учетных данных. Это намеренное отличие от прежней выгрузки. См. [Отличия от прежней выгрузки](#%D0%BE%D1%82%D0%BB%D0%B8%D1%87%D0%B8%D1%8F-%D0%BE%D1%82-%D0%BF%D1%80%D0%B5%D0%B6%D0%BD%D0%B5%D0%B9-%D0%B2%D1%8B%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B8). Настройка, учетные данные, постраничная выгрузка и повтор запросов при превышении лимита частоты такие же, как в [руководстве по подключению Power BI / Excel](/ru/developers/v1/powerbi). Сначала добавьте общий запрос `Fn_FetchAll`; этот отчет вызывает его по имени. ## Необходимые области действия ключа | Область действия | Назначение | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (сопоставление адреса электронной почты и отображаемого имени) | Этот отчет использует **операционный** список результатов по каждому пользователю, а не семейство предварительных отчетов. Ключ, которому предоставлено только `reporting:read`, не может вызвать `GET /v1/simulation_results` (API возвращает `403`). См. [выбор подходящей детализации](/ru/developers/v1/powerbi#%D0%B2%D1%8B%D0%B1%D0%BE%D1%80-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D1%8C%D0%BD%D0%BE%D0%B9-%D0%B4%D0%B5%D1%82%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8). ## Исходные конечные точки | Конечная точка | Роль | | - | - | | `GET /v1/simulation_results` | Результат по каждому получателю. Это уровень детализации фактов. | | `GET /v1/entities` | Сопоставляет `entity` с адресом электронной почты и отображаемым именем. В строке результата нет собственного адреса электронной почты или отображаемого имени получателя (только `entity`). | Разрешенные фильтры в списке результатов: `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: `. Побеждает первая подходящая временная метка, начиная с наивысшего приоритета: | Приоритет | Временная метка | Метка результата | | - | - | - | | 1 | `credential_submitted_at` | `credential submitted` | | 2 | `clicked_at` | `clicked` | | 3 | `attachment_opened_at` | `attachment opened` | | 4 | `reported_at` | `reported` | | 5 | `opened_at` | `opened` | | 6 | `delivered_at` | `no action` | | 7 | `bounced_at` | `bounced` | Только доставка — это `no action` (сообщение дошло, пользователь ничего не сделал). Пользователь, который перешел по ссылке, а затем сообщил о фишинге, получает метку `clicked`: сообщение о фишинге не имеет приоритета над рискованным взаимодействием в этом списке. Строки, помеченные как бот, также получают метку результата по имеющимся временным меткам; они лишь не увеличивают счетчики кликов и ввода учетных данных. **Текущая серия кликов:** просматривайте те же доставленные результаты от новых к старым и подсчитывайте подряд идущие строки, в которых `clicked_at` не равно null **и** `bot_activity_detected` не равно `true`. Остановитесь на первой строке, не удовлетворяющей условию. ## Сопоставление столбцов Названия прежних столбцов взяты из выгрузки вашего предыдущего поставщика. Поля `/v1` — это публичные имена API; запрос вычисляет количества и доли. | Прежний столбец | Поле или вычисление `/v1` | Столбец отчета | | - | - | - | | Email | `Entity.email` (сопоставление по `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Количество результатов, в которых `delivered_at` не равно null (включая строки, помеченные как бот) | `total_received` | | Clicks # | Количество строк, в которых `clicked_at` не равно null **и** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Количество строк, в которых `credential_submitted_at` не равно null **и** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Количество строк, в которых `reported_at` не равно null (включая ботов — это не клик и не ввод учетных данных) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Количество подряд идущих самых новых доставленных результатов, по которым пользователь перешел по ссылке (боты прерывают серию) | `current_click_streak` | | Last 5 assessments | Пять самых новых результатов доставленных симуляций, разделенных `"; "` (см. [приоритет](#приоритет-результатов-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Отсутствуют в `/v1` | Опускаются, а не заполняются null | Ключ соединения, сохраненный для модели типа «звезда»: `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 календарных месяцев. Для крупной организации с большой историей это может потребовать большего расхода лимита запросов на ключ, чем при использовании отфильтрованного списка. ## Дальнейшие шаги Учетные данные, постраничная выгрузка и загрузка этих запросов в Power BI или Excel. Фишинговые взаимодействия на уровне событий за последние 12 месяцев. Назначения обучения на уровне «пользователь × назначение». Предоставьте `simulation:read` и `entity:read` ключу, который обновляет этот отчет. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.