> ## 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.

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

> Подключите KnowBe4 к Living Security Platform, чтобы импортировать пользователей, назначения обучения и результаты тестов безопасности по фишингу.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Связанные ресурсы</h2>
    <ul>
      <li>
        <a href="/ru/signals/data-sources">Узнайте, как данные Интеграций преобразуются в Сигналы управления человеческими рисками</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ознакомьтесь с Интеграциями Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Откройте Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Запросите демонстрацию Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Добавьте все четыре исходящих IP-адреса синхронизации Living Security</strong> в список разрешённых адресов в{' '}
    {system}. Укажите каждый адрес как отдельный хост с суффиксом <code>/32</code>, если {system} ожидает нотацию CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Трафик может исходить с любого из этих четырёх адресов, поэтому если разрешить только часть из них, синхронизация
    будет периодически завершаться сбоями. Эти четыре адреса одинаковы во всех регионах Living Security. Полный список адресов, политику изменений и способы устранения неполадок см. в разделе{' '}
    <a href="/ru/integrations/managing/egress-ip-addresses">
      Настройка исходящих IP-адресов для интеграций
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Введите учётные данные в Living Security Platform">
    <p>
      Выполняется пользователем, имеющим доступ к Living Security: владельцем программы или
      системным администратором, если он был приглашён (делегированная настройка).
    </p>
    <ol>
      <li>
        Перейдите в раздел <strong>Настройки → Интеграции → Каталог</strong>, найдите плитку{' '}
        <strong>{tile}</strong> и нажмите <strong>Подключиться</strong>.
      </li>
      <li>
        Заполните поля ниже, затем нажмите <strong>Подключиться</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Это руководство предназначено для администратора {system}.</strong> В нём описано создание учётных данных API
      в {system}, для чего требуется доступ администратора к {system}, а не к
      Living Security Platform.
    </p>
    <p>
      Если вы являетесь <strong>владельцем программы</strong> Living Security и не администрируете {system},
      передайте эту страницу тому, кто им занимается. Этот сотрудник выполнит часть A и передаст учётные данные вам
      (или введёт их самостоятельно, если вы пригласили его в платформу).
      {recommendDelegated && <>
          {' '}Поскольку в ходе настройки создаются конфиденциальные ключевые данные, рекомендуем использовать{' '}
          <strong>делегированную настройку</strong>: в этом случае секрет не передаётся вам.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

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

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

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

Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. [как данные интеграций становятся сигналами](/ru/signals/data-sources).

## Что необходимо для 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.*

<Steps>
  <Step title="Включите Reporting API и создайте токен">
    1. Войдите в консоль KnowBe4.
    2. Нажмите на имя своей учётной записи в правом верхнем углу и выберите **Account Settings**.
    3. В левой навигационной панели выберите **API**.
    4. Включите **Reporting API**, если он ещё не включён, а затем создайте новый токен API.

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

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

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

  <Step title="Добавьте egress-IP-адреса Living Security в список Allowed IP Addresses">
    KnowBe4 позволяет ограничить доступ к Reporting API определённым набором исходных IP-адресов. Этот параметр находится там же, где и токен:

    1. В консоли KnowBe4 перейдите в **Account Settings → API → Allowed IP Addresses**.
    2. Добавьте в список разрешённых каждый [egress-IP-адрес Living Security](/ru/integrations/managing/egress-ip-addresses). Одни и те же четыре адреса применяются во всех регионах.

    <EgressIpSafelist system="KnowBe4" />

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

    <Note>
      Egress-IP-адреса Living Security могут меняться при обновлении инфраструктуры, хотя такие изменения происходят редко. Если синхронизация данных, ранее работавшая, начала завершаться ошибками, обратитесь к разделу [Настройка egress-IP-адресов интеграций](/ru/integrations/managing/egress-ip-addresses) и убедитесь, что список Allowed IP Addresses соответствует актуальным адресам.
    </Note>
  </Step>

  <Step title="Определите регион сервера 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.

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

***

## Часть B. В Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Поле | Значение |
    | - | - |
    | **Ключ API** | Токен Reporting API из части A, шаг 1 |
    | **Reporting API server region** | Регион из части A, шаг 3 (например, США) |
  </ConnectInPlatform>
</Steps>

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Токен API недействителен или срок его действия истёк. Убедитесь, что токен указан верно и не был повторно создан в разделе **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Либо у токена нет доступа к Reporting API, либо IP-адрес запроса отсутствует в списке Allowed IP Addresses. Убедитесь, что Reporting API включён и что все четыре [egress-IP-адреса Living Security](/ru/integrations/managing/egress-ip-addresses) добавлены в список разрешённых.
  </Accordion>

  <Accordion title="Пустые результаты (200 OK, но данных нет)">
    Возможно, в Reporting API пока нет данных для возврата, либо у учётной записи токена нет доступа к пользователям и кампаниям, которые получает Living Security. Убедитесь, что токен создан пользователем с ролью Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.