Centro assistenzaIntegrazioni

Per: Amministratori

Crea una chiave API

Crea una chiave di gestione per l'API del pannello di amministrazione o una chiave hub per l'API del portale, limitane l'accesso ai tuoi indirizzi IP e copiala una sola volta.

In questo articolo8 sezioni

Una chiave APIChiave Un token segreto, creato nella sezione Integrazione, che consente al tuo software di utilizzare l'API dell'hub. permette al proprio software, come ad esempio un sistema di gestione dei casi, di funzionare insieme al proprio hub. Una chiave di gestione utilizza l’API del pannello amministrativo per gestire i casi e le persone coinvolte; una chiave del hub, invece, utilizza l’API del portale per gestire le attività svolte all’interno dei casi. È importante comprendere cosa può fare l’API.

  1. Chiavi aperte

    Vai a Integrazione › Tasti e seleziona NUOVO.

  2. Dagli un nome

    Sotto Descrizione, si può indicare cosa verrà utilizzato, ad esempio “Case sync”.

  3. Limita i luoghi in cui viene utilizzato

    Sotto Fonte CIDR, inserite l’indirizzo IPv4 pubblico da cui il vostro sistema riceve le chiamate, ad esempio 203.0.113.10; oppure un intervallo di indirizzi, come 203.0.113.0/24. Le chiamate provenienti da qualsiasi altro luogo vengono rifiutate. Il hub riconosce soltanto indirizzi IPv4; quindi gli indirizzi IPv6 vengono automaticamente rifiutati.

    Se non conosci l’indirizzo, lasciare lo spazio vuoto: in questo modo è possibile inserire qualsiasi indirizzo. Dopo il primo tentativo di accesso del sistema, Ultimo indirizzo IP utilizzato mostrerà l’indirizzo corretto; per ulteriori informazioni, vedere Restringere o revocare una chiave API.

  4. Scegli il tipo

    Sotto Dominio, selezionare Manage per l’API del pannello di amministrazione, oppure Hub per l’API del portale. Questo valore non può essere modificato in seguito.

  5. Accendilo e aggiungilo

    Attivo inizia da questo punto. Lasciarlo attivo significa che una chiave inattiva verrà rifiutata in ogni chiamata. Scegliete Aggiungi chiave. “Chiave aggiunta” è indicato come tale.

  6. Copia la chiave

    La finestra Chiave segreta mostra la chiave soltanto una volta. Selezionare il pulsante “Copia”, Copia negli appunti, e memorizzare la chiave in un luogo dove il proprio sviluppatore possa accedervi facilmente, ad esempio in un gestore di password. Successivamente, selezionare Fatto.

Cosa succederà dopo?

I file chiave vengono inviati immediatamente, e non scadono nel tempo. Il tuo sviluppatore li invia insieme a ogni chiamata; per maggiori informazioni… Autenticare le richieste API utilizzando una chiave. Agisce come il “hub” del sistema. Assistente virtualAssistente virtuale Un membro automatizzato del team che pubblica messaggi di benvenuto, check-in e post di aggiornamento per l'azienda; i suoi post sono contrassegnati da un badge di Assistente Virtuale., Quindi, ciò che viene pubblicato sembra essere stato scritto dall’Assistente Virtuale.

Ultimo utilizzo e Ultimo indirizzo IP utilizzato indicano la data e l’indirizzo della ultima chiamata effettuata. Per disattivare o eliminare queste informazioni, vedere Restrizioni o revoca di una chiave API.

Se qualcosa va storto

  • Il limite massimo è stato raggiunto. Il tuo hub può avere due chiavi di ciascun tipo. Elimina una delle chiavi che non utilizzi più.
  • Secondo il CIDR, “il blocco di indirizzi è invano. Esempio: 203.0.113.10 o 203.0.113.0/24”. Verificare l’indirizzo: quattro numeri compresi tra 0 e 255, con dei punti tra i numeri stessi. Per indicare un intervallo di valori, è necessario utilizzare una barra e un numero fino a 32.
  • Secondo la fonte CIDR, “È necessario utilizzare un indirizzo IPv4 o un intervallo di indirizzi IPv4, ad esempio 203.0.113.10. L’accesso all’API è possibile soltanto tramite IPv4”. Avete inserito un indirizzo IPv6. È meglio utilizzare invece l’indirizzo IPv4 del vostro sistema.
  • Hai perso la chiave. Non è possibile mostrarla di nuovo. È necessario creare una nuova chiave, spostare il proprio sistema su quella nuova, e poi eliminare la vecchia chiave. Se il proprio hub ne possiede già due esemplari dello stesso tipo, è necessario eliminare prima il vecchio hub; il sistema non può comunque comunicare con l’hub fino a quando non dispone della chiave nuova.

Articoli correlati

Autentica le richieste API con una chiaveInvia la tua chiave come token bearer all'API del pannello di amministrazione per una chiave di gestione o all'API del portale per una chiave hub, e limita l'invio ai tuoi indirizzi IP.IntegrazioniLimitare o revocare una chiave APILimita l'utilizzo di una chiave a determinati indirizzi IP, disattivala o eliminala e verifica quando è stata utilizzata l'ultima volta.Integrazioni · 2 minComprendere cosa può fare l'APIScopri quali funzioni possono svolgere un tasto di gestione e un tasto hub, perché ogni tasto funge da Assistente Virtuale e dove trovare l'elenco tecnico completo.Integrazioni