Chiave API con permessi limitati: come configurarla per un bot di trading, quali autorizzazioni negare sempre e cosa fare se viene compromessa.
Un bot che esegue ordini su un exchange ha bisogno di una chiave API per collegarsi al conto. Fin qui nessuna sorpresa. Il problema comincia quando quella chiave viene generata con lo stesso livello di permessi con cui un titolare accede manualmente al proprio conto: lettura del saldo, apertura di ordini e, spesso senza che nessuno ci abbia riflettuto, prelievo di fondi verso un indirizzo esterno.
Una chiave con permesso di prelievo che finisce nelle mani sbagliate, per una fuga di dati, un file di configurazione dimenticato su un repository pubblico o un server compromesso, permette a chi la trova di svuotare il conto in un solo passaggio. Una chiave senza quel permesso, nello stesso scenario, permette al massimo di aprire ordini scomodi o di leggere il saldo. Il danno cambia di ordine di grandezza.
Questo testo descrive come configurare una chiave API con permessi limitati per un bot di trading, quali autorizzazioni concedere e quali negare sempre, e la procedura da seguire se una chiave risulta compromessa.
Le regole in breve
- Il permesso di prelievo non serve quasi mai a un bot di trading. Il bot compra e vende, non sposta fondi fuori dall’exchange.
- Una chiave per funzione, non una chiave per tutto. Lettura, trading e amministrazione restano separati.
- La whitelist di indirizzi IP riduce l’esposizione anche se la chiave viene copiata. Senza l’IP giusto, la chiave non funziona.
- Le chiavi vanno ruotate, non lasciate attive per anni. Una chiave vecchia è una chiave che nessuno ricorda più dove sia salvata.
- La reazione a una compromissione ha una sequenza precisa. Revocare prima, indagare dopo.
Perché una chiave con permesso di prelievo cambia tutto
Ogni exchange che offre un’interfaccia di programmazione permette di scegliere, al momento della creazione della chiave, quali operazioni quella chiave può autorizzare: lettura del saldo e della cronologia, invio di ordini di acquisto e vendita, e in molti casi anche il prelievo di fondi verso un indirizzo esterno predefinito o verso un indirizzo qualsiasi.
Il permesso di prelievo esiste perché alcuni utenti automatizzano anche lo spostamento di fondi, per esempio per trasferire periodicamente i proventi verso un portafoglio personale. Ma questa esigenza specifica riguarda una minoranza di casi d’uso, mentre la maggior parte dei bot di trading si limita a leggere il mercato e a inviare ordini sullo stesso conto, senza mai avere bisogno di spostare fondi verso l’esterno.
Concedere il permesso di prelievo per abitudine, o perché l’interfaccia lo propone come opzione preselezionata, trasforma una chiave che dovrebbe valere poco per un malintenzionato in una chiave che vale l’intero saldo del conto. È la differenza fra un ladro che trova la chiave di un armadietto e uno che trova la combinazione della cassaforte.
Vale la pena chiarire un equivoco frequente: limitare i permessi di una chiave non riduce in alcun modo la capacità del bot di fare il proprio lavoro. Un bot che compra e vende non tocca mai la funzione di prelievo durante il funzionamento normale, quindi negare quel permesso non introduce alcun limite operativo, ma elimina soltanto una possibilità che il bot non avrebbe comunque usato.
Come creare una chiave API con permessi limitati
La procedura varia leggermente da un exchange all’altro, ma segue quasi sempre la stessa logica: si crea la chiave dalla sezione dedicata del conto, si seleziona un elenco di permessi disponibili tramite caselle di spunta o un menu a tendina, e si conferma la generazione con un secondo fattore di autenticazione.
Il punto critico è la seconda fase: prima di confermare, va rivista ogni casella selezionata, non solo quelle che si intende usare. Molte interfacce preselezionano un insieme di permessi ampio per comodità dell’utente medio, e sta a chi configura il bot deselezionare esplicitamente ciò che non serve, invece di lasciare le impostazioni predefinite.
Una chiave API con permessi limitati per un bot di trading tipico dovrebbe includere solo lettura del saldo, lettura della cronologia degli ordini e invio di nuovi ordini. Il prelievo, la modifica delle impostazioni di sicurezza del conto e la gestione di altre chiavi API dovrebbero restare esclusi in ogni configurazione pensata per l’automazione del trading.
I permessi da concedere e quelli da negare sempre
Fra i permessi da concedere con tranquillità a un bot che esegue esclusivamente operazioni di compravendita rientrano la lettura del saldo, necessaria per calcolare la dimensione degli ordini, la lettura della cronologia, utile per la diagnostica, e l’invio di ordini di acquisto e vendita sui mercati previsti dalla strategia.
Fra i permessi da negare sempre, salvo un’esigenza specifica e documentata, rientrano il prelievo verso indirizzi esterni, la modifica delle impostazioni di sicurezza dell’account come l’autenticazione a due fattori o l’indirizzo email di recupero, e la creazione o revoca di altre chiavi API dallo stesso conto.
Un caso intermedio riguarda il trasferimento interno fra sotto-conti dello stesso exchange, usato da chi gestisce più strategie in portafogli separati sulla stessa piattaforma. Questo permesso comporta un rischio inferiore al prelievo esterno, perché i fondi restano comunque dentro il perimetro dell’exchange, ma va comunque valutato caso per caso e non concesso per automatismo.
La whitelist di indirizzi IP, la barriera che pochi attivano
Oltre ai permessi operativi, molti exchange permettono di associare una chiave API a un elenco ristretto di indirizzi IP autorizzati a usarla. Se la chiave viene copiata o rubata ma il tentativo di utilizzo arriva da un indirizzo diverso da quelli in whitelist, l’exchange rifiuta la richiesta, indipendentemente da quanto la chiave sia valida.
Questa funzione richiede che il bot giri su un server con un indirizzo IP stabile, condizione che vale per la maggior parte dei servizi di hosting dedicati ma non per connessioni domestiche con IP dinamico, dove l’indirizzo cambia periodicamente e romperebbe la whitelist a ogni cambio.
Chi esegue il bot da un servizio cloud con IP fisso non ha ragioni valide per lasciare questa funzione disattivata: è un controllo che costa pochi minuti da configurare e che riduce in modo sostanziale l’utilità di una chiave sottratta, anche se quella chiave conservasse permessi più ampi del necessario.
Un dettaglio spesso trascurato riguarda i provider cloud che assegnano un indirizzo IP diverso a ogni riavvio dell’istanza, anche quando il servizio viene descritto come dotato di IP statico. Prima di affidarsi alla whitelist come unica barriera, conviene verificare con un paio di riavvii di prova che l’indirizzo resti effettivamente invariato, per evitare che il bot smetta di funzionare proprio nel momento meno opportuno.
Separare le chiavi per funzione: lettura, trading, tesoreria
Una pratica che riduce ulteriormente il rischio consiste nel non usare la stessa chiave per compiti diversi. Uno strumento che si limita a monitorare il saldo e a inviare notifiche ha bisogno solo di permessi di lettura, e non dovrebbe condividere la chiave con il bot che invece invia ordini.
Separare le chiavi per funzione ha un costo organizzativo minimo, perché la maggior parte degli exchange consente di generare più chiavi collegate allo stesso conto, ciascuna con il proprio insieme di permessi. Il vantaggio è che la compromissione di uno strumento secondario, come un cruscotto di monitoraggio, non espone automaticamente anche la chiave che può inviare ordini.
Chi gestisce più strategie contemporaneamente dovrebbe inoltre valutare una chiave separata per ciascuna strategia, invece di una chiave unica condivisa da più bot. Un errore di configurazione in uno script smette così di poter interferire con gli ordini inviati da un altro script che usa la stessa infrastruttura ma una chiave distinta.
La tabella dei permessi per tipo di bot

