Sostituire una chiave API in scadenza

La rotazione richiede un periodo di sovrapposizione: crea e verifica la nuova chiave mentre quella esistente funziona ancora, poi revoca la vecchia credenziale dopo aver migrato tutti i client.

Prima della sostituzione

Apri Profilo → Chiavi API in /profile/api ed espandi la chiave in scadenza. L’interfaccia indica le date future come Expires date ed evidenzia le chiavi in scadenza entro 30 giorni. Quelle scadute contano ancora nel limite di 3 del piano gratuito e nel limite assoluto di 20.

Le chiavi non si possono modificare. Duplica le impostazioni apre una bozza per la nuova chiave, ma la scadenza è impostata su Non scade mai e i campi dei limiti di utilizzo sono vuoti perché il punto di accesso dell’elenco non li restituisce. Il segreto S3 non viene copiato.

Passaggi

1. Elenca tutti i client che usano la vecchia chiave, annotando per ogni client protocollo, spazio di lavoro, ambito di accesso alla cartella, vincoli IP o orari attivi e limiti di utilizzo registrati fuori da dosya.
2. Scegli Duplica le impostazioni, cambia il nome per identificare la rotazione, poi esamina Restrizioni e scadenza senza presumere che ogni campo sia stato copiato.
3. Reinserisci i limiti di richieste al minuto, download giornaliero, dimensione massima dei file e trasferimenti simultanei; scegli consapevolmente Scade tra 30 giorni, Scade tra 90 giorni o Non scade mai.
4. Premi Genera la chiave, copia il segreto dos_… dalla finestra is ready, che viene mostrata una sola volta, e crea separatamente nuove credenziali S3 se il client usa quel gateway.
5. Distribuisci la nuova chiave a un client alla volta e verifica che una richiesta consentita vada a buon fine e che l’ambito di accesso sia quello previsto prima di rimuovere il vecchio segreto.
6. Espandi la riga della vecchia chiave, scegli Revoca, leggi l’avviso di irreversibilità, conferma e verifica che la credenziale revocata venga rifiutata e che la nuova chiave continui a funzionare.

Tempi e recupero

L’autenticazione controlla la scadenza quando carica una chiave e conserva i dati nella cache per 300 secondi. Considera la scadenza mostrata come ora di arresto e sostituisci la chiave in anticipo; non fare affidamento sulla cache per prolungare l’accesso. La revoca elimina irreversibilmente la riga e programma l’eliminazione delle voci della cache REST e S3. Ferma il vecchio client, attendi fino a cinque minuti per la cache e verifica che il segreto venga rifiutato prima di considerarlo inutilizzabile ovunque.

Se un account gratuito ha 3 chiavi, puoi eliminare una chiave inutilizzata o passare a un piano superiore per liberare spazio. Il limite assoluto è di 20 chiavi per ogni piano: se ne hai 20, elimina una credenziale dopo aver verificato che non sia in uso; passare a un piano superiore non aumenta il limite. Non revocare la chiave attiva solo per fare spazio finché non hai un modo sicuro per sostituirla.

Risultato previsto

L’integrazione funziona con il nuovo segreto e le restrizioni ripristinate. La vecchia chiave non è più in uso e, dopo la revoca irrevocabile, restituisce un errore di autenticazione.

Guide correlate

• Guida rapida REST API
• Esaminare le consegne webhook