← Torna al blog

I Token API di Analytics Sono Credenziali, Non Identificatori

Un token API concede accesso ai dati. Trattalo come un segreto con un ciclo di vita: mostralo una volta, conserva un verificatore, limita i permessi e consenti la revoca.

Un token API non è un’etichetta per un utente o un sito. È una credenziale: chi ottiene un token valido può agire come il suo titolare. Trattarlo come un identificatore lo fa finire nei log, negli URL, negli screenshot del supporto e in configurazioni permanenti che nessuno sa revocare con sicurezza.

Le best practice di sicurezza per OAuth 2.0 dell’IETF, pubblicate a gennaio 2025, aggiornano il modello delle minacce e le indicazioni di sicurezza per le implementazioni OAuth. Un token API personale non è necessariamente un access token OAuth, ma vale lo stesso principio ingegneristico: le credenziali basate sul possesso vanno protette durante il transito, limitate al servizio previsto e ai soli permessi necessari.

Mostra il segreto una sola volta

Genera i token con una sorgente di casualità crittograficamente sicura e sufficiente entropia per impedire tentativi pratici di indovinare il valore. Restituisci il token completo solo al momento della creazione; poi conserva un prefisso non segreto per identificarlo e un verificatore unidirezionale per le ricerche successive. Se il database viene copiato, un verificatore è più sicuro di una credenziale riutilizzabile in chiaro. Non confondere un hash generico con un hash per password: i token API devono avere elevata casualità, mentre le password umane richiedono una funzione di hashing volutamente lenta.

Indica chiaramente nell’interfaccia e nella risposta API che il token sarà mostrato una sola volta. Dopo aver lasciato la schermata di creazione, l’utente deve poterlo revocare ed emetterne uno nuovo, non recuperare il segreto originale. Non inserire mai token in parametri di query, URL, eventi di analytics, report di errore o screenshot. Gli URL finiscono più facilmente degli header di autorizzazione nella cronologia del browser, nei referrer, nei log dei proxy e nei ticket di supporto.

Invia la credenziale nel posto giusto

Per le API HTTP, accetta i token nell’header Authorization su TLS. RFC 6750 descrive i bearer token come utilizzabili da chiunque li possieda e avverte che la divulgazione durante l’archiviazione o il trasporto ne consente l’uso improprio. Sconsiglia anche di inserire credenziali bearer nei parametri URI, perché gli URL vengono spesso registrati. Rifiuta token nelle query string e nei corpi delle richieste, a meno che un protocollo richieda un altro trasporto e sia disponibile un modello delle minacce documentato.

Sul server, valida il token prima di elaborare l’operazione richiesta. Risolvi titolare e permessi da uno storage fidato; non accettare come autorità un utente o proprietario del sito inviato nella richiesta. Tieni i segreti fuori dai log applicativi, dalle tracce e dai messaggi di eccezione. Quando serve correlare le operazioni, registra l’ID o il prefisso non segreto del token, mai la credenziale.

Limita, fai scadere e revoca

Un token deve concedere il minimo insieme utile di permessi. Se il prodotto lo consente, lascia che l’utente lo limiti a siti selezionati e a operazioni di sola lettura o specifiche. Non dare silenziosamente a uno script di automazione accesso in scrittura all’intero account quando gli serve solo un report. Le best practice di sicurezza OAuth trattano la restrizione di privilegi e audience dei token; sono un riferimento utile anche quando l’API usa un proprio formato opaco.

Offri scadenza e revoca come controlli fondamentali. Una durata più breve riduce il periodo in cui una credenziale esposta resta utile; la revoca gestisce incidenti e cambi di personale o integrazione. Se la rotazione richiede un periodo di sovrapposizione, stabiliscine il limite e mostra quale token è attivo. La revoca deve avere effetto al confine dell’API, non limitarsi a nascondere il token dal dashboard.

Nell’API programmatica di Monoid, i token mnd_live_… creati dagli utenti sono opachi, restituiti in chiaro una sola volta e archiviati come hash SHA-256 con scadenza facoltativa e revoca logica. Questa scelta protegge il valore originale in caso di lettura del database, ma non rende innocuo un token attivo divulgato. Tienilo fuori dal controllo versione, dall’output CI, dai bundle del browser e dalla cronologia condivisa del terminale; se sospetti un’esposizione, emetti un nuovo token e revoca quello vecchio.

Rendi verificabile il ciclo di vita

Testa il flusso completo: creazione, uso con i permessi previsti, rifiuto di un token non valido o scaduto, revoca e verifica che lo stesso token non funzioni più. Assicurati che un token non possa attraversare account o siti e che ogni endpoint applichi le stesse regole di autenticazione e autorizzazione. Aggiungi controlli operativi per oscurare le credenziali nei log e impedire che le risposte API restituiscano il token archiviato.

Il ciclo di gestione dei segreti comprende creazione, controllo degli accessi, rotazione, audit e revoca, non solo archiviazione sicura. Un token API rimane protetto soltanto se il sistema sa identificarne il titolare, limitarne le azioni, rilevare un’esposizione senza registrare il segreto e disattivarlo rapidamente.

Fonti

Comments

Loading comments…