Gestori di secret self-hosted a confronto su un VPS
Confronto pratico tra OpenBao, Infisical, SOPS con age, credenziali systemd e file env protetto: costi, rischi e scelta adatta a un solo VPS.
Cosa fa un gestore di secret self-hosted che un gestore di password non fa
Un gestore di secret self-hosted fornisce le credenziali ai processi. Un gestore di password fornisce le credenziali alle persone. Tutto il resto deriva da questa differenza. Un gestore di password viene sbloccato da una persona presente e attenta. Un gestore di secret deve fornire alla tua applicazione la password di un database alle 03:00, quando nessuno è sveglio.
Le modalità di errore sono diverse, e questo è importante. Un gestore di password bloccato è un inconveniente: inserisci di nuovo la password principale. Un gestore di secret sigillato causa un'interruzione del servizio: ogni servizio che viene riavviato mentre il gestore è sigillato si avvia senza credenziali e resta inattivo. Usare Vaultwarden come gestore di password personale risolve bene il problema umano. Non risolve il problema delle macchine, e non è mai stato progettato per farlo. Se lo esegui insieme a questa soluzione, gli elementi da proteggere maggiormente sono il suo token amministrativo e il file di backup, non il contenuto del vault, che il client cifra già; una verifica di hardening di Vaultwarden copre entrambi.
Le opzioni realistiche per un unico server rientrano in due gruppi. OpenBao e Infisical sono servizi: un'API, un database, TLS (transport layer security), una procedura di accesso e un processo che devi mantenere in esecuzione. SOPS con age, le credenziali di systemd e i secret di Docker sono file: cifrati a riposo e decifrati da un componente già in esecuzione, senza altri elementi da monitorare.
Ecco subito la risposta più diretta. Per un singolo server usato da una o due persone, le opzioni basate sui file sono generalmente la scelta corretta. Un'istanza OpenBao che nessuno sa disigillare correttamente e per la quale nessuno esegue la rotazione è peggiore di un file di ambiente con permessi mode 600, perché aggiunge un componente soggetto a guasti e un backup che probabilmente configurerai in modo errato, senza offrire alcuna rotazione che non stessi già eseguendo manualmente.
Un file .env con permessi 600 è sufficiente?
Spesso sì. La minaccia che contrasta è che un altro utente del server legga la password del database. I permessi dei file Unix lo impediscono, prima ancora che la rete sia disponibile.
sudo install -d -m 750 -o root -g myapp /etc/myapp
sudo install -m 640 -o root -g myapp /dev/null /etc/myapp/env
sudoedit /etc/myapp/envVerificatelo da entrambi i lati:
sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/envIl primo comando stampa il file. Il secondo stampa cat: /etc/myapp/env: Permission denied, perché nobody non appartiene al gruppo myapp e il file non ha permessi per gli altri utenti. Questo è l'intero modello di sicurezza, ed è un modello effettivo.
La fuga di dati avviene subito dopo. Un'unità systemd con EnvironmentFile= copia quei valori nell'ambiente del processo, che è leggibile.
[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myappsudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'Il comando stampa i secret in chiaro, perché /proc/<pid>/environ è leggibile da root e dall'utente con cui viene eseguito il processo. Un sistema di raccolta dei crash che include l'ambiente in un report vede gli stessi dati. Lo stesso vale per qualsiasi strumento eseguito con lo stesso account. Per questo tenere i secret fuori dagli agenti AI inizia dal rimuoverli dall'ambiente. Abbinate il file a un utente di servizio dedicato con privilegi minimi, in modo che «l'utente con cui viene eseguito il processo» non sia root.
SOPS con age: secret crittografati che puoi salvare in git
SOPS (secrets operations) crittografa i valori contenuti in un file YAML o JSON e lascia le chiavi in chiaro. age è uno strumento di crittografia compatto che fornisce una coppia di chiavi senza richiedere un key server. Insieme consentono di salvare secrets.enc.yaml accanto al codice; git diff mostra comunque quale impostazione è cambiata senza rivelare a chi legge il nuovo valore.
age è incluso nei pacchetti di Ubuntu 24.04. SOPS non lo è, quindi scarica il .deb dalla pagina delle release. La versione 3.13.3 era quella corrente a ottobre 2026.
sudo apt update && sudo apt install -y age
curl -LO https://github.com/getsops/sops/releases/download/v3.13.3/sops_3.13.3_amd64.deb
sudo apt install -y ./sops_3.13.3_amd64.deb
sops --versionGenera una coppia di chiavi. age-keygen scrive la chiave privata nel file e stampa la chiave pubblica, quindi vedrai una riga che inizia con Public key: age1....
mkdir -p ~/.config/sops/age
age-keygen -o ~/.config/sops/age/keys.txt
chmod 600 ~/.config/sops/age/keys.txt
age-keygen -y ~/.config/sops/age/keys.txtInserisci la chiave pubblica in .sops.yaml nella directory radice del repository, così non dovrai ricordare il destinatario nella riga di comando.
creation_rules:
- age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23csops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yamlUna regola senza path_regex corrisponde a tutto, ed è ciò che serve inizialmente. Se in seguito ne aggiungi una, scrivila in modo che corrisponda al file passato a sops, perché le regole vengono verificate rispetto al percorso di input e non rispetto al file verso cui reindirizzi l'output.
In fase di esecuzione, passa i valori a un solo processo e a nient'altro:
sops exec-env secrets.enc.yaml './myapp'sops exec-env decrittografa i valori in memoria e li imposta nell'ambiente del processo figlio, quindi nessun testo in chiaro viene scritto su disco. Al processo figlio si applica comunque l'avvertenza sull'ambiente descritta nella sezione precedente.
In questo contesto, due aspetti causano spesso problemi. In systemd, l'errore Failed to get the data key required to decrypt the SOPS file significa quasi sempre che SOPS ha cercato nella directory home errata, perché un'unità non eredita il tuo HOME. Imposta esplicitamente il percorso con Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt nell'unità. Inoltre, modificare .sops.yaml non ricrittografa ciò che esiste già: aggiungere la chiave pubblica di un collega influisce solo sui nuovi file, quindi esegui sops updatekeys secrets.enc.yaml su ogni file esistente. Se la configurazione viene già gestita tramite Ansible, crittografare gli stessi valori con Ansible Vault consente di ottenere lo stesso risultato senza introdurre un secondo strumento.
Credenziali systemd: secret che non arrivano mai nell'ambiente
Ubuntu 24.04 include systemd 255, quindi non è necessaria alcuna installazione. systemd-creds cifra un secret sull'host e systemd lo decifra in una directory privata, leggibile soltanto dal servizio interessato.
sudo systemd-creds setup
sudo install -d -m 700 /etc/myapp
echo -n 'hunter2' | sudo systemd-creds encrypt --name=db_password - /etc/myapp/db_password.cred[Service]
User=myapp
LoadCredentialEncrypted=db_password:/etc/myapp/db_password.cred
ExecStart=/usr/local/bin/myappIl servizio legge il valore da un file chiamato db_password, all'interno della directory indicata da $CREDENTIALS_DIRECTORY. Il valore non si trova nell'ambiente, quindi /proc/<pid>/environ non mostra informazioni utili e il testo in chiaro non viene mai scritto nel filesystem root.
Verifica che il file venga decifrato prima di configurarlo in un'unità:
sudo systemd-creds decrypt /etc/myapp/db_password.cred -Devi sapere quale chiave lo ha cifrato, perché da questo dipende l'utilità del backup. Il valore predefinito --with-key=auto utilizza il chip TPM2 (trusted platform module versione 2) se ne trova uno e non è in esecuzione in un container, e utilizza la chiave dell'host se /var/lib/systemd/ si trova su un supporto persistente. Su una macchina in cui valgono entrambe le condizioni, la credenziale è associata a entrambi e per decifrarla devono essere presenti entrambi. La maggior parte delle istanze VPS non dispone di un TPM2.
systemd-analyze has-tpm2no significa che è stata utilizzata soltanto la chiave dell'host. Questa chiave si trova in /var/lib/systemd/credential.secret ed è leggibile soltanto da root. Se ripristini db_password.cred su un VPS nuovo senza quel file, non sarà mai possibile decifrarlo. Copia credential.secret nello stesso backup oppure conserva il testo in chiaro in una posizione ancora accessibile. Se stampa yes, la credenziale è associata anche al chip di quella macchina, quindi non verrà decifrata altrove nemmeno con credential.secret; in questo caso è utile soltanto la copia in chiaro.
Segreti Docker: file in /run/secrets
Compose legge un file dall'host e lo monta nel container in /run/secrets/<name>.
services:
app:
image: myapp:latest
environment:
DB_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
secrets:
db_password:
file: ./db_password.txtdocker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i passwordIl primo comando stampa il segreto. Il secondo stampa soltanto DB_PASSWORD_FILE=/run/secrets/db_password, che è il punto: il valore non è mai presente nell'ambiente del container, quindi non compare nell'output di docker inspect. Molte immagini ufficiali prevedono già questo formato e l'immagine Postgres legge POSTGRES_PASSWORD_FILE esattamente in questo modo.
È importante chiarire di cosa si tratta. Al di fuori della modalità Swarm non esiste alcuna cifratura a nessun livello: ./db_password.txt è un file in chiaro sull'host e l'unica protezione consiste nei suoi permessi e nel relativo proprietario. Imposta entrambi manualmente, perché Compose monta senza problemi un file leggibile da tutti. L'analisi più ampia dei compromessi rispetto alla scorciatoia env_file è disponibile nella guida ai file env e ai segreti di Compose.
Qual è il costo reale di gestione di OpenBao e Vault
OpenBao è il fork di HashiCorp Vault gestito dalla Linux Foundation, avviato dopo che HashiCorp ha rilasciato Vault con la Business Source License nel 2023. OpenBao resta sotto la MPL 2.0 (Mozilla Public License). La release 2.7.2, pubblicata il 26 October 2026, era la release più recente al momento della verifica, il 27 October 2026. Quasi tutto ciò che segue si applica anche a Vault, perché il fork ha mantenuto la stessa interfaccia dei comandi.
docker pull docker.io/openbao/openbaoI pacchetti .deb per Debian e Ubuntu sono allegati a ogni release su GitHub, se si preferisce gestire l'installazione tramite apt. Il server richiede un file di configurazione con un listener e un backend di storage:
listener "tcp" {
address = "127.0.0.1:8200"
tls_cert_file = "/path/to/full-chain.pem"
tls_key_file = "/path/to/private-key.pem"
}
storage "raft" {
path = "/path/to/raft/data"
node_id = "raft_node_1"
}Quindi avvialo una volta:
bao operator initPer impostazione predefinita, il comando divide la root key in 5 share e ne richiede 3 per eseguire l'unseal: sono i flag -key-shares e -key-threshold. Il comando stampa le share e il token root iniziale. Registrali entrambi in quel momento, perché senza le share non è possibile decrittografare lo storage.
Questa è la parte che la maggior parte dei confronti omette. Un server riavviato è un server sealed. OpenBao conserva la root key soltanto in memoria, quindi dopo un riavvio non può decrittografare il proprio storage finché qualcuno non fornisce il numero di share richiesto dalla soglia. Di conseguenza, un aggiornamento del kernel o un'interruzione per esaurimento della memoria lasciano il server sealed e le applicazioni non possono effettuare il login.
Su un VPS utilizzato da una sola persona, la suddivisione Shamir non protegge nulla, perché tutte e cinque le share finiscono nello stesso password manager della stessa persona. L'auto-unseal trasferisce la key a un dispositivo o servizio attendibile. In un cloud di grandi dimensioni questo significa in genere un managed key service; sul proprio VPS significa di solito un file di key sullo stesso disco dei dati che dovrebbe proteggere. È una riduzione effettiva della sicurezza, accettata in cambio di un server che torna operativo automaticamente dopo un riavvio. Effettua questa scelta consapevolmente e annota quale opzione hai adottato.
Infisical: un'interfaccia, un database e una master key che resta sotto il tuo controllo
Infisical è una piattaforma per i secret con interfaccia web, progetti, ambienti e controllo degli accessi per utente. Per eseguirlo in self-hosting con Compose bastano pochi passaggi:
curl -o docker-compose.prod.yml https://raw.githubusercontent.com/Infisical/infisical/main/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/Infisical/infisical/main/.env.example
docker compose -f docker-compose.prod.yml up -dModifica .env prima di eseguire l'ultimo comando. Due valori devono essere generati da te, e uno di questi non deve mai essere modificato manualmente in seguito:
openssl rand -hex 16
openssl rand -base64 32Il primo è ENCRYPTION_KEY, una stringa esadecimale di 16 byte. È la key con cui i tuoi secret vengono cifrati all'interno di PostgreSQL. Se la perdi, un backup perfettamente integro del database diventa soltanto un insieme di ciphertext. Se sostituisci questa key con un valore scelto da te su un'istanza in esecuzione, i secret esistenti non possono più essere decrittografati. Per ruotarla, segui invece la procedura documentata da Infisical: la console del server genera la nuova key, mentre quella precedente resta valida finché tutte le istanze non sono passate alla nuova e non la rimuovi. Se non la rimuovi, Infisical la elimina automaticamente durante la prima pulizia settimanale successiva a un periodo di conservazione di 7 days, valore predefinito. Salva quindi la vecchia key prima di quel momento, se ti serve ancora. Il secondo valore è AUTH_SECRET, una stringa base64 di 32 byte utilizzata per le sessioni. SITE_URL deve essere l'URL assoluto effettivamente utilizzato per raggiungere il servizio, incluso il protocollo, altrimenti il redirect del login non funziona.
Infisical è più adatto di OpenBao quando ciò che serve realmente sono utenti: un'interfaccia web per un piccolo team e la separazione tra gli ambienti, invece di credenziali del database con scadenza automatica. Il costo operativo comprende PostgreSQL, Redis e un certificato TLS, che dovrai aggiornare e sottoporre a backup.
Cosa accade quando il servizio dei secret è inattivo e l'applicazione viene riavviata
Questa domanda determina se un servizio dei secret debba risiedere su un unico server. I file sono leggibili prima dell'avvio della rete. Un servizio no.
Riavviate il server: l'applicazione e OpenBao si avviano nello stesso momento. L'applicazione richiede la password del database, OpenBao è ancora sealed e la richiesta non va a buon fine. Se l'unità imposta Restart=, systemd riavvia l'applicazione finché un amministratore non inserisce gli unseal share oppure finché il limite di frequenza degli avvii impostato da StartLimitIntervalSec= e StartLimitBurst= non interrompe i tentativi, lasciando l'unità in stato failed. Senza Restart=, il cui valore predefinito è no, l'applicazione rimane semplicemente inattiva. Non c'è alcun guasto. Ma non c'è neppure alcun servizio attivo.
Esistono due approcci corretti. Ordinate le unità e lasciate che l'applicazione ritenti: After= il servizio dei secret, insieme a Restart=on-failure, un RestartSec= sufficientemente lungo da non sovraccaricare l'API, e a un limite di frequenza degli avvii che non interrompa i tentativi prima che qualcuno possa eseguire l'unseal. In alternativa, recuperate il secret durante il deploy anziché all'avvio: scrivetelo in un file con modalità 600 oppure in una systemd credential, così il sistema in esecuzione dipende da un file e non da un'API.
La scadenza dei token è lo stesso problema, ma su una scala temporale più lunga. I token e i lease di OpenBao hanno un time to live, quindi un processo di lunga durata che non rinnova mai le proprie credenziali perde l'accesso in un momento non correlato ad alcun deploy. Il problema è difficile da diagnosticare proprio perché quel giorno non è cambiato nulla.
Backup del sistema di storage stesso
Ogni opzione qui descritta ha una chiave, e un backup privo di quella chiave è inutilizzabile. Annotate dove si trova la vostra chiave.
Con un file env, il file è il secret, quindi il backup deve essere cifrato. Con SOPS, il file cifrato può essere archiviato in un luogo pubblico, mentre la chiave privata age in ~/.config/sops/age/keys.txt è l'elemento che non dovete perdere. Per le credenziali systemd, eseguite il backup di /var/lib/systemd/credential.secret insieme ai file .cred. Per Infisical, create un dump PostgreSQL e archiviate ENCRYPTION_KEY in un luogo separato dal dump. Dopo una rotazione, conservate la chiave precedente insieme a ogni dump creato prima della rotazione, perché per ripristinare quel dump è necessaria la chiave precedente.
OpenBao con storage raft crea un proprio snapshot:
bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snapLo snapshot contiene lo storage cifrato, quindi per ripristinarlo su un nuovo server servono comunque le unseal share di bao operator init. Un job notturno che copia gli snapshot nello storage a oggetti mentre le share vengono conservate in nessun luogo non costituisce alcun backup. Testate il ripristino su un VPS usa e getta prima di farvi affidamento.
Audit logging: chi ha letto quale secret
I file non forniscono una traccia di audit. La modalità e il proprietario indicano chi avrebbe potuto leggere il secret. Non indicano mai chi lo ha letto. auditd con il monitoraggio del percorso è il sostituto più vicino e segnala che un file è stato aperto, non quale valore è stato utilizzato.
OpenBao registra ogni richiesta in un audit device che abiliti esplicitamente. Dalla versione 2.3.2, la creazione tramite API, eseguita da bao audit enable, funziona solo quando la configurazione del server imposta unsafe_allow_api_audit_creation = true; questa opzione è disabilitata per impostazione predefinita. Dichiara invece il device nella configurazione del server, accanto al listener. OpenBao lo abilita al riavvio o tramite SIGHUP:
audit "file" "local" {
description = "Local audit log"
options {
file_path = "/var/log/openbao_audit.log"
}
}Questa modifica del log comporta due aspetti importanti per la gestione del server. La maggior parte delle stringhe nelle richieste e nelle risposte viene sottoposta a hashing con HMAC-SHA256 e un salt. In questo modo puoi confrontare con il log un valore che già conosci, senza che il log contenga il valore in chiaro. Interi e valori booleani vengono invece registrati in chiaro, quindi un secret numerico non riceve alcuna protezione da questo hashing.
Esiste poi un problema operativo: OpenBao non risponde alle richieste quando nessun audit device abilitato può registrarle. Inoltre, un device che si guasta in modalità bloccante fa restare le richieste in attesa finché qualcuno non risolve il problema. Un disco pieno su /var/log interrompe di proposito l'API dei secret. Dedica all'audit log uno spazio separato e configura una regola logrotate fin dal primo giorno, non dopo il primo disservizio.
Quale gestore di secret self-hosted dovresti usare?
Conta le macchine e le persone, poi scegli.
- Una macchina e una persona: un file env di proprietà di
root, leggibile soltanto dal gruppo del servizio (modalità 640, come sopra), oppure un file in modalità 600 chesystemdlegge direttamente per il servizio tramiteEnvironmentFile=. Aggiungi le credenzialisystemdquando vuoi evitare di esporre il valore nell'ambiente del processo. - Una macchina e da due a cinque persone, con la configurazione già presente in git: SOPS con age. Ogni persona riceve una coppia di chiavi e
.sops.yamlelenca tutte le chiavi pubbliche autorizzate a decrittografare. - Più macchine, un unico repository di configurazione e nessuna necessità di credenziali con scadenza: ancora SOPS con age, con una chiave destinataria per ogni host, in modo che una chiave host sottratta possa decrittografare soltanto i file di quell'host.
- Più macchine e più team che hanno realmente bisogno di credenziali del database con una durata definita, oltre a un audit trail che qualcuno consulta: OpenBao. Prevedi nel budget un'ora al mese di lavoro operativo per le procedure di unsealing e le esercitazioni di ripristino.
La regola alla base di tutti e quattro i casi è la stessa. Usa il componente più semplice che soddisfa un requisito che puoi dichiarare esplicitamente, perché un gestore di secret non disponibile è indistinguibile da un gestore di secret vuoto.
FAQ
Un conviene utilizzare un gestore di secret self-hosted su un singolo VPS?
Di solito no, se si intende un servizio come OpenBao o Infisical. Su un unico host usato da una o due persone, un file di variabili d'ambiente con permessi mode 600 oppure una credenziale cifrata di systemd offre la stessa protezione contro gli altri utenti locali, senza una procedura di unseal e senza un servizio aggiuntivo da aggiornare. Un servizio per la gestione dei secret diventa utile quando si gestiscono più macchine e più persone, oppure quando serve usare credenziali con scadenza automatica, senza doverle ruotare manualmente.
Qual è la differenza tra un password manager e un secrets manager?
Un password manager archivia le credenziali che una persona inserisce e viene sbloccato manualmente mentre l'utente è presente. Un secrets manager fornisce le credenziali ai processi, quindi deve funzionare alle 03:00 senza che nessuno lo controlli. Questa è la differenza fondamentale: un password manager bloccato richiede di inserire nuovamente la password principale, mentre un secrets manager sigillato arresta ogni servizio che viene riavviato mentre è sigillato.
Cosa accade alle applicazioni se OpenBao viene sigillato dopo un riavvio?
Non possono recuperare i secret e quindi non si avviano. Se le relative unità impostano Restart=, systemd riprova ad avviarle finché qualcuno non fornisce la soglia di unseal, che per impostazione predefinita è 3 condivisioni su 5, oppure finché il limite di frequenza degli avvii dell'unità non interrompe i tentativi. OpenBao conserva la chiave root soltanto in memoria, quindi ogni riavvio lo sigilla nuovamente. È possibile attivare l'auto unseal, accettando che su un singolo VPS la chiave di unseal finisca sullo stesso disco dei dati, oppure scrivere i secret in un file durante il deploy, in modo che l'avvio non dipenda mai dall'API.
Posso eseguire il commit di file cifrati con SOPS in un repository pubblico?
I valori sono cifrati, quindi sono protetti da chiunque non disponga della chiave privata age. I nomi delle chiavi non sono cifrati: chi legge il repository può vedere che si utilizzano STRIPE_SECRET_KEY e SMTP_PASSWORD e con quale frequenza ciascuno cambia. Per la maggior parte dei progetti questi metadati sono accettabili, ma non lo sono per alcuni. Conservare la chiave privata age fuori dal repository ed eseguire sops updatekeys su ogni file esistente ogni volta che si aggiunge o si rimuove un destinatario.