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
- Przejdź do Ustawienia → Integracje.
- Wybierz z katalogu integrację, którą chcesz.
- 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.
- 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ż
- Co możesz podłączyć — dostępne integracje i to, co odblokowują.
- Kontroluj, kto może korzystać z łącznika — ustaw dostęp według akcji.
- Reaguj na zdarzenia dostawcy — reaguj na zdarzenia z połączonej usługi.