Sicurezza delle chiavi API
Questa pagina documenta le pratiche consigliate per archiviare, ruotare e revocare le chiavi API MCP di Cryptohopper. I consigli si applicano a qualsiasi ambiente in cui viene utilizzato l'MCP — workstation locali, sistemi CI, deployment di agenti e client MCP di terze parti.
Cosa garantisce una chiave MCP
Una chiave API MCP di Cryptohopper è un token bearer che autentica le richieste verso un singolo account Cryptohopper.
| Cosa può fare la chiave | Cosa non può fare la chiave |
|---|---|
| Leggere dati di mercato (ticker, registri degli ordini, candele) al livello consentito dal tier | Accedere ai bot di Cryptohopper |
| Interrogare utilizzo e quota per l'account | Effettuare trades o modificare posizioni |
| Elencare exchange e coppie supportati | Accedere all'interfaccia dell'account |
| — | Autorizzare chiamate all'API Trading di Cryptohopper |
Le chiavi sono di sola lettura. Una chiave MCP compromessa non consente a un attaccante di fare trading. Tuttavia, consente il consumo di quota, il che può interrompere i flussi di lavoro legittimi.
Consulta la panoramica dell'account per la relazione tra chiavi, account e abbonamento.
Archiviazione
Le chiavi devono essere trattate come segreti. Si applicano le pratiche standard di gestione dei segreti.
Consigliato
- Archivia le chiavi in un gestore di segreti dedicato (1Password, Bitwarden, AWS Secrets Manager, HashiCorp Vault o equivalenti).
- Leggi le chiavi dalle variabili d'ambiente a runtime. Preferisci le variabili d'ambiente ai file di configurazione committati nel controllo del codice sorgente.
- Definisci i permessi dei file: i file di configurazione del client contenenti chiavi devono essere leggibili solo dall'utente proprietario.
- Usa file di configurazione per client (~/.config/...) anziché posizioni a livello di sistema.
Non consigliato
- Committare chiavi nei repository git, anche in repository privati.
- Incollare chiavi in messaggi di chat, tracker di problemi o conversazioni di supporto.
- Condividere chiavi tra sviluppatori o macchine. Crea invece una chiave per ogni consumatore.
- Archiviare chiavi in file di testo semplice in cartelle sincronizzate nel cloud (es. Dropbox, iCloud Drive) senza crittografia aggiuntiva.
Se una chiave viene committata accidentalmente in git, revocala immediatamente e generane una nuova. La cronologia di git è duratura e si presume compromessa.
Rotazione
Ruotare le chiavi — revocare una vecchia chiave ed emetterne una nuova — è il meccanismo difensivo che limita il raggio d'azione di una compromissione.
Cadenza suggerita
| Contesto | Cadenza di rotazione |
|---|---|
| Workstation personale, client MCP locale | Ogni 90 giorni |
| Flusso di lavoro programmato in CI / cloud | Ogni 60 giorni |
| Condivisa tra più ambienti | Ogni 30 giorni |
| Chiave con qualsiasi cronologia di esposizione (committata in un repository, incollata in chat, ecc.) | Immediatamente, poi ogni 30 giorni |
Il limite di chiavi del tier determina quante chiavi possono esistere simultaneamente. Consulta i tier di abbonamento.
Procedura di rotazione
- Genera una nuova chiave API nell'interfaccia dell'account Cryptohopper.
- Distribuisci la nuova chiave a tutti i consumatori (client MCP, segreti CI, configurazioni degli agenti).
- Verifica che ogni consumatore stia usando la nuova chiave emettendo una query di test.
- Revoca la vecchia chiave dall'interfaccia dell'account Cryptohopper.
Le chiavi sono indipendenti. Revocare una non influisce sulle altre.
Segmentazione delle chiavi
Quando il tier consente più di una chiave (Adventurer: 3 chiavi; Hero: 10 chiavi), usale per segmentare l'utilizzo.
Modelli di segmentazione suggeriti
- Una chiave per agente. Ogni agente AI distinto ottiene la propria chiave. Se un agente si comporta male e consuma quota eccessiva, può essere identificato e limitato senza influenzare gli altri.
- Una chiave per ambiente. Chiavi separate per produzione, staging e sviluppo. Revocare o ruotare la chiave di sviluppo lascia la produzione intatta.
- Una chiave per utente. In un piccolo team, una chiave per membro del team fornisce attribuzione per l'utilizzo della quota e consente la revoca individuale quando un membro del team se ne va.
Ricorda che tutte le chiavi condividono l'unica quota settimanale dell'account. La segmentazione serve per attribuzione, revoca e limitazione — non per espansione della quota.
Revoca
Revoca una chiave quando:
- La chiave è stata esposta (committata in un repository, inviata tramite un canale non crittografato, presente su un dispositivo perso o rubato).
- Un consumatore non necessita più dell'accesso (flusso di lavoro dismesso, membro del team che ha lasciato).
- Come parte della rotazione programmata.
La revoca tramite l'interfaccia dell'account Cryptohopper ha effetto immediato. Le richieste successive che utilizzano la chiave revocata restituiscono UNAUTHORIZED. Consulta il riferimento degli errori.
Difesa in profondità
Oltre l'igiene di base:
- Restrizioni di rete. Se il tuo client MCP viene eseguito in un ambiente fisso (CI runner, server di produzione), considera di limitare il traffico in uscita specificamente a mcp-data.cryptohopper.com.
- Log di audit. Mantieni log locali di quale chiave ha eseguito quale azione. Confrontare i modelli di utilizzo dell'MCP con la telemetria di utilizzo per account di Cryptohopper aiuta a rilevare anomalie.
- Monitora l'utilizzo. Un picco improvviso nel volume delle chiamate è spesso il primo segno di una chiave compromessa. Consulta utilizzo e limiti.
- Separa dalle credenziali dell'API Trading. L'API REST Trading di Cryptohopper utilizza credenziali separate. Non collocare chiavi MCP e credenziali dell'API Trading in un singolo file non crittografato — una compromissione di una non dovrebbe implicare l'altra.
Risposta agli incidenti
Se si sospetta che una chiave sia stata compromessa:
- Revoca immediatamente. Non aspettare di confermare. Il costo di una revoca non necessaria è minore; il costo di una revoca ritardata è il consumo di quota e — se la chiave è abbinata a credenziali dell'API Trading nella stessa compromissione — potenzialmente di più.
- Controlla l'utilizzo. Interroga l'endpoint di utilizzo per cercare modelli anomali nel ciclo corrente. Documenta tutto ciò che è sospetto.
- Rivedi la fonte dell'esposizione. Comprendi come la chiave è stata esposta. Una chiave trapelata è spesso sintomo di una lacuna di controllo più ampia.
- Ruota le credenziali adiacenti. Se lo stesso ambiente conteneva credenziali dell'API Trading, ruota anche quelle.
- Genera una nuova chiave e ridistribuiscila ai consumatori.