Buone pratiche per le chiavi API
Accesso completo o personalizzato, revoca e sostituzione di una chiave e come riconoscerne una che nessuno usa.
Una chiave API agisce sul tuo account anche senza di te: da qualsiasi luogo, finché non viene revocata. Autenticazione spiega come si crea una chiave e come si invia in una chiamata; questa pagina serve a tenere in ordine quelle che hai già.
Dai a una chiave solo ciò che le serve
Ogni chiave è Accesso completo o Accesso personalizzato, scelto quando viene creata e modificabile in seguito dallo stesso modulo.
- Accesso completo raggiunge ogni metodo che il tuo account può chiamare, compresi quelli aggiunti dopo la creazione della chiave. Nulla di contrassegnato come privato è mai incluso, qualunque sia la modalità di accesso di una chiave.
- Accesso personalizzato raggiunge solo i metodi che hai spuntato esplicitamente, raggruppati per microservizio con i parametri di ciascun metodo mostrati accanto. Un metodo aggiunto in seguito non è coperto finché non torni a spuntarlo.
Una chiave inserita in uno script, in un job di CI o in un server ha bisogno solo dei pochi metodi che quel job chiama davvero. L'accesso personalizzato impedisce a una chiave trapelata di poter fare più del lavoro per cui era stata creata.
Crea, mostra e copia
Creare una chiave richiede che il tuo account sia verificato al livello 2; vedi Verifica. Il pulsante Crea chiave lo spiega e, se non ci sei ancora, rimanda direttamente al prossimo passaggio da completare. Il valore di una chiave appena creata viene mostrato una sola volta nel pannello Copia rapida in cima all'elenco; dopo di che ogni riga lo tiene nascosto, e il pulsante di visualizzazione della riga lo mostra di nuovo per 20 secondi prima che si nasconda da solo.
Il valore non viene mai scritto in un log, in una notifica o nella barra degli indirizzi, ma solo negli appunti. Trattalo esattamente come una password. Chiunque lo abbia può agire come il tuo account.
Sostituisci, revoca e riconosci una chiave che non si usa
Non esiste un'azione di rotazione separata, perché il valore di una chiave è il suo stesso identificativo. Sostituisci crea una nuova chiave con lo stesso nome e lo stesso accesso, revoca la vecchia e mostra il nuovo valore una sola volta, così puoi copiarlo prima di chiudere la finestra. Revoca rimuove una chiave del tutto e ti chiede prima di confermare per nome, perché non si può annullare.
La riga di ogni chiave mostra quando è stata usata l'ultima volta, ricavato dall'attività degli ultimi 7 giorni; una chiave senza riga sotto non ha fatto nessuna chiamata in quel periodo. È la riga che merita un secondo sguardo.
Sostituisci una chiave che potrebbe essere trapelata
Apri la chiave, premi Sostituisci e copia il nuovo valore nel momento in cui compare. Il vecchio valore smette di funzionare nell'istante in cui la sostituzione si completa.
Revoca una chiave che non ti serve più
Premi Revoca sulla sua riga e conferma per nome. Una chiave revocata esce dall'elenco delle chiavi attive; non c'è modo di riportarla indietro.
Cerca una chiave che nessuno usa
Scorri l'elenco in cerca di una riga senza la riga "Ultimo utilizzo", soprattutto tra le chiavi con Accesso completo, e revocala se non sai spiegarne l'esistenza.