Настройка интеграции с Adaptive Security

Какие данные предоставляет эта интеграция

Adaptive Security может передавать данные о сотрудниках, обучении и результатах многоканальных симуляций. Среди проверенных примеров:

phishing.simulation.clicked — переход по ссылке в имитированном электронном письме без сообщения о нём
phishing.simulation.credential.submitted — ввод учётных данных на имитированной странице входа
phishing.simulation.attachment.opened — открытие вложения в имитированном электронном письме
phishing.simulation.reported — сообщение об имитированном электронном письме
smishing.simulation.replied — ответ на имитированное текстовое сообщение
vishing.simulation.succeeded — выполнение требований имитированного голосового звонящего
training.assigned — назначение обучения по информационной безопасности
training.completed — завершение обучения по информационной безопасности
training.past.due — пропуск срока прохождения обучения

Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. раздел как данные интеграции превращаются в сигналы.

Adaptive проводит симуляции по трём каналам, и Living Security оценивает каждый из них отдельно. Результаты по электронной почте оцениваются как фишинг, результаты по текстовым сообщениям — как смишинг, а результаты по голосовым звонкам — как вишинг. Сотрудник, перешедший по ссылке в имитированном письме, и сотрудник, ответивший на имитированное текстовое сообщение, оцениваются не как одинаковое поведение, поскольку решения, принятые каждым из них, различаются.

Что необходимо Living Security

Учётные данные	Описание
API token	Токен API Adaptive Security. Living Security передаёт его как bearer-токен в каждом запросе.

Необходимая роль: администратор вашей учётной записи Adaptive Security с доступом к разделу Settings → API. Adaptive управляет доступом к API с помощью разрешений на основе ролей, поэтому токен должен принадлежать роли, которая может читать данные о пользователях, фишинге и обучении. Доступ: только чтение. Living Security только считывает данные из Adaptive Security и никогда ничего не создаёт, не изменяет и не удаляет в вашей учётной записи.

Какие данные получает Living Security

Данные	Подробности
Люди	Ваш каталог пользователей Adaptive: имя, адрес электронной почты, подразделение, должность, имя и адрес электронной почты руководителя, местоположение, отдел, статус занятости и дата начала работы.
Симуляции по электронной почте	По каждому человеку и каждой симуляции: когда сообщение было доставлено, открыто, когда по нему перешли по ссылке, когда на него ответили, когда открыли вложение, отсканировали QR-код, ввели учётные данные или сообщили о нём.
Симуляции по текстовым сообщениям	По каждому человеку и каждой симуляции: доставлено, открыто, выполнен переход по ссылке, получен ответ, введены учётные данные или отправлено сообщение о нём.
Голосовые симуляции	По каждому человеку и каждой симуляции: доставленная приманка, набранный номер, выполнил ли человек требования звонящего и сообщил ли он о звонке.
Обучение	По каждому человеку и каждой кампании: когда он был зачислен, срок завершения, когда он начал обучение, когда завершил его и подтвердил ли ознакомление с политикой кампании.

Номера телефонов не сохраняются. Adaptive возвращает рабочие и мобильные номера в записи пользователя. Living Security удаляет оба номера до сохранения каких-либо данных, поскольку ни одна функция Living Security их не использует.

Собственная оценка риска Adaptive записывается, но не используется при расчёте. Adaptive вычисляет current_risk_score для каждого человека. Living Security сохраняет его, чтобы вы могли сравнивать две системы, но Индекс человеческого риска всегда рассчитывается на основе наблюдаемого поведения по собственной опубликованной модели Living Security — а не по составной оценке другого поставщика.

Предварительные требования

Учётная запись Adaptive Security с включённым API.
Доступ администратора к admin.adaptivesecurity.com.
Адреса электронной почты пользователей в Adaptive, совпадающие с адресами, которые используются в других подключённых системах. Living Security сопоставляет пользователя Adaptive с человеком по адресу электронной почты.

Часть A — в Adaptive Security

Эти шаги выполняет администратор Adaptive Security.

Откройте настройки API

Войдите на admin.adaptivesecurity.com как администратор.
Перейдите в раздел Settings → API.

Создайте токен API

Создайте новый токен API.
Задайте ему имя, которое вы сможете узнать позднее, например Living Security.
Убедитесь, что роль токена позволяет читать данные о пользователях, кампаниях фишинга и кампаниях обучения.
Скопируйте токен.

Скопируйте токен, прежде чем покинуть страницу. Если в вашей учётной записи Adaptive для токена установлен срок действия, запишите дату: после истечения срока Living Security не сможет получать данные, и подключение необходимо будет обновить с новым токеном.

Часть B — в Living Security Platform

Этот шаг выполняет владелец программы или системный администратор при делегированной настройке.

Подключение к Adaptive Security выполнено.

Как часто данные получаются

Данные	Расписание
Люди	Каждые 6 часов
Результаты симуляций (электронная почта, текстовые сообщения, голос)	Каждые 6 часов
Результаты обучения	Каждые 6 часов

API отчётности Adaptive не предоставляет фильтр «что изменилось с определённого момента», поэтому Living Security считывает каждую кампанию симуляции и обучения, пока она ещё формирует результаты, и прекращает чтение спустя две недели после её закрытия. Таким образом, поздние переходы по ссылкам и поздние сообщения всё равно учитываются, а завершённые кампании не перечитываются бесконечно.

При первом подключении крупной учётной записи Adaptive для чтения всех данных может потребоваться несколько запусков по расписанию. Каждый запуск считывает столько данных, сколько может, а следующий продолжает с того места, где остановился предыдущий, поэтому показатели растут в течение первых одного–двух дней, а не появляются сразу.

Устранение неполадок

401 Unauthorized

Токен API неверен, срок его действия истёк или он был отозван. При этой ошибке Adaptive возвращает пустое тело ответа, поэтому дополнительных сведений нет. Создайте новый токен в разделе Settings → API и повторите подключение с ним. Частично скопированный токен приводит к такой же ошибке и является наиболее частой причиной.

403 Forbidden

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

429 Too Many Requests

Adaptive ограничил частоту запросов для подключения. Living Security останавливает текущий запуск и возобновляет работу с того же места при следующем запуске по расписанию, поэтому данные не теряются — показатели просто растут дольше. Если проблема сохраняется в течение нескольких дней, обратитесь в службу поддержки Adaptive Security, чтобы узнать об ограничении частоты запросов для вашей учётной записи.

Люди отображаются, но результаты симуляций отсутствуют

Убедитесь, что ожидаемые кампании действительно были запущены. Adaptive сообщает о зачислениях только для отправленных симуляций, поэтому кампания в статусе Черновик или запланировано ничего не передаёт, пока не будет отправлена. Living Security намеренно не считывает такие кампании, чтобы расходовать лимит запросов на кампании с реальными результатами.

Отсутствуют голосовые симуляции или симуляции по текстовым сообщениям

Living Security определяет канал каждого результата по связанному с ним сценарию. Если сценарий был удалён в Adaptive после проведения его симуляции, результаты записываются в канал электронной почты, поскольку канал больше невозможно определить. Чтобы избежать этого, храните неиспользуемые сценарии в Adaptive, а не удаляйте их.

Интеграции