Token API
Un token API permette a uno script o a un altro sistema di lavorare con Flowtly per conto tuo, senza che nessuno acceda dalla schermata di accesso. Crei e revochi i tuoi token in "Profile" → "Security", nella sezione "API tokens".
Un token agisce come te
Leggi questa parte prima di consegnare un token a qualcuno o a qualcosa.
Un token porta con sé la tua identità e i tuoi permessi. Tutto ciò che puoi vedere e modificare in Flowtly può vederlo e modificarlo anche chiunque abbia il tuo token, e tutto ciò che viene fatto con esso viene fatto come te.
- Non è una chiave dell'organizzazione. Appartiene alla persona che l'ha creato e arriva dove arriva quella persona.
- Non si può limitare. Non esiste un token di sola lettura né un token per un solo modulo: ogni token ha tutto il tuo accesso.
Consegnare un token a un'integrazione significa quindi consegnarle il tuo accesso. Dallo solo a un sistema a cui affideresti il tuo account, e crealo come la persona di cui l'integrazione ha davvero bisogno dell'accesso.
Per collegare un assistente di IA come Claude o ChatGPT non serve alcun token: vedi Collegare strumenti di IA (Claude, ChatGPT).
Creare un token
- Apri "Profile" → "Security" e vai alla sezione "API tokens".
- Dai al token un nome che dica dove verrà usato, per esempio il nome dell'integrazione. Può avere fino a 32 caratteri. Senza un nome, il token riceve un nome predefinito.
- Scegli "Generate token".
Flowtly mostra quindi il token, una sola volta. Copialo e conservalo in un luogo sicuro, per esempio in un gestore di password o nell'archivio dei segreti dell'integrazione, prima di chiudere la finestra. Flowtly non conserva alcuna copia da mostrarti di nuovo: una volta chiusa la finestra, il token non può essere recuperato né da te né da nessun altro. Se va perso, revocalo e creane uno nuovo.
Quanto dura un token
Un token creato qui è valido per 365 giorni dal momento in cui lo crei. È la durata predefinita, e 730 giorni è la durata più lunga per cui Flowtly emette un token, quindi nessun token resta valido a tempo indeterminato. Un token non si può prorogare: prima che scada, creane uno nuovo, consegnalo all'integrazione e poi revoca quello vecchio.
L'elenco mostra ciascuno dei tuoi token con il nome, la data in cui scade (o è scaduto) e quando è stato usato l'ultima volta. Un token scaduto resta nell'elenco finché non lo revochi. Un token che non viene usato da mesi è un buon candidato alla revoca.
Revocare un token
Scegli l'icona del cestino accanto a un token per revocarlo. Non viene chiesta alcuna conferma.
La revoca ha effetto subito: già la richiesta successiva fatta con quel token viene rifiutata, invece di lasciare che il token funzioni fino alla data di scadenza. Un token revocato non si può ripristinare; se serve ancora, creane uno nuovo.
Alcuni eventi fermano i tuoi token senza che tu li revochi:
- La reimpostazione della password. Completata una reimpostazione della password, smettono di funzionare tutti i token creati prima, insieme alle tue altre sessioni. Restano nell'elenco come se fossero ancora validi, quindi revoca anche quelli e crea nuovi token per le tue integrazioni.
- Un account disattivato. Se il tuo account Flowtly viene disattivato, tutti i token che hai creato smettono di funzionare finché l'account resta disattivato. Revocali se non devono tornare a funzionare.
Nessun altro può elencarli o revocarli dal proprio "Profile" → "Security".
Casi d'uso di esempio
- Una team leader collega a Flowtly uno script di registrazione delle ore con un token che porta il nome dello script ed è salvato nelle sue impostazioni riservate.
- Un consulente che ha incollato un token nel posto sbagliato lo revoca subito, sapendo che smetterà di funzionare al prossimo utilizzo.
- Un amministratore imposta un promemoria undici mesi dopo aver creato il token di un'integrazione e lo sostituisce prima che scadano i 365 giorni.
- Prima di dare un token a uno strumento esterno, una responsabile verifica a cosa arriva il proprio account, perché lo strumento arriverà esattamente allo stesso.