Verbinden Sie eine Integration
Durch die Verbindung einer Integration wird Ihr Konto für einen externen Dienst – wie Slack oder GitHub – mit Ihrer Kliv-App verknüpft, sodass Ihre App damit arbeiten kann. Sie tun dies selbst in den Einstellungen von Kliv. Sobald die Verbindung hergestellt ist, bewahrt Kliv die Anmeldeinformationen sicher auf und Ihre App kann sie verwenden.
Diese Seite führt Sie durch den Verbindungsablauf und was Kliv für Sie speichert.
Der Verbindungsablauf
- Gehen Sie zu Einstellungen → Integrationen.
- Wählen Sie die gewünschte Integration aus dem Katalog aus.
- Wählen Sie Verbinden. Was als Nächstes passiert, hängt vom Dienst ab:
- Melden Sie sich beim Dienst an. Die meisten Integrationen (Slack, Notion, HubSpot und andere) leiten Sie zu diesem Dienst weiter, um sich anzumelden und den Zugriff zu genehmigen, und bringen Sie dann zurück zu Kliv. Sie genehmigen Kliv, in Ihrem Namen zu handeln – Sie kopieren selbst keine Schlüssel.
- Installieren Sie eine App. Einige, wie GitHub, fordern Sie auf, die App von Kliv in Ihrem Konto oder Ihrer Organisation zu installieren und auszuwählen, worauf sie zugreifen kann.
- Fügen Sie einen Schlüssel ein. Einige Dienste werden verbunden, indem Sie einen Zugriffsschlüssel aus den Einstellungen dieses Dienstes einfügen. Kliv speichert ihn für Sie im Tresor.
- Wenn Sie zu Kliv zurückkehren, wird die Integration als verbunden und einsatzbereit angezeigt.
Sie können mehr als ein Konto für denselben Dienst verbinden – zum Beispiel zwei Slack-Arbeitsbereiche – und auswählen, welches ein bestimmter Teil Ihrer App verwendet.
Was Kliv für Sie speichert
Wenn Sie eine Verbindung herstellen, speichert Kliv die Anmeldeinformationen für diesen Dienst in einem sicheren Tresor. Ein paar Dinge, die Sie wissen sollten:
- Die Anmeldeinformationen befinden sich im Tresor von Kliv, niemals im Code Ihrer App. Die Besucher Ihrer App können sie nicht sehen und Sie müssen Token nie selbst verwalten.
- Kliv stellt die Anmeldeinformationen hinter den Kulissen bereit. Wenn Ihre App einen Aufruf macht, hängt Kliv die richtigen Anmeldeinformationen auf der Serverseite an. Ihr App-Code beschreibt nur, was zu tun ist, niemals, wie die Authentifizierung erfolgt.
- Einige Verbindungen werden automatisch aktualisiert. Für Dienste, bei denen der Zugriff abläuft, erneuert Kliv ihn für Sie. Wenn ein Dienst jemals den Zugriff widerruft – Sie haben beispielsweise die App von Kliv auf dessen Seite entfernt – werden Sie von der Integration aufgefordert, die Verbindung erneut herzustellen.
Verwalten oder trennen
Im selben Integrationsbereich können Sie eine verbundene Integration überprüfen, festlegen, wer sie verwenden darf, Ereignisauslöser einrichten oder die Verbindung trennen. Durch das Trennen der Verbindung werden die gespeicherten Anmeldeinformationen entfernt und Ihre App kann diesen Dienst nicht mehr verwenden.
Wenn etwas schiefgeht
- „Nicht verbunden“ – die Integration wurde noch nicht verbunden oder ihr Zugriff wurde entfernt. Verbinden Sie sie über Einstellungen → Integrationen (oder verbinden Sie sie erneut).
- „Erneutes Verbinden erforderlich“ – der externe Dienst hat den Zugriff von Kliv widerrufen. Öffnen Sie die Integration und verbinden Sie sie erneut.
- Mehr als eine Verbindung – Wenn in Ihrer App mehrere Konten für denselben Dienst verbunden sind, müssen Sie ihr möglicherweise mitteilen, welches verwendet werden soll – die Seite jeder Verbindung zeigt eine Verbindungsauswahl, eine kurze Bezeichnung, mit der Ihre App zwischen ihnen wählt.
Verwandt
- Was Sie verbinden können – die verfügbaren Integrationen und was sie freischalten.
- Steuern Sie, wer einen Connector verwenden kann – Zugriff pro Aktion festlegen.
- Auf Anbieterereignisse reagieren – auf Ereignisse eines verbundenen Dienstes reagieren.