Gestisci, rigenera e revoca i token API

La scheda Token elenca i tuoi token API con il relativo accesso, i limiti e l'ultimo utilizzo. Da qui puoi rigenerare il segreto di un token, revocare un token e vedere perché un token ha smesso di funzionare.

Dove trovare i tuoi token#

Apri il menu dell'area di lavoro e scegli AI agents & API. La scheda Token è la prima; ogni scheda mostra il relativo conteggio.

Chi vede quali token:

Ogni riga mostra il Nome (con gli ultimi caratteri del segreto, come clv_agent_…k7Qe), il Proprietario, l'Accesso (le sue autorizzazioni), i Siti che copre, Creato, Ultimo utilizzo e Scade. Il piè di pagina conta i token attivi dell'area di lavoro rispetto al suo limite. Badge su una riga:

I token revocati e scaduti sono nascosti per impostazione predefinita. Fai clic su Mostra revocati e scaduti (conteggio) per elencarli; rimangono elencati per 30 giorni.

Modifica l'accesso di un token#

Le autorizzazioni, i siti, la scadenza, i limiti di spesa e l'allowlist IP di un token non possono essere modificati dopo la sua creazione. Per modificarne uno qualsiasi, crea un nuovo token con le nuove impostazioni, passa il tuo agente, quindi revoca quello vecchio.

Rigenera il segreto di un token#

Rigenera quando un segreto potrebbe essere trapelato o per ruotarlo secondo una pianificazione. Il nuovo segreto ha lo stesso nome, accesso, siti, allowlist IP, limiti di spesa e data di scadenza.

1. Apri il menu del token#

   Nella scheda Token, apri il menu ⋯ sulla riga del token e scegli Rigenera segreto.

2. Scegli quando il vecchio segreto si ferma#

   La finestra di dialogo chiede "Rigenerare “nome”?": "Ottieni un nuovo segreto con lo stesso accesso. Quello vecchio smette di funzionare." Spunta Mantieni il vecchio segreto funzionante per 24 ore se gli agenti lo stanno ancora utilizzando e hai bisogno di tempo per passarli. Lascialo non spuntato per fermare subito il vecchio segreto.

3. Copia il nuovo segreto#

   Fai clic su Rigenera. La finestra di dialogo Token creato mostra il nuovo segreto una volta. Copialo, aggiorna il tuo agente o il gestore dei segreti, quindi fai clic su L'ho salvato.

Regole per la rigenerazione:

• Solo la persona che ha creato un token può rigenerarlo. Un proprietario o un amministratore che non lo ha creato vede "Solo la persona che ha creato questo token può rigenerarlo. Puoi revocarlo."
• Un segreto può essere rigenerato una volta. Dopodiché, la vecchia riga mostra "Sostituito da un segreto rigenerato" e non ha l'opzione Rigenera segreto; rigenera invece il nuovo token. Riprovare sul vecchio segreto restituisce "Questo token è già stato rigenerato, revocato o è scaduto; usa il suo sostituto o creane uno nuovo."
• La data di scadenza non si sposta. Un token creato per 90 giorni scade comunque nella sua data originale. Se le 24 ore del vecchio segreto dovessero superare tale data, si ferma alla data di scadenza.
• Puoi rigenerare anche quando l'area di lavoro è al limite dei token attivi. Durante la sovrapposizione di 24 ore entrambi i segreti funzionano ed entrambi contano come token attivi.
• La rigenerazione richiede che l'area di lavoro sia su Pro o superiore; altrimenti Rigenera segreto apre la finestra di dialogo di aggiornamento.

Revoca un token#

1. Apri il menu ⋯ sulla riga del token e scegli Revoca.
2. Conferma con Revoca token: "Gli agenti che utilizzano questo token perdono l'accesso immediatamente. Questa operazione non può essere annullata."

Un token revocato libera immediatamente il suo posto nel limite di token attivi dell'area di lavoro.

Scadenza#

Ogni token scade. Scegli la durata quando lo crei: 7 giorni, 30 giorni, 90 giorni (l'impostazione predefinita) o 1 anno. Non esiste un'opzione "non scade mai", quindi un token dimenticato non può rimanere valido per sempre. La colonna Scade mostra la data.

Dopo la data di scadenza, ogni chiamata restituisce "Questo token è scaduto. Creane uno nuovo in Integrazioni → AI agents & API." Un token scaduto non può essere rinnovato o rigenerato; creane uno nuovo.

Allowlist IP#

Un token può essere limitato agli indirizzi da cui viene eseguito il tuo agente (ad esempio un runner CI o un server). Lo imposti nel passaggio Limiti della procedura guidata sotto Avanzate → Allowlist IP: "Opzionale. Un indirizzo o intervallo per riga; le chiamate da qualsiasi altro luogo vengono rifiutate."

• Inserisci indirizzi IPv4 o IPv6 (203.0.113.7) o intervalli in formato CIDR (198.51.100.0/24), fino a 20 voci.
• Lascialo vuoto per consentire qualsiasi indirizzo. Il passaggio di revisione mostra quindi Qualsiasi indirizzo.
• Una chiamata da un altro indirizzo restituisce "Questo token non può essere utilizzato da questo indirizzo IP."
• Una voce che non è un indirizzo o un intervallo viene rifiutata: "valore non è un indirizzo IP o un intervallo."

Perché un token ha smesso di funzionare#

Attività insolita#

Clevera monitora ogni token per picchi e avvisa il proprietario dell'area di lavoro con una notifica "Attività insolita su token":

• Molte richieste rifiutate in pochi minuti: il token viene revocato. "Ha effettuato molte richieste rifiutate in pochi minuti."
• Un numero insolitamente alto di modifiche in pochi minuti (più di 200 scritture o 20 rimozioni di pagine in 10 minuti): le sue scritture si mettono in pausa per 10 minuti. Le chiamate restituiscono "Le scritture da questo token sono in pausa dopo un insolito picco di modifiche. Il proprietario dell'area di lavoro è stato avvisato." Le letture funzionano ancora.
• Crediti spesi insolitamente velocemente: il token non può avviare lavoro a pagamento per 24 ore. "Ha speso un numero insolitamente alto di crediti in pochi minuti, quindi non può avviare lavoro a pagamento per ora."

Se l'area di lavoro lascia Pro#

AI agents & API è disponibile nei piani Pro, Business e Custom. Se l'area di lavoro passa a Starter o Free, la pagina mostra "AI agents & API sono inclusi in Pro": "Esegui l'upgrade per consentire a Claude, ChatGPT e ai tuoi script di funzionare in questa area di lavoro. I token e le app esistenti smettono di funzionare fino ad allora; puoi comunque revocarli qui."

• I token rimangono elencati e possono essere revocati, ma ogni chiamata viene rifiutata con plan_locked.
• Rigenera segreto apre invece la finestra di dialogo di aggiornamento.
• L'upgrade a Pro fa funzionare di nuovo i token. Nulla viene eliminato; i token scadono comunque nelle loro date.

Correlati#