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

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

> Подключите Adaptive Security к 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="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. См. раздел [как данные интеграции превращаются в сигналы](/ru/signals/data-sources).

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

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

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

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

**Доступ:** только чтение. Living Security только считывает данные из Adaptive Security и никогда ничего не создаёт, не изменяет и не удаляет в вашей учётной записи.

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

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

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

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

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

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

***

## Часть A — в Adaptive Security

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

<Steps>
  <Step title="Откройте настройки API">
    1. Войдите на [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) как администратор.
    2. Перейдите в раздел **Settings → API**.
  </Step>

  <Step title="Создайте токен API">
    1. Создайте новый токен API.
    2. Задайте ему имя, которое вы сможете узнать позднее, например `Living Security`.
    3. Убедитесь, что роль токена позволяет читать данные о пользователях, кампаниях фишинга и кампаниях обучения.
    4. Скопируйте токен.

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

***

## Часть B — в Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Поле | Значение |
    | - | - |
    | **API token** | Токен, созданный в части A |
  </ConnectInPlatform>
</Steps>

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

***

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

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

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

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Токен API неверен, срок его действия истёк или он был отозван. При этой ошибке Adaptive возвращает пустое тело ответа, поэтому дополнительных сведений нет. Создайте новый токен в разделе **Settings → API** и повторите подключение с ним. Частично скопированный токен приводит к такой же ошибке и является наиболее частой причиной.
  </Accordion>

  <Accordion title="403 Forbidden">
    Токен прошёл аутентификацию, но его роль не позволяет читать запрашиваемые данные. Повторная вставка того же токена не поможет. В Adaptive убедитесь, что роль токена имеет доступ на чтение к данным о пользователях, фишинге и обучении, либо выпустите токен для роли, которая обладает таким доступом.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive ограничил частоту запросов для подключения. Living Security останавливает текущий запуск и возобновляет работу с того же места при следующем запуске по расписанию, поэтому данные не теряются — показатели просто растут дольше. Если проблема сохраняется в течение нескольких дней, обратитесь в службу поддержки Adaptive Security, чтобы узнать об ограничении частоты запросов для вашей учётной записи.
  </Accordion>

  <Accordion title="Люди отображаются, но результаты симуляций отсутствуют">
    Убедитесь, что ожидаемые кампании действительно были запущены. Adaptive сообщает о зачислениях только для отправленных симуляций, поэтому кампания в статусе **Черновик** или **запланировано** ничего не передаёт, пока не будет отправлена. Living Security намеренно не считывает такие кампании, чтобы расходовать лимит запросов на кампании с реальными результатами.
  </Accordion>

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

<PublicIntegrationNextSteps />


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