> ## 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="/uk/signals/data-sources">Дізнайтеся, як дані інтеграцій перетворюються на сигнали Human Risk Management</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>Settings → Integrations → Catalog</strong>, знайдіть плитку{' '}
        <strong>{tile}</strong> і натисніть <strong>Connect</strong>.
      </li>
      <li>
        Заповніть наведені нижче поля, а потім натисніть <strong>Connect</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. Див. [як дані інтеграції перетворюються на signals](/uk/signals/data-sources).

## Що потрібно для Living Security

| Облікові дані | Опис |
| - | - |
| **API key** | Ключ, згенерований в адміністративній консолі CultureAI. Living Security надсилає цей ключ із кожним запитом для автентифікації в API CultureAI. Це єдині потрібні облікові дані. |

**Області доступу (scopes):** ключі API CultureAI не мають областей доступу — чинний ключ надає доступ до API. Living Security лише читає дані звітування; якщо консоль CultureAI під час створення ключа пропонує вибрати області доступу або дозволи, надайте доступ лише для читання даних звітування.

**Потрібна роль:** **Admin** або **Owner** у CultureAI (для керування доступом до API)

### Передумови

* Ви маєте увійти в адміністративну консоль CultureAI з роллю, яка дозволяє керувати доступом до API, — зазвичай це роль **Admin** або **Owner**. Якщо ви не бачите розділу 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 key** | Ключ 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.