Chiavi API

Genera, copia, identifica e revoca una chiave API Runner personale in modo sicuro.

Le chiavi API sono segreti personali per l'accesso programmatico a Runner. Creane una solo per un'applicazione di cui ti fidi, conservala in modo sicuro e revocala quando non è più necessaria.

Cosa copre questa guida

Saprai come creare e salvare il segreto una tantum, identificare le chiavi esistenti senza esporle e revocare una chiave con conferma.

Disponibilità e prerequisiti

Chiavi API è condizionale e appare solo quando abilitata per il tuo account.
Le chiavi appartengono al tuo account personale, non a un negozio.
Non mettere mai una chiave completa in chat, Agent Memory, una Skill, uno screenshot, il controllo del codice sorgente o la documentazione del prodotto.

Percorso di accesso

Seleziona avatar → Impostazioni → Personale → Chiavi API. Se la voce è assente, la funzione non è disponibile per l'account corrente.

Controlli

Voce o pulsante	Perché è utile	Cosa succede dopo
Genera nuova chiave	Crea una nuova credenziale.	Si apre una finestra di dialogo con un campo Nome facoltativo.
Nome	Identifica l'applicazione in seguito senza esporre il segreto.	Il nome appare nella tabella delle chiavi; vuoto crea una chiave senza titolo.
Crea chiave	Genera la credenziale.	Runner apre Chiave API generata e visualizza il segreto completo una sola volta.
Icona occhio	Controlla il valore completamente generato di recente prima di archiviarlo.	Il valore una tantum viene mostrato o mascherato nella finestra di dialogo di successo.
Icona copia	Copia la nuova chiave con precisione.	Runner la copia negli appunti e mostra la conferma.
L'ho salvata	Chiudi la visualizzazione del segreto una tantum.	Il valore completo viene cancellato dalla finestra di dialogo e non può essere mostrato di nuovo lì.
Tabella chiave esistente	Identifica le chiavi in modo sicuro.	Runner mostra Nome, Prefisso, Creato e Ultimo utilizzo, non il segreto completo.
Icona Elimina	Revoca una chiave esistente.	Una conferma spiega che la revoca non può essere annullata.
Revoca	Disabilita la chiave selezionata.	Dopo il successo, la chiave viene rimossa dall'elenco e non può più autenticarsi.

Genera e archivia una chiave

Apri Personale → Chiavi API.
Seleziona Genera nuova chiave.
Inserisci un Nome descrittivo, ad esempio l'applicazione o l'ambiente. Non mettere un segreto nel nome.
Seleziona Crea chiave.
In Chiave API generata, rivela la chiave solo se necessario e seleziona Copia.
Archiviala in un gestore di segreti affidabile.
Conferma il valore archiviato prima di selezionare L'ho salvata.
Usa il Prefisso della tabella per identificare la chiave in seguito senza esporre il valore completo.

Runner avverte che la chiave completa non verrà più mostrata. Se chiudi la finestra di dialogo senza salvarla, revoca quella chiave e crea una sostituzione piuttosto che cercare di recuperare il segreto.

Revoca una chiave

Abbina la chiave prevista per Nome e Prefisso.
Seleziona la sua icona Elimina.
Rivedi la conferma Revoca.
Seleziona Revoca solo quando l'applicazione dipendente è pronta a smettere di usarla.
Conferma Chiave API revocata e rimuovi il vecchio segreto dall'applicazione.

La revoca è distruttiva e non può essere annullata. Crea una nuova chiave se l'accesso è necessario di nuovo.

Stati e limiti

Nessuna chiave API ancora è lo stato vuoto normale.
Il valore completo di una nuova chiave appare solo nella sua finestra di dialogo di successo.
Le righe esistenti mostrano un prefisso e le date di utilizzo, non una chiave recuperabile.
Mai sotto Ultimo utilizzo significa che Runner non ha registrato una richiesta per quella chiave.
I pulsanti Crea e Revoca mostrano lo stato di avanzamento e non devono essere inviati ripetutamente.

Risoluzione dei problemi

Se Chiavi API è mancante, non usare un collegamento diretto copiato; la funzione è disabilitata per questo account.
Se la copia negli appunti non riesce, rivela il nuovo valore e copialo manualmente in un gestore di segreti sicuro, quindi nascondilo di nuovo.
Se hai perso una chiave completa, revoca la sua riga e genera una sostituzione.
Se un'applicazione smette di funzionare dopo la revoca, aggiornala con una chiave appena creata; la vecchia chiave non può essere ripristinata.
Se è stata selezionata la chiave sbagliata, Annulla la conferma e confronta di nuovo Nome e Prefisso.