Tilslut en integration

Når du tilslutter en integration, forbinder du din konto hos en ekstern tjeneste – som Slack eller GitHub – med din Kliv-app, så din app kan arbejde sammen med den. Det gør du selv fra Klivs indstillinger; når den er tilsluttet, opbevarer Kliv legitimationsoplysningerne sikkert, og din app kan begynde at bruge den.

Denne side gennemgår tilslutningsflowet og hvad Kliv gemmer for dig.

Tilslutningsflowet

  1. Gå til Indstillinger → Integrationer.
  2. Vælg den integration, du vil have, i kataloget.
  3. Vælg Tilslut. Hvad der sker derefter afhænger af tjenesten:
    • Log ind på tjenesten. De fleste integrationer (Slack, Notion, HubSpot og andre) sender dig til den pågældende tjeneste for at logge ind og godkende adgang og bringer dig derefter tilbage til Kliv. Du godkender, at Kliv handler på dine vegne – du kopierer ikke selv nogen nøgler.
    • Installer en app. Nogle, såsom GitHub, beder dig om at installere Klivs app på din konto eller organisation og vælge, hvad den kan få adgang til.
    • Indsæt en nøgle. Nogle få tjenester tilsluttes ved at indsætte en adgangsnøgle fra den pågældende tjenestes indstillinger. Kliv gemmer den for dig i den sikre boks.
  4. Når du vender tilbage til Kliv, vises integrationen som tilsluttet og klar til brug.

Du kan tilslutte mere end én konto til den samme tjeneste – for eksempel to Slack-arbejdsområder – og vælge, hvilken en given del af din app bruger.

Hvad Kliv gemmer for dig

Når du tilslutter, gemmer Kliv legitimationsoplysningerne for den pågældende tjeneste i en sikker boks. Et par ting at vide:

  • Legitimationsoplysningerne findes i Klivs boks, aldrig i din apps kode. Din apps besøgende kan ikke se dem, og du behøver aldrig selv at administrere tokens.
  • Kliv leverer legitimationsoplysningen bag kulisserne. Når din app foretager et kald, vedhæfter Kliv den rigtige legitimationsoplysning på serversiden. Din app-kode beskriver kun hvad der skal ske, aldrig hvordan der godkendes.
  • Nogle forbindelser fornys automatisk. For tjenester, hvor adgangen udløber, fornyer Kliv den for dig. Hvis en tjeneste nogensinde tilbagekalder adgangen – for eksempel fordi du har fjernet Klivs app hos dem – beder integrationen dig om at tilslutte igen.

Administrer eller afbryd

Fra det samme integrationsområde kan du gennemgå en tilsluttet integration, indstille hvem der må bruge den, konfigurere hændelsesudløsere eller afbryde den. Afbrydelse fjerner de gemte legitimationsoplysninger og forhindrer din app i at bruge tjenesten.

Hvis noget går galt

  • "Ikke tilsluttet" – integrationen er endnu ikke blevet tilsluttet, eller dens adgang blev fjernet. Tilslut (eller gentilslut) den fra Indstillinger → Integrationer.
  • "Gentilslutning påkrævet" – den eksterne tjeneste tilbagekaldte Klivs adgang. Åbn integrationen og tilslut den igen.
  • Mere end én forbindelse – hvis din app har flere konti tilsluttet den samme tjeneste, skal du muligvis fortælle den, hvilken den skal bruge – hver forbindelses side viser en forbindelsesvælger, en kort etiket, som din app bruger til at vælge mellem dem.

Relateret