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

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

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

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

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

* `phishing.real.clicked` — переход по ссылкам в реальных фишинговых письмах
* `data.transfer.blocked` — передача данных заблокирована
* `phishing.safe.reported` — сообщения о письмах, которые позже признаны безопасными

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

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

| Учетные данные | Описание |
| - | - |
| **Ключ API** | Ключ, сгенерированный в административной консоли CultureAI. Living Security передает этот ключ в каждом запросе для аутентификации в API CultureAI. Это единственные необходимые учетные данные. |

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

**Необходимая роль:** **Администратор** или **Владелец** в CultureAI (для управления доступом к API)

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

* Вы должны войти в административную консоль CultureAI с ролью, позволяющей управлять доступом к API, — как правило, это роль **Администратор** или **Владелец**. Если раздел API или настроек для разработчиков отсутствует, обратитесь к представителю вашей учетной записи CultureAI, чтобы для вашей организации был включен доступ к API.

***

## Часть A. В CultureAI

*Эти действия выполняет администратор CultureAI.*

<Steps>
  <Step title="Создайте ключ API">
    1. Войдите в административную консоль CultureAI.
    2. Откройте настройки организации или учетной записи и найдите раздел **API** (или **API keys** / **Developer**).
    3. Создайте новый ключ API и присвойте ему описательное имя (например, `Living Security Platform`).

    <Note>
      Living Security использует этот ключ для доступа только для чтения к данным отчетности, которые импортируются из CultureAI. Доступ на запись не требуется. Если CultureAI предлагает выбрать области доступа или разрешения, предоставьте только доступ на чтение данных отчетности.
    </Note>

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

    <Note>
      Если вы не можете найти, где создать ключ API, или не уверены, какие разрешения предоставить, обратитесь к представителю вашей учетной записи CultureAI. Living Security не может создавать учетные данные CultureAI от вашего имени.
    </Note>
  </Step>
</Steps>

***

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

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

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

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Ключ API недействителен или был отозван. Убедитесь, что ключ указан верно и не был повторно сгенерирован в CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    У ключа API нет доступа на чтение данных отчетности. Убедитесь, что в CultureAI ключу предоставлен доступ на чтение, или создайте новый ключ с необходимыми разрешениями.
  </Accordion>

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

<PublicIntegrationNextSteps />


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