Token API

I token API ti permettono di collegare sistemi esterni, script e strumenti alla piattaforma Mirox con credenziali con ambito limitato e revocabili, che non espongono mai la tua password. Ogni token autentica le richieste machine-to-machine per tuo conto, così puoi esportare le metriche e automatizzare le tue integrazioni senza condividere il tuo login.

Concetto di token

Ogni token appartiene all'utente che lo ha creato e si comporta come quell'utente, entro certi limiti:

• Collegato al tuo account — un token agisce per tuo conto, e tutto ciò che fa viene attribuito a te nel registro di audit.
• Tetto di permessi — un token non può mai raggiungere nulla che tu stesso non possa raggiungere. Il tuo ruolo e il tuo accesso alle risorse limitano sempre ciò che il token può vedere.
• Limitato dal gruppo di permessi — al momento della creazione scegli un gruppo di permessi per restringere ulteriormente il token (vedi sotto).
• Mostrato una sola volta — il valore completo del token viene visualizzato una sola volta al momento della creazione. Conservalo in modo sicuro; Mirox ne mantiene solo una copia con hash e non potrà mai mostrarlo di nuovo.
• Fatto per l'automazione — a un token non viene mai chiesto un secondo fattore e le regole di accesso della tua organizzazione non lo fanno terminare. Vedi Token e autenticazione a due fattori.

In questo modo l'automazione resta tracciabile: anche se un token viene compromesso, è limitato a un solo ambito, facile da revocare e isolato dagli altri tuoi token.

Gruppi di permessi

Quando crei un token scegli un gruppo di permessi che definisce ciò che può fare:

Un gruppo non amplia mai il tuo accesso; restringe soltanto il token rispetto ai tuoi permessi. Per la definizione completa di ciascun gruppo, consulta la sezione gruppi di permessi API della documentazione sul sistema di permessi.

Creazione e gestione dei token

Gestisci i tuoi token dal tuo profilo. La piattaforma copre l'intero ciclo di vita:

Creazione di un token

• Nome e descrizione — un'etichetta chiara e una nota per ricordare a cosa serve ciascun token.
• Gruppo di permessi — scegli uno dei gruppi sopra elencati.
• Scadenza — facoltativa. I token hanno per impostazione predefinita una durata di un anno, e puoi impostare qualsiasi scadenza fino a un massimo di cinque anni.
• Rivelazione una tantum — il token completo viene mostrato una sola volta alla creazione, poi mai più.

Puoi mantenere fino a 64 token attivi per account.

Rotazione di un token

La rotazione sostituisce il segreto di un token sul posto, senza modificarne il nome, la descrizione o il gruppo di permessi:

• Viene emesso un nuovo segreto e mostrato una sola volta.
• Il vecchio segreto smette di funzionare immediatamente.
• La scadenza viene reimpostata e la cronologia di utilizzo viene cancellata.

La rotazione è il modo consigliato per rinnovare le integrazioni di lunga durata secondo una pianificazione, o per rispondere a una sospetta fuga, senza dover riconfigurare quale integrazione usa quale token.

Monitoraggio e revoca

• Inventario — elenca tutti i tuoi token con nome, gruppo di permessi, date di creazione e di scadenza.
• Informazioni sull'utilizzo — visualizza quando ciascun token è stato usato l'ultima volta, insieme all'IP, alla posizione, al browser e al sistema operativo registrati in quel momento. Il valore del token non viene mai mostrato di nuovo.
• Revoca immediata — elimina un token per invalidarlo all'istante. La revoca di un token non influisce mai sugli altri.

Token e autenticazione a due fattori

Un token API è fatto per script e integrazioni che funzionano senza una persona alla tastiera. Le regole di accesso pensate per le persone quindi non lo riguardano:

• Nessun secondo fattore. A un token non viene mai chiesto un codice, che il tuo account abbia o meno l'autenticazione a due fattori (2FA).
• Non termina per le regole di accesso. La tua organizzazione può impostare quanto dura un accesso all'app web e all'app mobile. Un token non è un accesso: continua a funzionare fino alla propria data di scadenza, o finché non lo ruoti o lo revochi. Essere disconnesso non ferma i tuoi token.
• Non cambia per un obbligo di 2FA. Quando un'organizzazione richiede la 2FA per l'accesso agli impianti, quella regola vale per le persone connesse all'app web e all'app mobile. Non cambia ciò che un token esistente può raggiungere.

Una regola però vale: finché la tua organizzazione richiede la 2FA e il tuo account non ha un secondo fattore, non puoi creare un nuovo token. Attiva prima la 2FA (app di autenticazione o passkey) — vedi Autenticazione a due fattori. Nel frattempo i tuoi token esistenti continuano a funzionare.

Poiché un token non è protetto da un secondo fattore, trattalo come una password: conservalo al sicuro, assegnagli il gruppo di permessi più ristretto, imposta una scadenza e revocalo quando non serve più. Per le regole dell'organizzazione vedi Criterio di sicurezza dell'organizzazione.

Casi d'uso comuni

I token API supportano un'ampia gamma di scenari di integrazione.

Metric Export

Un token Metric Export legge ogni link del Metric Export e dell'esportazione legacy:

• Aggiorna cartelle di lavoro Excel e dashboard BI da un link di esportazione.
• Alimenta i dati di produzione e sulle prestazioni in data warehouse e pipeline di analisi.
• Costruisci i tuoi report dai dati esportati.

Il token non può creare né modificare modelli, metriche o altro. I report che Mirox genera da sé non sono guidati da token API: vengono generati, pubblicati e scaricati nell'app.

Accesso alle metriche delle serie temporali

• Leggi le serie di misura grezze dei tuoi impianti, le stesse serie che legge Grafana.
• Collega strumenti di analisi in sola lettura che parlano il linguaggio di query dell'archivio delle serie temporali.

Sicurezza e controllo

• Isolamento dei token — un token compromesso non espone mai la tua password né gli altri tuoi token.
• Rotazione pianificata — ruota periodicamente i token di lunga durata usando l'azione di rotazione, mantenendo la stessa configurazione.
• Validità a tempo limitato — imposta una scadenza affinché i token abbandonati decadano automaticamente.
• Attribuzione completa — ogni azione che un token compie viene registrata a tuo nome, così l'utilizzo resta tracciabile e verificabile.

Funzionalità correlate

• Sistema di permessi — come funzionano i gruppi di permessi e il controllo degli accessi
• Metric Export — che cosa legge un token Metric Export
• Metric Export API — i parametri dei link di esportazione
• Guida all'uso dei token API — creazione passo-passo dei token ed esempi
• Criterio di sicurezza dell'organizzazione — le regole di accesso e di 2FA di un'organizzazione, e cosa non toccano
• FAQ Sicurezza dell'account — domande frequenti su accesso, 2FA e token