La gestione dei segreti è un insieme di pratiche e sistemi che gli sviluppatori utilizzano per generare, archiviare, distribuire e ritirare le credenziali. Tra gli esempi figurano una chiave Application Programming Interface (API) all'interno di una funzione serverless o una password per un database in un pool di connessioni. La gestione dei segreti limita chi e cosa può leggere un determinato valore, per quanto tempo e a quali condizioni. L'esposizione dei segreti è un problema in crescita: nel 2024 sono stati aggiunti ai commit pubblici di GitHub quasi 24 milioni di nuovi segreti hardcoded.
Di seguito, esamineremo i tipi di segreti gestiti dagli sviluppatori, come funzionano l'archiviazione e l'accesso e in che modo Stripe Projects può aiutare a fornire chiavi API separate per ogni progetto creato da uno sviluppatore o da un team.
In sintesi:
Le chiavi Application Programming Interface (API), i token di accesso, le credenziali del database, i certificati e le chiavi di crittografia comportano ciascuno rischi e cicli di vita specifici.
Credenziali con ambito di validità limitato, rotazione programmata e audit log riducono i danni che può causare un singolo segreto esposto.
Gli strumenti autonomi che richiamano le Application Programming Interface (API) e l'infrastruttura necessitano di accessi distinti, limitati e revocabili anziché di ampie autorizzazioni a livello di account.
Perché le best practice per la gestione dei segreti sono importanti?
La gestione dei segreti riguarda il modo in cui generi, archivi, distribuisci e ritiri le credenziali da cui dipendono le tue applicazioni (app). Una buona gestione dei segreti limita i danni derivanti da una credenziale compromessa rendendone l'accesso chiaro e facile da revocare. Una cattiva gestione dei segreti può consentire a chiunque trovi un singolo valore trapelato di accedere ai sistemi di produzione.
Quali tipi di segreti devono proteggere gli sviluppatori?
Esistono alcune categorie comuni di segreti e ognuna di esse funziona in modo leggermente diverso.
Ecco cosa copre in genere la gestione dei segreti:
Chiavi Application Programming Interface (API): consentono di autenticare la tua applicazione presso un servizio di terze parti, ad esempio un fornitore di servizi di pagamento o un'API di mappatura. Di solito non hanno una scadenza intrinseca, per cui una chiave trapelata garantisce spesso l'accesso completo all'account finché non viene revocata manualmente.
Token di accesso: i token di accesso Open Authorization (OAuth) e i Web Token JavaScript Object Notation (JSON) trasportano le autorizzazioni di un utente o di un servizio e, in genere, hanno un ciclo di vita più breve rispetto alle chiavi API. Sono presenti in applicazioni mobili, nei flussi Single Sign-On e nelle chiamate da servizio a servizio.
Credenziali del database: i nomi utente, le password e le stringhe di connessione per sistemi come PostgreSQL, MySQL o MongoDB si trovano nei file di configurazione e nei pool di connessioni. Spesso vengono duplicati in più ambienti contemporaneamente.
Certificati e chiavi private: i certificati Transport Layer Security (TLS) e le chiavi Secure Shell (SSH) verificano l'identità e proteggono le connessioni tra i server. I certificati scaduti o non archiviati correttamente causano interruzioni del servizio tanto spesso quanto le violazioni.
Chiavi di crittografia: le chiavi che crittografano i dati a riposo o in transito sono gestite da servizi come Amazon Web Services Key Management Service (AWS KMS) o dal motore di transito di HashiCorp Vault. Perdere una di queste chiavi può significare perdere l'accesso ai dati che essa protegge.
Variabili d'ambiente: di per sé non costituiscono dei segreti. Sono il meccanismo di distribuzione utilizzato da molte applicazioni per richiamare i segreti in un processo in esecuzione e rappresentano un modo semplice per far trapelare un valore in un file di log o in un report di crash.
Questi segreti sono presenti in vari ambienti: macchine di sviluppo locali, pipeline di Continuous Integration e Continuous Delivery (CI/CD), infrastrutture cloud e sistemi di produzione. Un valore rigorosamente bloccato in un ambiente può essere completamente accessibile in un altro.
Come funziona la gestione dei segreti?
La gestione dei segreti sostituisce i valori hardcoded con una ricerca. Invece di scrivere una password per il database direttamente nel codice, in fase di runtime la tua applicazione la richiede a un archivio centralizzato, che decide se rilasciarla o meno.
Le variabili d'ambiente sono più semplici. I sistemi di orchestrazione dei container ti consentono di inserire i segreti come variabili d'ambiente o file montati in fase di distribuzione. In questo modo rimangono fuori dalla base di codice, ma non vengono crittografati una volta inseriti in un container in esecuzione. I sistemi di gestione della configurazione si collocano a metà strada: proteggono un segreto in transito e all'interno del repository di configurazione, ma la responsabilità di come il sistema ricevente lo gestirà in seguito spetta comunque a te.
Le piattaforme centralizzate per la gestione delle credenziali creano rotazione, controllo delle versioni e audit trail al di sopra dell'archiviazione. Quando il tuo codice ha bisogno di un segreto, si autentica sulla piattaforma tramite un account di servizio, un ruolo Identity and Access Management (IAM) o un token di breve durata e ottiene una credenziale limitata nel tempo e nell'ambito di validità invece di una credenziale statica. Questo permette a un team di revocare l'accesso a un singolo servizio senza dover intervenire su tutte le altre credenziali del sistema.
Quali sono alcune best practice per la gestione dei segreti?
Una buona gestione dei segreti si fonda su abitudini che un team mantiene costantemente nel tempo.
Queste pratiche compaiono in quasi tutti i framework rigorosi:
Concedi l'accesso con privilegi minimi: fornisci a ciascun servizio o persona solo i segreti specifici di cui ha bisogno, limitandoli ad ambienti e azioni particolari. Una pipeline di Continuous Integration (CI) che esegue la distribuzione in ambiente di staging non deve mai disporre delle stesse credenziali di una pipeline che esegue la distribuzione in produzione.
Ruota i segreti in base a una pianificazione: le chiavi API a lungo termine e le password dei database devono essere ruotate regolarmente e subito dopo l'uscita di un dipendente o in caso di sospetta esposizione. La rotazione automatica elimina qualsiasi scusa per evitarla.
Imposta una scadenza per i token: i token di breve durata, che scadono in minuti o ore, riducono la finestra di danno in caso di fuga di informazioni. I token di accesso OAuth sono solitamente associati a token di aggiornamento con ciclo di vita più lungo, anziché a un singolo valore statico.
Registra ogni richiesta di accesso: gli audit log devono indicare quale identità ha effettuato l'accesso a quale segreto, in che momento e da dove. In questo modo, è possibile stabilire se una credenziale sia stata compromessa durante un incidente, senza dover tirare a indovinare.
Separa i segreti in base all'ambiente: sviluppo, staging e produzione devono avere le proprie credenziali archiviate nei rispettivi vault o namespace. Una password per il database di test non deve mai funzionare per il database di produzione.
Condividi i segreti tramite il vault, non in chat o via email: se si incolla una credenziale su Slack o in un ticket di assistenza, la si inserisce in un sistema che non è stato concepito per proteggerla. Molte piattaforme per la gestione dei segreti supportano invece link di condivisione temporanei e revocabili.
Verifica la presenza di credenziali esposte in ogni commit: scanner come GitHub secret scanning, TruffleHog e Gitleaks analizzano commit e pull request per rilevare l'esposizione accidentale di credenziali prima o subito dopo un'unione.
Rimuovi i segreti trapelati dalla cronologia delle versioni: per prima cosa bisogna revocare la credenziale esposta, poiché eliminarla dalla cronologia di git è inutile se il vecchio valore è ancora funzionante. Strumenti come git filter-repo o BFG Repo-Cleaner consentono poi di rimuoverla dai commit passati, benché chiunque abbia clonato il repository in precedenza ne conservi comunque una copia.
Quali sono i rischi di una cattiva gestione dei segreti?
La ricerca annuale di GitGuardian sui commit pubblici di GitHub ha rilevato che il 15% degli autori di commit ha lasciato trapelare un segreto nel 2024. Il rischio immediato è l'accesso non autorizzato. Una credenziale del database trapelata può essere individuata e gli scanner automatici possono eseguire la ricerca nei repository pubblici pochi minuti dopo un push.
Oltre all'esposizione iniziale, una chiave rubata che passa inosservata può rimanere attiva per mesi, poiché molte attività dispongono di una procedura per rilevare gli errori di accesso, ma non per individuare l'uso non autorizzato di una credenziale tecnicamente valida. Un malintenzionato che si intrufola in questo modo non ha alcun bisogno di aggirare l'autenticazione: ne è già in possesso.
Una cattiva gestione dei segreti comporta anche rischi che non hanno nulla a che fare con i criminali informatici. I certificati scaduti causano interruzioni del servizio. Le credenziali ruotate che non vengono aggiornate ovunque interrompono le integrazioni in momenti casuali. I team che condividono i segreti in modo informale, via email o in un documento condiviso, rischiano di perdere traccia di chi ha effettivamente accesso.
Come si applica la gestione dei segreti agli agenti di intelligenza artificiale e ai flussi di lavoro di sviluppo?
Gli agenti di programmazione basati su intelligenza artificiale (IA) cambiano le carte in tavola poiché, spesso, necessitano di credenziali reali per compiere un vero lavoro, ad esempio effettuare una chiamata API, interrogare un database o distribuire del codice. Un agente esegue le istruzioni alla velocità della macchina, per cui una credenziale con ambito di validità mal definito può causare danni in diversi sistemi prima che qualcuno se ne accorga.
Questo rischio cresce con il numero di strumenti che un agente può richiamare. Un agente collegato a un'API di pagamento, a un fornitore di servizi cloud e a un sistema di ticketing interno necessita di credenziali distinte e con un ambito di validità specifico per ciascuno, non di un singolo set di autorizzazioni ampie in grado di coprire tutto. Senza questa separazione, la compromissione di una singola sessione di un agente può avere ripercussioni ben più vaste del previsto.
Stripe Projects risolve in parte questo problema per gli sviluppatori che creano su Stripe. Consente di fornire chiavi API separate per ciascun progetto creato da uno sviluppatore o da un team, con ambito di validità limitato ai dati e all'ambiente di quello specifico progetto. Una chiave utilizzata da un agente o da un'applicazione non garantisce l'accesso a un'altra. Stripe Projects gestisce il provisioning, l'archiviazione delle credenziali e la fatturazione per i servizi di infrastruttura di terze parti.
Come scegliere gli strumenti giusti per la gestione dei segreti?
La scelta giusta dipende dalla tua infrastruttura.
Alcune domande permettono di restringere rapidamente l'elenco:
Si integra con il tuo fornitore di identità? Un sistema che non è in grado di eseguire l'autenticazione con la tua configurazione Identity and Access Management (IAM) o Single Sign-On (SSO) esistente richiede di gestire un secondo sistema di identità. Questo si traduce solitamente in un controllo degli accessi più debole.
Supporta la rotazione automatica per i servizi che utilizzi? La rotazione nativa per i database e i servizi cloud più comuni consente di risparmiare il lavoro manuale di creazione e manutenzione autonoma degli script di rotazione.
Permette di applicare credenziali di breve durata e con un ambito di validità specifico? I segreti statici e di lunga durata rappresentano il modello da cui si sta cercando di allontanarsi. Un sistema che archivia soltanto i valori senza emetterne di dinamici risolve solo metà del problema.
Produce audit log effettivamente utilizzabili? I log che registrano gli accessi senza dettagli sufficienti per ricostruire un incidente non sono di grande utilità in caso di necessità.
In che modo gestisce i segreti necessari per i tuoi strumenti di IA? Se agenti o flussi di lavoro automatizzati richiedono credenziali, verifica se il sistema è in grado di definire un ambito di validità e una scadenza separati rispetto agli accessi degli operatori umani.
Come Stripe Projects può aiutarti
Stripe Projects consente agli sviluppatori e ai loro agenti di IA di aggiungere servizi, generare credenziali e gestire la fatturazione dall'interfaccia a riga di comando (CLI).
Stripe Projects ti aiuta a:
Esegui il provisioning dei servizi di terze parti dalla riga di comando: usa un unico flusso di lavoro per aggiungere servizi, gestire le credenziali e aggiornare i piani, invece di strumenti e flussi di lavoro diversi per ogni fornitore. Gestisci hosting, database, autorizzazione, intelligenza artificiale e molto altro senza aver bisogno di dashboard, file di configurazione o codice dell'infrastruttura.
Sincronizza le credenziali automaticamente: mantieni le variabili d'ambiente portabili tra configurazioni locali, macchine, membri del team e agent, senza copiare e incollare le chiavi dell'application programming interface (API).
Gestisci la fatturazione dalla CLI o dal tuo agent di programmazione: imposta i dati di fatturazione una sola volta e condividili in modo sicuro con i servizi di terze parti. Effettua l'upgrade e il downgrade dei livelli, monitora l'utilizzo e gestisci gli abbonamenti dalla CLI.
Scopri di più su come Stripe Projects aiuta a semplificare il provisioning delle app, oppure copia e incolla questo comando nel tuo terminale e inizia oggi stesso:
brew install stripe/stripe-cli/stripe && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
I contenuti di questo articolo hanno uno scopo puramente informativo e formativo e non devono essere intesi come consulenza legale o fiscale. Stripe non garantisce l'accuratezza, la completezza, l'adeguatezza o l'attualità delle informazioni contenute nell'articolo. Per assistenza sulla tua situazione specifica, rivolgiti a un avvocato o a un commercialista competente e abilitato all'esercizio della professione nella tua giurisdizione.