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

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

> Подключите NINJIO к 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 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="NINJIO" />

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

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

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

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

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

| Учётные данные | Описание |
| - | - |
| **Ключ API** | Ключ API NINJIO с правом чтения для точек доступа сотрудников, обучения и фишинга. Living Security передаёт его в каждом запросе. |

**Области доступа:** NINJIO задаёт области доступа для каждого ключа API отдельно для каждой *точки доступа*, с раздельными правами на чтение и запись. Living Security требуется право **чтения** для трёх точек доступа: сотрудников, обучения и фишинга. Право записи не требуется, и предоставлять его не следует.

**Необходимая роль:** **Администратор** в вашей учётной записи NINJIO. Только администраторы имеют доступ к разделу «Integration», в котором создаются ключи.

<Warning>
  **NINJIO показывает новый ключ только один раз — в момент его создания.** Скопируйте его сразу в Living Security Platform или в хранилище паролей, прежде чем покинуть страницу. Ключ, который вы не скопировали, невозможно получить повторно — потребуется создать новый.
</Warning>

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

| Данные | Подробности |
| - | - |
| **Обучающиеся** | Справочник сотрудников NINJIO: имя, адрес электронной почты, подразделение, должность, руководитель, страна, филиал и статус активности. |
| **Обучение** | Кому назначено каждое обучение и кто его завершил — с датой завершения, оценкой за экзамен и оценкой вовлечённости. |
| **Фишинг** | Кто взаимодействовал с имитацией фишингового письма и кто сообщил о ней, с указанием времени события. |

<Note>
  **Номера телефонов обучающихся не сохраняются.** NINJIO возвращает номер телефона в записи сотрудника. Living Security удаляет его до сохранения данных, поскольку ни одна функция Living Security его не использует.
</Note>

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

* Учётная запись NINJIO с доступом к API.
* Доступ администратора к [admin.goninjio.com](https://admin.goninjio.com/).
* Адреса электронной почты обучающихся в NINJIO, совпадающие с адресами, которые используются в других подключённых системах. По адресу электронной почты Living Security сопоставляет обучающегося NINJIO с конкретным человеком.

***

## Часть A. В NINJIO

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

<Steps>
  <Step title="Откройте раздел Integration">
    1. Войдите в [admin.goninjio.com](https://admin.goninjio.com/) как администратор.
    2. Выберите **Integration** в правом верхнем углу экрана.
  </Step>

  <Step title="Создайте ключ API">
    1. Выберите **New API Key**.
    2. Задайте ключу имя, которое вы сможете легко узнать впоследствии, например `Living Security`.
    3. Предоставьте доступ на **чтение** к точкам доступа **employee**, **training** и **phishing**.
    4. Не выбирайте доступ на запись. Living Security только считывает данные из NINJIO.
    5. Выберите **Generate Key**.

    <Warning>
      Скопируйте ключ сейчас. NINJIO отображает его один раз и не может показать повторно.
    </Warning>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Поле | Значение |
    | - | - |
    | **Ключ API** | Ключ, созданный в части A |
  </ConnectInPlatform>
</Steps>

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

***

## Как часто данные извлекаются

| Данные | Расписание |
| - | - |
| Обучающиеся | Ежедневно |
| Результаты обучения | Каждые 6 часов |
| Результаты фишинга | Каждые 6 часов |

При первом подключении Living Security извлекает данные о завершении обучения за последние 12 месяцев, а затем обновляет их инкрементально. Симуляции фишинга считываются по одному разу и повторно проверяются в течение двух недель после завершения, чтобы учитывались поздние переходы по ссылкам и поздние сообщения о фишинге.

<Note>
  При первом подключении к крупной учётной записи NINJIO для считывания всех данных может потребоваться несколько запусков по расписанию. Каждый запуск считывает максимально возможный объём, а следующий продолжает с того места, где остановился предыдущий, поэтому значения растут на протяжении первых одного-двух дней, а не появляются сразу.
</Note>

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Ключ API неверен или неполон. Наиболее частая причина — ключ, скопированный не полностью: NINJIO показывает его один раз, поэтому обрезанную вставку легко допустить, а впоследствии невозможно заметить. Создайте в NINJIO новый ключ и выполните повторное подключение с ним.
  </Accordion>

  <Accordion title="403 Forbidden">
    Это **не** проблема с учётными данными. Ключ прошёл аутентификацию, но для одной из необходимых ему точек доступа не предоставлено право чтения.

    Повторная вставка того же ключа не поможет. В NINJIO создайте ключ с правом **чтения** для всех трёх точек доступа — employee, training и phishing — и выполните повторное подключение с ним.
  </Accordion>

  <Accordion title="Подключение выполнено, но данные об обучении отсутствуют">
    Проверьте в NINJIO, что хотя бы одна кампания обучения **активна** и к ней привязана симуляция. Кампания без симуляции остаётся неактивной и ничего не доставляет, поэтому получать нечего.

    Если кампании активны, убедитесь, что в записях обучающихся в NINJIO указаны адреса электронной почты. Обучающегося без адреса электронной почты невозможно сопоставить с человеком, поэтому он пропускается.
  </Accordion>

  <Accordion title="Обучение отображается как назначенное, но не завершённое">
    Это ожидаемое отображение для обучения, которое обучающийся не завершил. Living Security фиксирует назначение в момент запуска симуляции в NINJIO, а завершение фиксирует отдельно, когда NINJIO передаёт дату завершения.
  </Accordion>

  <Accordion title="Некоторые обучающиеся отсутствуют">
    Living Security сопоставляет обучающегося NINJIO с человеком по **адресу электронной почты**. Обучающийся, адрес которого в NINJIO отличается от адреса в вашем справочнике (личный адрес, прежний домен или опечатка), сопоставлен не будет.

    Исправьте адрес в NINJIO, и при следующем извлечении по расписанию сопоставление будет выполнено.
  </Accordion>

  <Accordion title="Отсутствуют результаты фишинга для более ранней симуляции">
    Living Security повторно проверяет симуляцию фишинга в течение двух недель после её завершения, а затем прекращает проверку. Результаты, которые NINJIO зафиксирует после этого периода, не будут получены. Если необходимо повторно считать более раннюю симуляцию, обратитесь в службу поддержки.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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