Koble til en integrasjon
Ved å koble til en integrasjon kobler du kontoen din for en ekstern tjeneste – som Slack eller GitHub – til Kliv-appen din, slik at appen din kan fungere med den. Dette gjør du selv fra Kliv sine innstillinger; når den er koblet til, holder Kliv legitimasjonen trygg, og appen din kan begynne å bruke den.
Denne siden går gjennom tilkoblingsflyten og hva Kliv lagrer for deg.
Slik kobler du til
- Gå til Innstillinger → Integrasjoner.
- Velg integrasjonen du ønsker fra katalogen.
- Velg Koble til. Hva som skjer videre avhenger av tjenesten:
- Logg på tjenesten. De fleste integrasjoner (Slack, Notion, HubSpot og andre) sender deg til den tjenesten for å logge på og godkjenne tilgang, og bringer deg deretter tilbake til Kliv. Du godkjenner at Kliv handler på dine vegne – du kopierer ikke noen nøkler selv.
- Installer en app. Noen, som GitHub, ber deg installere Kliv sin app på kontoen din eller organisasjonen din og velge hva den får tilgang til.
- Lim inn en nøkkel. Noen få tjenester kobler til ved at du limer inn en tilgangsnøkkel fra den tjenestens innstillinger. Kliv lagrer den for deg i hvelvet.
- Når du går tilbake til Kliv, vises integrasjonen som tilkoblet og klar til bruk.
Du kan koble til mer enn én konto for samme tjeneste – for eksempel to Slack-arbeidsområder – og velge hvilken en gitt del av appen din bruker.
Hva Kliv lagrer for deg
Når du kobler til, lagrer Kliv legitimasjonen for den tjenesten i et sikkert hvelv. Et par ting å vite:
- Legitimasjonen ligger i Klivs hvelv, aldri i appens kode. Appens besøkende kan ikke se den, og du trenger aldri å administrere tokens selv.
- Kliv leverer legitimasjonen bak kulissene. Når appen din gjør et kall, legger Kliv til den riktige legitimasjonen på serversiden. Appkoden din beskriver bare hva du skal gjøre, aldri hvordan den skal autentisere.
- Noen tilkoblinger oppdateres automatisk. For tjenester der tilgangen utløper, fornyer Kliv den for deg. Hvis en tjeneste noen gang tilbakekaller tilgang – for eksempel hvis du fjernet Klivs app på deres side – vil integrasjonen be deg om å koble til på nytt.
Administrer eller koble fra
Fra samme integrasjonsområde kan du gå gjennom en tilkoblet integrasjon, angi hvem som har lov til å bruke den, sette opp hendelsestriggere eller koble den fra. Hvis du kobler fra, fjernes den lagrede legitimasjonen, og appen din slutter å bruke den tjenesten.
Hvis noe går galt
- «Ikke tilkoblet» — integrasjonen er ikke koblet til ennå, eller tilgangen til den ble fjernet. Koble til (eller koble til på nytt) fra Innstillinger → Integrasjoner.
- «Ny tilkobling kreves» — den eksterne tjenesten tilbakekalte Klivs tilgang. Åpne integrasjonen og koble den til igjen.
- Mer enn én tilkobling — hvis appen din har flere kontoer koblet til samme tjeneste, må du kanskje fortelle den hvilken du skal bruke – hver tilkoblings side viser en tilkoblingsvelger, en kort etikett appen din bruker for å velge mellom dem.
Beslektet
- Hva du kan koble til — integrasjonene som er tilgjengelige og hva de låser opp.
- Kontroller hvem som kan bruke en kobling — angi tilgang per handling.
- Reager på leverandørhendelser — svar på hendelser fra en tilkoblet tjeneste.