Підключення інтеграції

Підключення інтеграції пов’язує ваш обліковий запис у зовнішньому сервісі — як-от Slack чи GitHub — із вашим застосунком Kliv, щоб застосунок міг із ним працювати. Ви робите це самі в налаштуваннях Kliv; після підключення Kliv зберігає облікові дані в безпеці, і ваш застосунок може почати їх використовувати.

На цій сторінці описано процес підключення та те, що Kliv зберігає для вас.

Процес підключення

  1. Перейдіть до Налаштування → Інтеграції.
  2. Виберіть потрібну інтеграцію з каталогу.
  3. Виберіть Підключити. Що буде далі, залежить від сервісу:
    • Увійдіть у сервіс. Більшість інтеграцій (Slack, Notion, HubSpot та інші) спрямовують вас до цього сервісу для входу та підтвердження доступу, а потім повертають до Kliv. Ви надаєте Kliv дозвіл діяти від вашого імені — ви не копіюєте жодних ключів самі.
    • Установіть застосунок. Деякі, як-от GitHub, просять вас установити застосунок Kliv у ваш обліковий запис чи організацію та вибрати, до чого він має доступ.
    • Вставте ключ. Кілька сервісів підключаються через вставлення ключа доступу з налаштувань цього сервісу. Kliv зберігає його для вас у сховищі.
  4. Коли ви повертаєтеся до Kliv, інтеграція відображається як підключена та готова до використання.

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

Що Kliv зберігає для вас

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

  • Облікові дані зберігаються у сховищі Kliv, ніколи в коді вашого застосунку. Відвідувачі вашого застосунку не бачать їх, і вам ніколи не доводиться самостійно керувати токенами.
  • Kliv надає облікові дані за лаштунками. Коли ваш застосунок здійснює виклик, Kliv додає правильні облікові дані на стороні сервера. Код вашого застосунку описує лише те, що робити, а не те, як автентифікуватися.
  • Деякі підключення оновлюються автоматично. Для сервісів, доступ до яких спливає, Kliv поновлює його за вас. Якщо сервіс колись відкликає доступ — наприклад, ви видалили застосунок Kliv на його боці — інтеграція попросить вас підключитися знову.

Керування або відключення

У тій самій області «Інтеграції» ви можете переглянути підключену інтеграцію, налаштувати кому дозволено нею користуватися, налаштувати тригери подій або відключити її. Відключення видаляє збережені облікові дані та припиняє використання цього сервісу вашим застосунком.

Якщо щось піде не так

  • «Не підключено» — інтеграцію ще не підключено або її доступ було відкликано. Підключіть (або підключіть повторно) її в розділі Налаштування → Інтеграції.
  • «Потрібне повторне підключення» — зовнішній сервіс відкликав доступ Kliv. Відкрийте інтеграцію та підключіть її знову.
  • Більш ніж одне підключення — якщо ваш застосунок має кілька облікових записів, підключених для одного сервісу, вам, можливо, доведеться вказати, який із них використовувати — сторінка кожного підключення показує селектор підключення, коротку мітку, яку ваш застосунок використовує, щоб вибирати між ними.

Пов’язане