Connetti un'integrazione

La connessione di un'integrazione collega il tuo account per un servizio esterno, come Slack o GitHub, alla tua app Kliv, in modo che la tua app possa lavorare con esso. Puoi farlo tu stesso dalle impostazioni di Kliv; una volta completata la connessione, Kliv mantiene al sicuro le credenziali e la tua app può iniziare a utilizzare il servizio.

Questa pagina illustra il flusso di connessione e ciò che Kliv memorizza per te.

Il flusso di connessione

  1. Vai su Impostazioni → Integrazioni.
  2. Scegli l'integrazione che desideri dal catalogo.
  3. Scegli Connetti. Quello che succede dopo dipende dal servizio:
    • Accedi al servizio. La maggior parte delle integrazioni (Slack, Notion, HubSpot e altre) ti invia a quel servizio per accedere e approvare l'accesso, quindi ti riporta a Kliv. Stai autorizzando Kliv ad agire per tuo conto: non copi tu stesso nessuna chiave.
    • Installa un'app. Alcune, come GitHub, ti chiedono di installare l'app Kliv nel tuo account o organizzazione e di scegliere cosa può raggiungere.
    • Incolla una chiave. Alcuni servizi si connettono incollando una chiave di accesso dalle impostazioni del servizio. Kliv la memorizza per te nell'archivio protetto.
  4. Quando torni a Kliv, l'integrazione viene visualizzata come connessa e pronta per l'uso.

Puoi connettere più di un account per lo stesso servizio, ad esempio due aree di lavoro Slack, e scegliere quale far utilizzare a una determinata parte della tua app.

Cosa Kliv memorizza per te

Quando ti connetti, Kliv salva le credenziali per quel servizio in un archivio protetto. Alcune cose da sapere:

  • Le credenziali risiedono nell'archivio protetto di Kliv, mai nel codice della tua app. I visitatori della tua app non possono vederle e non dovrai mai gestire tu stesso i token.
  • Kliv fornisce le credenziali dietro le quinte. Quando la tua app effettua una chiamata, Kliv allega le credenziali giuste sul lato server. Il codice dell'app descrive solo cosa fare, mai come autenticarsi.
  • Alcune connessioni si aggiornano automaticamente. Per i servizi per i quali l'accesso scade, Kliv lo rinnova per te. Se un servizio revoca l'accesso, ad esempio se hai rimosso l'app Kliv da parte sua, l'integrazione ti chiederà di riconnetterti.

Gestisci o disconnetti

Dalla stessa area Integrazioni puoi rivedere un'integrazione connessa, impostare chi è autorizzato a usarla, configurare trigger di eventi o disconnetterla. La disconnessione rimuove le credenziali archiviate e impedisce all'app di utilizzare tale servizio.

Se qualcosa va storto

  • "Non connesso": l'integrazione non è stata ancora connessa o il suo accesso è stato rimosso. Collegala (o ricollegala) da Impostazioni → Integrazioni.
  • "Riconnessione richiesta": il servizio esterno ha revocato l'accesso di Kliv. Apri l'integrazione e collegala di nuovo.
  • Più di una connessione: se la tua app ha diversi account collegati per lo stesso servizio, potresti dover indicare quale utilizzare: la pagina di ciascuna connessione mostra un selettore di connessione, una breve etichetta che la tua app usa per scegliere tra di esse.

Correlati