Koppla en integration

Att koppla en integration länkar ditt konto för en extern tjänst — som Slack eller GitHub — till din Kliv-app, så att appen kan arbeta med den. Du gör detta själv från Klivs inställningar; när den är kopplad håller Kliv inloggningsuppgifterna säkra och appen kan börja använda den.

Den här sidan går igenom kopplingsflödet och vad Kliv lagrar åt dig.

Kopplingsflödet

  1. Gå till Settings → Integrations.
  2. Välj integrationen du vill ha från katalogen.
  3. Välj Connect. Vad som händer sedan beror på tjänsten:
    • Logga in på tjänsten. De flesta integrationer (Slack, Notion, HubSpot och andra) skickar dig till den tjänsten för att logga in och godkänna åtkomst, och tar dig sedan tillbaka till Kliv. Du godkänner att Kliv agerar för din räkning — du kopierar inga nycklar själv.
    • Installera en app. Vissa, som GitHub, ber dig installera Klivs app i ditt konto eller din organisation och välja vad den kan nå.
    • Klistra in en nyckel. Några få tjänster kopplas genom att du klistrar in en åtkomstnyckel från den tjänstens inställningar. Kliv lagrar den åt dig i valvet.
  4. När du kommer tillbaka till Kliv visas integrationen som kopplad och redo att användas.

Du kan koppla fler än ett konto för samma tjänst — till exempel två Slack-workspaces — och välja vilket en viss del av appen använder.

Vad Kliv lagrar åt dig

När du kopplar sparar Kliv inloggningsuppgifterna för den tjänsten i ett säkert valv. Några saker att känna till:

  • Inloggningsuppgifterna finns i Klivs valv, aldrig i appens kod. Appens besökare kan inte se dem, och du behöver aldrig hantera tokens själv.
  • Kliv tillhandahåller uppgiften bakom kulisserna. När appen gör ett anrop kopplar Kliv på rätt inloggningsuppgift på serversidan. Appkoden beskriver bara vad som ska göras, aldrig hur autentisering sker.
  • Vissa kopplingar förnyas automatiskt. För tjänster där åtkomst löper ut förnyar Kliv den åt dig. Om en tjänst någonsin återkallar åtkomsten — till exempel om du tog bort Klivs app på deras sida — ber integrationen dig att koppla igen.

Hantera eller koppla bort

Från samma Integrations-område kan du granska en kopplad integration, ange vem som får använda den, sätta upp händelsetriggrar eller koppla bort den. Att koppla bort tar bort de lagrade inloggningsuppgifterna och stoppar appen från att använda den tjänsten.

Om något går fel

  • "Not connected" — integrationen har inte kopplats ännu, eller dess åtkomst har tagits bort. Koppla (eller koppla igen) den från Settings → Integrations.
  • "Reconnect required" — den externa tjänsten återkallade Klivs åtkomst. Öppna integrationen och koppla den igen.
  • Mer än en koppling — om appen har flera konton kopplade för samma tjänst kan du behöva berätta vilken den ska använda — varje kopplings sida visar en kopplingsväljare, en kort etikett som appen använder för att välja mellan dem.

Relaterat