Centro assistenzaIntegrazioni

Per: Amministratori

Limitare o revocare una chiave API

Limita l'utilizzo di una chiave a determinati indirizzi IP, disattivala o eliminala e verifica quando è stata utilizzata l'ultima volta.

In questo articolo6 sezioni

Prima di iniziare

È necessario verificare quando è stata l’ultima volta utilizzata una determinata chiave APIChiave Un token segreto, creato nella sezione Integrazione, che consente al tuo software di utilizzare l'API dell'hub.. È possibile limitarla all’indirizzo del proprio sistema, disattivarla per un periodo di tempo o semplicemente eliminarla, ad esempio quando la chiave potrebbe essere trapelata o quando il sistema che la utilizza non viene più utilizzato.

  1. Verifica il suo ultimo utilizzo

    In Integration › Keys, Ultimo utilizzo indica la data dell’ultima chiamata effettuata per quel codice di accesso; Ultimo indirizzo IP utilizzato invece indica l’indirizzo da cui proviene quella chiamata. Le chiamate rifiutate, a causa del codice di accesso errato, dell’uso di un’API sbagliata o di chiamate effettuate al di fuori del range di utilizzo del codice di accesso, non vengono considerate. Un trattino indica che quel codice di accesso non è stato utilizzato.

  2. Limitalo al tuo indirizzo

    Selezionare l’icona a forma di matita, Modifica tasto, nella riga corrispondente. Sotto Fonte CIDR, inserire l’indirizzo IPv4 pubblico del proprio sistema, come quello indicato sotto Ultimo indirizzo IP utilizzato; oppure poter scegliere un intervallo di indirizzi, ad esempio 203.0.113.0/24. Per permettere che l’indirizzo venga utilizzato da qualsiasi dispositivo, lasciare vuota la casella. Selezionare infine Salvare. “La chiave è salvata”. Da quel momento in poi, le chiamate provenienti da altri indirizzi verranno rifiutate.

  3. Spegnilo

    Per ora, per fermare la funzione in questione, basta aprirla con Modifica tasto, disattivare Attivo e selezionare Salvare. Ogni chiamata a questa funzione verrà rifiutata, fino a quando non si riattiva l’opzione corrispondente.

  4. Eliminalo

    Per eliminare definitivamente una chiave, selezionare l’icona del cestino, Tasto Elimina, nella riga corrispondente; successivamente selezionare anche Elimina. Verrà visualizzato il messaggio “Chiave eliminata”. La chiave smetterà di funzionare immediatamente e non potrà essere ripristinata.

Cosa succederà dopo?

A nessuno viene comunicato quando si modifica o si elimina una chiave. Le richieste inviate dal sistema a quella chiave vengono rifiutate da quel momento in poi. Per ulteriori informazioni, vedere Autenticare le richieste API con una chiave.

Se una chiave potrebbe essere stata rubata, spegnila immediatamente. Successivamente, crea una nuova chiave, passa il sistema a essa e elimina la vecchia chiave. Anche il tipo di chiave non può essere modificato: è necessario creare una chiave del tipo desiderato, per poi eliminare quella vecchia. Il hub può contenere due chiavi di ciascun tipo; quindi, con due chiavi già presenti, è necessario eliminare una delle due.

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.Integrazioni