| Tipo di strumento | Permessi necessari | Permessi da negare |
|---|---|---|
| Bot di trading automatico | Lettura saldo, lettura ordini, invio ordini | Prelievo, gestione chiavi, sicurezza account |
| Cruscotto di monitoraggio | Sola lettura saldo e cronologia | Invio ordini, prelievo, sicurezza account |
| Script di riconciliazione contabile | Lettura cronologia completa | Invio ordini, prelievo, sicurezza account |
| Trasferimento programmato verso wallet personale | Prelievo verso indirizzo predefinito | Invio ordini, gestione chiavi |
L’ultima riga della tabella mostra l’unico caso in cui il permesso di prelievo ha una giustificazione operativa chiara, ed è comunque preferibile limitarlo a un indirizzo predefinito e non concederlo insieme al permesso di trading sulla stessa chiave.
Che cosa succede se una chiave viene compromessa

Il primo segnale di una chiave compromessa è spesso un’attività anomala: ordini non riconosciuti, un saldo che cambia senza una ragione corrispondente a un’azione dell’utente, o una notifica dell’exchange su un accesso da un indirizzo IP mai usato prima.
Il primo passo, non negoziabile, è revocare immediatamente la chiave dalla sezione dedicata del conto, un’operazione che di solito richiede pochi secondi e non ha bisogno di alcuna indagine preliminare. Rimandare la revoca per capire prima che cosa sia successo lascia la porta aperta più a lungo del necessario.
Dopo la revoca, va verificato lo storico completo degli ordini e dei movimenti nel periodo sospetto, va cambiata la password del conto se esiste il minimo dubbio che sia stata compromessa insieme alla chiave, e va contattato il supporto dell’exchange per segnalare l’incidente, soprattutto se il permesso di prelievo era attivo e sono stati sottratti fondi.
Infine va rigenerata una nuova chiave con permessi limitati, applicando fin da subito i criteri descritti in questo testo, invece di ricreare la stessa configurazione ampia che ha reso possibile il danno iniziale.
I controlli periodici da programmare
Una chiave API configurata correttamente il giorno della creazione non resta automaticamente sicura per sempre. Un controllo trimestrale dell’elenco di chiavi attive su ogni exchange usato permette di individuare chiavi dimenticate, collegate a script non più in uso, che restano attive senza che nessuno se ne accorga.
Lo stesso controllo dovrebbe verificare che i permessi assegnati corrispondano ancora all’uso effettivo della chiave: uno script che inizialmente si limitava a leggere il saldo e che nel tempo ha ricevuto nuove funzioni potrebbe aver bisogno di un permesso aggiuntivo, mentre una chiave collegata a uno strumento dismesso andrebbe revocata subito, non lasciata attiva in attesa di un momento più comodo.
Un ultimo controllo utile riguarda la whitelist degli indirizzi IP: un server sostituito o un servizio di hosting cambiato lascia spesso un indirizzo vecchio ancora presente nell’elenco, un residuo che non comporta un rischio immediato ma che vale la pena rimuovere per mantenere l’elenco corrispondente all’infrastruttura realmente in uso.
Gli errori più comuni nella gestione delle chiavi
L’errore più diffuso è salvare la chiave e il relativo segreto in un file di testo semplice sullo stesso server dove gira il bot, senza alcuna cifratura, un’abitudine che espone la chiave a chiunque ottenga accesso al server anche per un altro motivo estraneo al trading.
Un secondo errore ricorrente è includere la chiave direttamente nel codice sorgente dello script, un’abitudine che diventa pericolosa nel momento in cui quel codice finisce, anche per errore, su un repository condiviso o pubblico, dove resta visibile anche dopo una rimozione successiva se la cronologia delle versioni non viene ripulita.
Un terzo errore riguarda la condivisione della stessa chiave fra più persone di un team senza un sistema che tracci chi ha usato la chiave e quando, rendendo impossibile risalire alla causa di un’operazione anomala quando più persone hanno accesso alle stesse credenziali senza distinzione.
Il ruolo dei log delle chiamate API
Molti exchange registrano ogni chiamata effettuata con una chiave API, indicando l’indirizzo IP di provenienza, il tipo di operazione richiesta e l’orario esatto. Questo registro, quando disponibile nella sezione sicurezza del conto, è uno strumento diagnostico che troppo spesso resta inutilizzato finché non serve durante un incidente già in corso.
Consultare periodicamente questo registro, anche in assenza di sospetti, aiuta a costruire un’idea di che cosa sia normale per quella chiave specifica: un bot che opera solo durante l’orario di mercato europeo e che improvvisamente mostra chiamate nel cuore della notte da un fuso orario diverso è un segnale che merita una verifica immediata, indipendentemente dal fatto che l’operazione registrata sembri innocua.
Alcuni servizi terzi offrono cruscotti che aggregano questi log su più exchange contemporaneamente, un vantaggio per chi gestisce più conti e più chiavi, a patto di verificare che il servizio stesso richieda solo permessi di lettura per collegarsi, e non finisca per introdurre esso stesso una nuova chiave con privilegi eccessivi nella catena.
Domande frequenti
Un bot di trading ha mai bisogno del permesso di prelievo?
Nella grande maggioranza dei casi no. Il bot legge il mercato e invia ordini sullo stesso conto, senza necessità di spostare fondi verso l’esterno. Il permesso di prelievo ha senso solo per strumenti specifici dedicati proprio a quel compito, separati dal bot di trading.
La whitelist di indirizzi IP sostituisce la necessità di limitare i permessi?
No, sono due controlli complementari. La whitelist limita da dove la chiave può essere usata, i permessi limitano che cosa la chiave può fare anche se usata dall’indirizzo giusto. Un solo controllo attivo lascia comunque una superficie di rischio che l’altro avrebbe ridotto.
Quanto spesso conviene ruotare le chiavi API?
Non esiste una frequenza universale, ma un controllo trimestrale dell’elenco delle chiavi attive, con rotazione delle chiavi più datate o non più necessarie, è una pratica ragionevole per la maggior parte delle configurazioni personali o di piccoli team.
Cosa fare se non si è sicuri che una chiave sia stata compromessa?
Nel dubbio conviene revocarla comunque e generarne una nuova. Il costo di rigenerare una chiave è minimo rispetto al costo potenziale di lasciarla attiva mentre si verifica se il sospetto era fondato.
Le chiavi di sola lettura sono completamente prive di rischio?
No, anche una chiave di sola lettura espone informazioni sul saldo e sulla strategia operativa a chi la ottiene senza autorizzazione, un’informazione che può essere usata per scopi diversi dal furto diretto di fondi, come la profilazione dell’attività di trading.
Configurare ogni chiave API con permessi limitati, separati per funzione e ristretti a una whitelist di indirizzi, non elimina ogni rischio operativo, ma riduce sensibilmente il danno massimo possibile in caso di errore o compromissione, una differenza che si misura solo quando qualcosa va storto e non prima.
