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

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

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

training.completed — проходит обучение по безопасности
training.past.due — имеет просроченное обучение
phishing.simulation.clicked — перешёл по ссылке в симуляции, не сообщив о ней

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

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

Учётные данные	Описание
Ключ API	Bearer-токен Reporting API, созданный в разделе Account Settings → API. Передаётся в каждом запросе в заголовке `Authorization: Bearer`.
Reporting API server region	Регион, в котором развёрнута ваша учётная запись KnowBe4; выбирается из списка (США, ЕС, Канада, Великобритания, Германия).

Области доступа (scopes): настраивать нечего — токены KnowBe4 Reporting API по своей конструкции доступны только для чтения и не ограничиваются областями доступа. Токен предоставляет доступ на чтение к пользователям, назначениям обучения и результатам тестов безопасности по фишингу — именно эти данные считывает синхронизация. Необходимая роль: Account Admin в KnowBe4 (только администраторы учётной записи имеют доступ к разделу Account Settings → API)

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

Вы должны войти в консоль KnowBe4 с ролью Account Admin. Только администраторы учётной записи имеют доступ к разделу Account Settings → API, где можно включить Reporting API и создать токены.

Часть A. В KnowBe4

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

Включите Reporting API и создайте токен

Войдите в консоль KnowBe4.
Нажмите на имя своей учётной записи в правом верхнем углу и выберите Account Settings.
В левой навигационной панели выберите API.
Включите Reporting API, если он ещё не включён, а затем создайте новый токен API.

Если консоль запросит назначение токена, укажите понятное описание (например, Living Security Platform).

KnowBe4 показывает значение токена API только один раз — при его создании. Сразу скопируйте его и сохраните в надёжном месте (например, в хранилище паролей или менеджере секретов). Если вы покинете страницу, не скопировав токен, потребуется создать новый.

Reporting API доступен только для чтения. Он предоставляет данные о пользователях, назначениях обучения и результатах тестов безопасности по фишингу — то есть данные, которые Living Security получает для расчёта оценок и формирования отчётов. Доступ на запись не требуется.

Добавьте egress-IP-адреса Living Security в список Allowed IP Addresses

KnowBe4 позволяет ограничить доступ к Reporting API определённым набором исходных IP-адресов. Этот параметр находится там же, где и токен:

В консоли KnowBe4 перейдите в Account Settings → API → Allowed IP Addresses.
Добавьте в список разрешённых каждый egress-IP-адрес Living Security. Одни и те же четыре адреса применяются во всех регионах.

Если список Allowed IP Addresses настроен, он применяется на сетевом уровне. Диалог подключения успешно пройдёт аутентификацию, но синхронизация данных завершится ошибкой (будет заблокирована на сетевом уровне, как правило, это проявляется как 403), пока egress-IP-адреса Living Security не будут добавлены в список разрешённых. Если вы добавляете в этот список любой адрес, необходимо также добавить диапазоны Living Security, иначе наши запросы будут отклоняться, даже если токен действителен.

Egress-IP-адреса Living Security могут меняться при обновлении инфраструктуры, хотя такие изменения происходят редко. Если синхронизация данных, ранее работавшая, начала завершаться ошибками, обратитесь к разделу Настройка egress-IP-адресов интеграций и убедитесь, что список Allowed IP Addresses соответствует актуальным адресам.

Определите регион сервера KnowBe4

KnowBe4 предоставляет Reporting API с регионального хоста. Регион выбирается в диалоге подключения, вводить имя хоста не нужно:

Регион	Хост Reporting API
США	`us.api.knowbe4.com`
Европа	`eu.api.knowbe4.com`
Канада	`ca.api.knowbe4.com`
Великобритания	`uk.api.knowbe4.com`
Германия	`de.api.knowbe4.com`

Если вы не уверены, какой регион использует ваша учётная запись, проверьте домен в URL консоли KnowBe4 или обратитесь к администратору KnowBe4.

Living Security может подключаться только к этим пяти регионам. Если ваша учётная запись KnowBe4 находится на другом сервере (например, в экземпляре для правительства США), обратитесь в службу поддержки Living Security, прежде чем начинать подключение.

Часть B. В Living Security Platform

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

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

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

401 Unauthorized

Токен API недействителен или срок его действия истёк. Убедитесь, что токен указан верно и не был повторно создан в разделе Account Settings → API.

403 Forbidden

Либо у токена нет доступа к Reporting API, либо IP-адрес запроса отсутствует в списке Allowed IP Addresses. Убедитесь, что Reporting API включён и что все четыре egress-IP-адреса Living Security добавлены в список разрешённых.

Пустые результаты (200 OK, но данных нет)

Возможно, в Reporting API пока нет данных для возврата, либо у учётной записи токена нет доступа к пользователям и кампаниям, которые получает Living Security. Убедитесь, что токен создан пользователем с ролью Account Admin.

Интеграции