Połącz integrację

Podłączenie integracji łączy Twoje konto usługi zewnętrznej — takiej jak Slack lub GitHub — z Twoją aplikacją Kliv, dzięki czemu Twoja aplikacja może z nią współpracować. Robisz to samodzielnie w ustawieniach Kliv; po podłączeniu Kliv przechowuje dane uwierzytelniające w bezpieczny sposób, dzięki czemu Twoja aplikacja może zacząć z nich korzystać.

Na tej stronie opisano proces łączenia i informacje przechowywane przez Kliv.

Przepływ połączenia

  1. Przejdź do Ustawienia → Integracje.
  2. Wybierz z katalogu integrację, którą chcesz.
  3. Wybierz Połącz. Dalsze działania zależą od usługi:
    • Zaloguj się do usługi. Większość integracji (Slack, Notion, HubSpot i inne) wysyła Cię do tej usługi w celu zalogowania się i zatwierdzenia dostępu, a następnie powoduje powrót do Kliv. Wyrażasz zgodę na działanie Kliv w Twoim imieniu – nie kopiujesz samodzielnie żadnych kluczy.
    • Zainstaluj aplikację. Niektóre, np. GitHub, proszą Cię o zainstalowanie aplikacji Kliv na swoim koncie lub w organizacji i wybranie zakresu, do którego może ona sięgać.
    • Wklej klucz. Kilka usług łączy się poprzez wklejenie klucza dostępu z ustawień tej usługi. Kliv przechowuje go dla Ciebie w skarbcu.
  4. Kiedy wrócisz do Kliv, integracja wyświetli się jako połączona i gotowa do użycia.

Możesz połączyć więcej niż jedno konto dla tej samej usługi — na przykład dwa obszary robocze Slack — i wybrać, z którego korzysta dana część Twojej aplikacji.

Co przechowuje dla Ciebie Kliv

Po nawiązaniu połączenia Kliv zapisuje dane uwierzytelniające tej usługi w bezpiecznym skarbcu. Kilka rzeczy, które warto wiedzieć:

  • Dane uwierzytelniające znajdują się w skarbcu Kliv, nigdy w kodzie aplikacji. Osoby odwiedzające Twoją aplikację nie mogą ich zobaczyć i nigdy nie musisz samodzielnie zarządzać tokenami.
  • Kliv dostarcza dane uwierzytelniające za kulisami. Kiedy Twoja aplikacja wykonuje wywołanie, Kliv dołącza odpowiednie dane uwierzytelniające po stronie serwera. Kod Twojej aplikacji opisuje tylko co zrobić, a nigdy jak się uwierzytelnić.
  • Niektóre połączenia odświeżają się automatycznie. W przypadku usług, do których dostęp wygasa, Kliv odnawia go za Ciebie. Jeśli usługa kiedykolwiek odbierze dostęp — na przykład usunąłeś po jej stronie aplikację Kliv — integracja poprosi Cię o ponowne połączenie.

Zarządzanie i odłączanie

Z tego samego obszaru Integracje możesz przejrzeć podłączoną integrację, ustawić kto ma prawo z niej korzystać, skonfigurować wyzwalacze zdarzeń lub ją odłączyć. Odłączenie powoduje usunięcie zapisanych danych uwierzytelniających i uniemożliwia aplikacji korzystanie z tej usługi.

Jeśli coś pójdzie nie tak

  • „Nie połączono” — integracja nie została jeszcze połączona lub dostęp do niej został usunięty. Połącz (lub podłącz ponownie) z poziomu Ustawienia → Integracje.
  • „Wymagane ponowne połączenie” — usługa zewnętrzna odebrała dostęp Kliv. Otwórz integrację i podłącz ją ponownie.
  • Więcej niż jedno połączenie — jeśli Twoja aplikacja ma kilka kont połączonych w ramach tej samej usługi, konieczne może być wskazanie jej, którego z nich ma używać — strona każdego połączenia pokazuje selektor połączenia, czyli krótką etykietę, której Twoja aplikacja używa do wyboru między nimi.

Zobacz też