Integrazioni

Chi la vede

Integrazioni è offerta a un membro il cui ruolo può gestire i ruoli e le impostazioni dell’organizzazione. Lo stesso permesso porta Modelli di notifica e Impostazioni.

Dov’è

Sotto Account nel menu. I vecchi indirizzi Chiavi API e Webhook si risolvono ancora e aprono questa pagina, perché ora tutti e tre gli argomenti stanno qui.

A che cosa serve

La pagina lo dice in una riga: come un altro sistema parla con questa organizzazione.

Le direzioni sono due, e le schede le separano. Una chiave è in uscita: è l’altro sistema che ci chiama con essa. Un webhook è in entrata: siamo noi a chiamare l’altro sistema. Si configurano insieme e si diagnosticano insieme, ed è per questo che condividono una pagina.

Chiavi API

123

1. 1Una chiave permette a un altro sistema di chiamarci. Un webhook permette a noi di chiamare un altro sistema. Un account di servizio è un membro automatico.
2. 2Emette una chiave. Viene mostrata una volta sola e dopo non si può rileggere.
3. 3Ogni chiave, e quando è stata usata l'ultima volta — che è ciò che ti dice se serve ancora.

Create API Key chiede un nome ed emette la chiave.

La chiave viene mostrata una volta sola, e il pannello lo dice: copiala adesso, non potrai più vederla. Non c’è modo di rileggerla dopo. Se la perdi, revocala e creane un’altra.

La tabella elenca ogni chiave con Name, Key, Last Used e Created. Last Used è ciò che ti dice se una chiave serve ancora.

Una chiave emessa qui ha autorità sui webhook oltre che sui clienti e sulla verifica. Una chiave, non una per scheda. Trattala di conseguenza, e dai a ogni sistema la propria chiave, così revocarne una non ferma le altre.

Webhook

Un webhook ci permette di chiamare un altro sistema quando accade qualcosa, per esempio un cliente che viene attivato, sospeso o revocato.

Aggiungi un webhook chiede un URL dell’endpoint e gli Eventi che vuoi. Alla creazione viene mostrato una volta sola un segreto di firma, con lo stesso avviso di una chiave. È quel segreto che il tuo server usa per confermare che la chiamata viene davvero da noi.

Ogni webhook mostra il suo ultimo successo, quanti errori ha avuto e se è Attivo, In pausa o Disattivato.

Invia una prova chiama subito il tuo endpoint e riferisce che cosa è tornato, come codice di stato. Usala quando l’endpoint è cambiato, senza aspettare che te lo dica un evento reale.

Account di servizio

Un account di servizio è un membro automatico di questa organizzazione. Esegue il client desktop su un server e verifica i codici senza una persona. Non ha una casella di posta e non è visibile agli altri membri di una connessione.

Crearne uno chiede un nome e restituisce il suo segreto del codice di identità. Mostrato una volta sola, come tutto il resto qui.

Ogni account di servizio mostra quante connessioni ha, e porta il proprio elenco di chiavi API, con Nuova chiave e Revoca.

Il motivo per usarne uno invece dell’account di un collega: una verifica automatica che gira su un server non dovrebbe smettere di funzionare quando una persona se ne va, e non dovrebbe essere visibile a chi sta dall’altra parte di una connessione.

Revocare

Ogni chiave, webhook e account di servizio si può rimuovere qui. Revocare una chiave ferma subito il sistema che la usa, quindi verifica chi la detiene prima di farlo.