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

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

​

Передумови

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

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

​

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

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

​

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

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

​

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

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

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

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

​

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

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

​

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

У розділі Settings → Integrations → Syncs відкрийте будь-яку синхронізацію, щоб переглянути її конфігурацію та історію запусків в одному місці. На сторінці відомостей показано: Скористайтеся Sync Now, щоб негайно запустити синхронізацію, коли вона активна. Призупинені синхронізації потрібно відновити, перш ніж почнуться нові запуски за розкладом або вручну. Також можна відкрити синхронізацію зі сторінки відомостей про підключення, якщо інтеграція містить список активних потоків.

​

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

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

​

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. Не робіть припущень щодо цих відомостей на основі старішого посібника з інтеграції Unify. Засіб завантаження на сторінці відомостей про джерело приймає вихідний CSV-файл розміром до 100 MB. Перед завантаженням Dashboard розбиває його на стороні клієнта на запити розміром не більше 10 MB і не більше 10,000 рядків кожен. Цей засіб завантаження для окремого джерела відокремлений від загальної сторінки Integrations → Upload для шаблонів ідентичностей і активності.

​

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

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

​

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