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

# Налаштування інтеграції

> Підготуйте облікові дані провайдера, підключіть підтримувану систему, увімкніть потоки даних і переконайтеся, що перша синхронізація пройшла успішно.

Цей посібник описує загальний порядок налаштування інтеграцій, наведених у розділі **Settings → Integrations → Catalog**. Поля, дозволи та кроки автентифікації, специфічні для провайдера, наведено в посібнику з налаштування, на який веде посилання на картці цього провайдера в Catalog.

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

| Роль | Відповідальність |
| - | - |
| [**Program Owner**](/uk/reference/glossary#%D0%B2%D0%BB%D0%B0%D1%81%D0%BD%D0%B8%D0%BA-%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8) | Вибирає джерело, підключає його в Living Security, вмикає потоки та перевіряє результат |
| [**System Administrator**](/uk/reference/glossary#%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%B8%D0%B9-%D0%B0%D0%B4%D0%BC%D1%96%D0%BD%D1%96%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80) | Створює або затверджує облікові дані та області доступу (scopes) у вихідній системі |

Ці ролі може виконувати одна й та сама особа. Особа, яка вводить облікові дані в Living Security, повинна мати роль адміністратора, що дозволяє керувати інтеграціями; не запрошуйте адміністратора вихідної системи до Living Security лише на підставі припущення, що існує роль із вузьким набором прав для налаштування.

Перед початком:

* Виберіть організацію та середовище Living Security, до яких належить підключення.
* Відкрийте посібник провайдера в Catalog і зберіть необхідні області доступу (scopes), URL-адреси перенаправлення та вимоги щодо списку дозволених адрес.
* Якщо облікові дані створює та вводить різні особи, користуйтеся затвердженим в організації процесом безпечної передачі секретів.
* Ніколи не надсилайте паролі, секрети клієнта, приватні ключі або значення ключів доступу електронною поштою чи через запит до служби підтримки.

## 1. Підготуйте облікові дані провайдера

Відкрийте **Settings → Integrations → Catalog**, знайдіть провайдера й ознайомтеся з його посібником із налаштування, перш ніж створювати облікові дані.

Автентифікація провайдера може використовувати згоду OAuth, API-токен, ідентифікатор і секрет клієнта, службовий обліковий запис або інший метод, який підтримує провайдер. Створюйте лише ті облікові дані та області доступу, що зазначені в посібнику цього провайдера.

<Warning>
  Не копіюйте дозволи з іншого провайдера й не надавайте широкий доступ на
  запис «про всяк випадок». Відсутні дозволи зазвичай призводять до зрозумілої
  помилки 401 або 403, яку можна виправити; надмірні дозволи створюють
  непотрібний ризик.
</Warning>

## 2. Підключіть провайдера

<Steps>
  <Step title="Відкрийте Catalog">
    Перейдіть до **Settings → Integrations → Catalog** і виберіть провайдера.
  </Step>

  <Step title="Почніть підключення">
    Виберіть **Connect**. Виконайте процес OAuth або введіть поля, які запитує
    діалогове вікно підключення. У посібнику провайдера пояснено, звідки
    отримати кожне значення.
  </Step>

  <Step title="Завершіть автентифікацію">
    Якщо потрібно, підтвердьте екран згоди провайдера. Після успішної автентифікації Living Security відкриває нове підключення або показує його в розділі **Connected**.
  </Step>
</Steps>

Якщо провайдер відхиляє автентифікацію, зупиніться й виправте облікові дані, тенант, регіон, URL-адресу перенаправлення або дозволи у вихідній системі, перш ніж продовжувати.

## 3. Увімкніть потоки даних

Відкрийте підключення в розділі **Settings → Integrations → Connected**. Living Security визначає шаблони синхронізації, доступні для цього провайдера, і показує їх як потоки.

1. Перегляньте назву та призначення кожного потоку.
2. Вмикайте лише ті потоки, які потрібні вашій програмі.
3. Залиште непотрібні потоки призупиненими.
4. За наявності скористайтеся **Sync Now**, щоб запросити перший запуск.

Не кожен провайдер пропонує однакові потоки чи елементи керування розкладом. Користуйтеся елементами керування, наведеними в підключенні, і не очікуйте універсальної частоти, області, зіставлення полів, чернетки або майстра активації.

## 4. Перевірте перший запуск

Сама автентифікація підключення не доводить, що дані надходять.

<Steps>
  <Step title="Перевірте стан підключення">
    Переконайтеся, що підключення справне й не запитує повторної авторизації.
  </Step>

  <Step title="Перевірте стан потоку">
    Переконайтеся, що потрібний потік увімкнений, а не призупинений.
  </Step>

  <Step title="Перегляньте останній запуск">
    Відкрийте потік, посилання на синхронізацію підключення або **Settings** → **Integrations** → **Syncs**. Дочекайтеся успішного кінцевого результату та перегляньте помилки провайдера й кількість записів, якщо вони доступні.
  </Step>

  <Step title="Підтвердьте наявність даних у подальших системах">
    Відкрийте відповідну частину Living Security. Дані про ідентичності мають створити очікуваних людей та ідентичності в Workforce; дані із джерел безпеки мають з’явитися у функції, описаній для цього провайдера.
  </Step>
</Steps>

Під час онбордингу завдання **Verify Identity Data Flowing** і **Verify Integration Data Flowing** у Journey Map виконуються на основі отриманих даних. Не замінюйте результати цієї перевірки збереженим підключенням.

## Сторінка відомостей про синхронізацію

У розділі **Settings** → **Integrations** → **Syncs** відкрийте будь-яку синхронізацію, щоб переглянути її конфігурацію та історію запусків в одному місці.

На сторінці відомостей показано:

| Розділ | Що він містить |
| - | - |
| **Header** | Назва синхронізації, значок статусу та провайдер інтеграції |
| **Statistics** | Модель, остання синхронізація, завершені запуски та загальна кількість записів |
| **Run history** | Останні запуски зі статусом, часом виконання та кількістю записів |
| **Actions** | **Refresh**, **Pause** / **Resume** і **Sync Now** |

Скористайтеся **Sync Now**, щоб негайно запустити синхронізацію, коли вона активна. Призупинені синхронізації потрібно відновити, перш ніж почнуться нові запуски за розкладом або вручну.

Також можна відкрити синхронізацію зі сторінки відомостей про підключення, якщо інтеграція містить список активних потоків.

## Операції з підключенням

Сторінка відомостей про підключення надає операції, які підтримує відповідна інтеграція:

| Операція | Результат |
| - | - |
| **Sync Now** | Запитує негайний запуск для вибраного потоку |
| **Pause stream** | Зупиняє нові запуски цього потоку, зберігаючи підключення |
| **Pause connection** | Зупиняє підтримувану активність підключення без видалення конфігурації |
| **Resume** | Відновлює призупинений потік або підключення |
| **Reauthorize** | Повторює автентифікацію після зміни облікових даних або згоди |
| **Remove** | Видаляє конфігурацію підключення після підтвердження |

Видалення підключення не рівнозначне видаленню даних, які вже були отримані з нього. Якщо поведінка зберігання даних впливає на ваше рішення, ознайомтеся з посібником провайдера або зверніться до служби підтримки.

## Custom Push Sources

Використовуйте **Custom Push Source**, коли система надсилає дані до Living Security, а не опитується через конектор із Catalog.

1. Створіть джерело внизу сторінки **Catalog**.
2. Відкрийте його сторінку відомостей в області custom push.
3. Виберіть цільовий потік.
4. Скористайтеся **Upload CSV** для ручного пакета або **Push via API** для автоматизованого відправника.
5. Після надсилання перегляньте файл або вміст запиту й історію запусків джерела.

Повний опис кінцевої точки, автентифікації, вмісту запиту, повторних спроб і перевірки див. у [Custom Push Source API](/uk/integrations/custom-push-source). Не робіть припущень щодо цих відомостей на основі старішого посібника з інтеграції Unify.

Засіб завантаження на сторінці відомостей про джерело приймає вихідний CSV-файл розміром до 100 MB. Перед завантаженням Dashboard розбиває його на стороні клієнта на запити розміром не більше 10 MB і не більше 10,000 рядків кожен. Цей засіб завантаження для окремого джерела відокремлений від загальної сторінки **Integrations → Upload** для шаблонів ідентичностей і активності.

## Усунення несправностей

| Симптом | Що перевірити |
| - | - |
| `401 Unauthorized` | Значення облікових даних, термін дії, відкликання, тенант провайдера та стан повторної авторизації |
| `403 Forbidden` | Необхідну роль у провайдера, області доступу (scopes), згоду адміністратора та політику доступу вихідної системи |
| Підключення одразу завершується помилкою | URL-адресу перенаправлення, регіон, URL джерела, вимоги до мережі або списку дозволених IP-адрес |
| Підключення справне, але запусків немає | Чи ввімкнено потрібний потік і чи надає провайдер цей потік |
| Успішний запуск не повертає записів | Чи бачить обліковий запис джерела очікувану сукупність і чи правильні фільтри на боці провайдера |
| Дані з’являються в іншої особи | Чи узгоджені атрибути ідентичності та псевдоніми між підключеними джерелами |
| Дані перестають оновлюватися | Чи не призупинено потік або підключення, чи не минув термін дії облікових даних, чи не завершився невдачею останній запуск |

Звертаючись до [служби підтримки Living Security](mailto:support@livingsecurity.com), зазначте організацію, провайдера, назву підключення, потік, час останнього запуску та видиму помилку. Не включайте секрети.

## Пов’язані матеріали

<CardGroup cols={2}>
  <Card title="Огляд Integrations" icon="grid-2" href="/uk/integrations/overview">
    Довідка щодо Connected, Catalog, Syncs, Actions і Upload.
  </Card>

  <Card title="Зіставлення даних" icon="arrows-left-right" href="/uk/integrations/managing/data-mapping">
    Відомості про підтримувані атрибути та зіставлення, де вони доступні.
  </Card>

  <Card title="Життєвий цикл інтеграції" icon="route" href="/uk/integrations/managing/lifecycle">
    Керування наявною інтеграцією, зокрема повторна авторизація або видалення.
  </Card>

  <Card title="Онбординг адміністратора" icon="circle-check" href="/uk/getting-started/onboarding">
    Виконайте завдання з перевірки даних про ідентичності та даних безпеки.
  </Card>
</CardGroup>


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