Comparativo de gestores de segredos self-hosted
Compare OpenBao, Infisical, SOPS com age, credenciais do systemd e ficheiros env protegidos para escolher o gestor certo em um único VPS e conhecer os custos.
O que um gestor de segredos self-hosted faz que um gestor de palavras-passe não faz
Um gestor de segredos self-hosted fornece credenciais a processos. Um gestor de palavras-passe fornece credenciais a pessoas. Tudo o resto resulta desta diferença. Um gestor de palavras-passe é desbloqueado por uma pessoa presente e atenta. Um gestor de segredos tem de fornecer a palavra-passe de uma base de dados à sua aplicação às 03:00, quando ninguém está acordado.
Os modos de falha são diferentes de uma forma importante. Um gestor de palavras-passe bloqueado é um incómodo: introduz novamente a palavra-passe principal. Um gestor de segredos selado causa uma indisponibilidade: todos os serviços que reiniciem enquanto ele está selado arrancam sem credenciais e permanecem parados. Executar o Vaultwarden como o seu próprio gestor de palavras-passe resolve bem o problema humano. Não resolve o problema das máquinas, e nunca foi concebido para isso. Se executar um destes serviços em paralelo com este, os elementos que vale a pena reforçar são o seu token de administrador e o ficheiro de cópia de segurança, e não o conteúdo do cofre, que o cliente já cifra; uma revisão de segurança do Vaultwarden abrange ambos.
As opções realistas para um servidor dividem-se em dois grupos. OpenBao e Infisical são serviços: uma API, uma base de dados, TLS (transport layer security), uma etapa de início de sessão e um processo que agora tem de manter ativo. SOPS com age, credenciais do systemd e Docker secrets são ficheiros: cifrados em repouso e decifrados por algo que já está em execução, sem nada adicional para monitorizar.
A resposta direta é esta. Para um único servidor com uma ou duas pessoas, as opções baseadas em ficheiros são normalmente as corretas. Um OpenBao que ninguém sela corretamente e cujas credenciais ninguém roda é pior do que um ficheiro de ambiente com modo 600, porque acrescenta uma componente móvel e uma cópia de segurança que será configurada incorretamente, sem oferecer qualquer rotação que já não estivesse a ser feita manualmente.
Um ficheiro de ambiente com modo 600 é suficiente?
Muitas vezes, sim. A ameaça que ele evita é outro utilizador do servidor ler a palavra-passe da base de dados. As permissões de ficheiros Unix impedem isso antes de a rede estar ativa.
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/envVerifique pelos dois lados:
sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/envO primeiro comando imprime o ficheiro. O segundo imprime cat: /etc/myapp/env: Permission denied, porque nobody não pertence ao grupo myapp e o ficheiro não tem permissões para outros utilizadores. Esse é todo o modelo de segurança, e ele é efetivo.
A fuga acontece a seguir. Uma unidade systemd com EnvironmentFile= copia esses valores para o ambiente do processo, e o ambiente do processo pode ser lido.
[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myappsudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'Esse comando imprime os seus segredos em texto simples, porque /proc/<pid>/environ pode ser lido por root e pelo utilizador com que o processo é executado. Um sistema de recolha de falhas que anexe o ambiente a um relatório verá a mesma informação. O mesmo acontece com qualquer ferramenta executada na mesma conta. Por isso, manter os segredos fora dos agentes de IA começa por removê-los do ambiente. Associe o ficheiro a um utilizador de serviço dedicado com poucos privilégios para que “o utilizador com que o processo é executado” não seja root.
SOPS com age: segredos encriptados que pode versionar no git
O SOPS (secrets operations) encripta os valores de um ficheiro YAML ou JSON e mantém as chaves em texto simples. O age é uma ferramenta de encriptação pequena que fornece um par de chaves e não necessita de um servidor de chaves. Em conjunto, permitem versionar secrets.enc.yaml juntamente com o código, enquanto git diff continua a mostrar qual definição foi alterada sem revelar a um leitor qual passou a ser o seu valor.
O age está disponível como pacote no Ubuntu 24.04. O SOPS não está, por isso descarregue o .deb da página de versões. A versão 3.13.3 era a atual em outubro de 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 --versionGere um par de chaves. age-keygen escreve a chave privada no ficheiro e apresenta a chave pública, pelo que verá uma linha que começa por 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.txtColoque a chave pública em .sops.yaml na raiz do repositório, para não ter de memorizar o destinatário na linha de comandos.
creation_rules:
- age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23csops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yamlUma regra sem path_regex corresponde a tudo, que é o comportamento pretendido inicialmente. Se adicionar uma regra mais tarde, escreva-a para corresponder ao ficheiro que passa a sops, porque as regras são verificadas com base no caminho de entrada e não no ficheiro para o qual redireciona a saída.
Em tempo de execução, entregue os valores a um único processo e a mais nenhum:
sops exec-env secrets.enc.yaml './myapp'sops exec-env desencripta os valores em memória e define-os no ambiente do processo filho, por isso nenhum texto simples é escrito no disco. A limitação do ambiente descrita na secção anterior continua a aplicar-se a esse processo filho.
Há dois problemas frequentes neste caso. O erro Failed to get the data key required to decrypt the SOPS file no systemd quase sempre significa que o SOPS procurou no diretório pessoal errado, porque uma unidade não herda o seu HOME. Defina explicitamente o caminho com Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt na unidade. Separadamente, editar .sops.yaml não volta a encriptar nada do que já existe: adicionar a chave pública de um colega afeta apenas os ficheiros novos, por isso execute sops updatekeys secrets.enc.yaml em cada ficheiro existente. Se a sua configuração já for gerida pelo Ansible, encriptar os mesmos valores com o Ansible Vault permite obter o mesmo resultado sem uma segunda ferramenta.
Credenciais do systemd: segredos que nunca chegam ao ambiente
O Ubuntu 24.04 inclui o systemd 255, portanto não é necessária qualquer instalação. O systemd-creds encripta um segredo no host, e o systemd desencripta-o num diretório privado que apenas esse serviço pode ler.
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/myappO serviço lê o valor de um ficheiro chamado db_password dentro do diretório indicado por $CREDENTIALS_DIRECTORY. O valor não está no ambiente, portanto /proc/<pid>/environ não mostra nada útil, e o texto em claro nunca é gravado no sistema de ficheiros raiz.
Verifique se o ficheiro é desencriptado antes de configurar uma unidade para o utilizar:
sudo systemd-creds decrypt /etc/myapp/db_password.cred -Saiba qual foi a chave usada para o encriptar, porque isso determina se a sua cópia de segurança terá alguma utilidade. O --with-key=auto predefinido usa o chip TPM2 (trusted platform module versão 2) se encontrar um e não estiver a ser executado num contentor, e usa a chave do host se /var/lib/systemd/ estiver num suporte persistente. Numa máquina em que ambas as condições se aplicam, a credencial fica associada a ambos, e ambos têm de estar presentes para a desencriptar. A maioria das instâncias VPS não tem TPM2.
systemd-analyze has-tpm2no significa que apenas a chave do host foi usada. Essa chave está em /var/lib/systemd/credential.secret e só pode ser lida por root. Restaure db_password.cred num VPS novo sem esse ficheiro e nada conseguirá desencriptá-la. Copie credential.secret para a mesma cópia de segurança ou mantenha o texto em claro num local a que ainda consiga aceder. Se mostrar yes, a credencial também está associada ao chip dessa máquina, portanto não será desencriptada noutro local, mesmo com credential.secret, e apenas a cópia em texto claro será útil.
Segredos do Docker: ficheiros em /run/secrets
O Compose lê um ficheiro do host e monta-o no contentor em /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 passwordO primeiro comando imprime o segredo. O segundo imprime apenas DB_PASSWORD_FILE=/run/secrets/db_password, que é precisamente o objetivo: o valor nunca fica no ambiente do contentor, por isso não aparece na saída de docker inspect. Muitas imagens oficiais já esperam este formato, e a imagem do Postgres lê POSTGRES_PASSWORD_FILE exatamente desta forma.
Tenha isto claro. Fora do modo Swarm, não existe encriptação em nenhuma camada: ./db_password.txt é um ficheiro de texto simples no host, e a única proteção é o seu modo e proprietário. Defina ambos manualmente, porque o Compose monta sem qualquer aviso um ficheiro legível por todos. O conjunto mais amplo de compromissos face ao atalho simples env_file está no guia sobre ficheiros env e segredos do Compose.
Quanto o OpenBao e o Vault realmente custam para operar
O OpenBao é o fork do HashiCorp Vault mantido pela Linux Foundation, iniciado depois que a HashiCorp relicenciou o Vault sob a Business Source License em 2023. O OpenBao continua sob a MPL 2.0 (Mozilla Public License). A versão 2.7.2, publicada em 26 October 2026, era a versão mais recente quando verificamos em 27 October 2026. Quase tudo abaixo também se aplica ao Vault, porque o fork manteve a mesma interface de comandos.
docker pull docker.io/openbao/openbaoOs pacotes .deb para Debian e Ubuntu são anexados a cada versão no GitHub, caso você prefira usar o apt para gerenciar a instalação. O servidor precisa de um arquivo de configuração que contenha um listener e um backend de armazenamento:
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"
}Depois, inicie-o uma vez:
bao operator initPor padrão, isso divide a chave root em 5 partes e exige 3 delas para fazer o unseal. Essas são as flags -key-shares e -key-threshold. O comando exibe as partes e o token root inicial. Registre ambos nesse momento, porque sem as partes nada pode descriptografar o armazenamento.
Agora vem a parte que a maioria das comparações ignora. Um servidor reiniciado é um servidor sealed. O OpenBao mantém a chave root apenas na memória. Portanto, depois de uma reinicialização, ele não consegue descriptografar o próprio armazenamento até que alguém forneça o limite necessário de partes. Uma atualização do kernel ou uma finalização por falta de memória, portanto, resulta em um servidor sealed e em aplicações que não conseguem fazer login.
Em uma VPS usada por uma só pessoa, a divisão de Shamir não protege nada, porque as cinco partes acabam no mesmo gerenciador de senhas pertencente à mesma pessoa. O auto-unseal transfere a chave para um dispositivo ou serviço confiável. Em uma nuvem de grande porte, isso significa normalmente um serviço gerenciado de chaves. Na sua VPS, geralmente significa um arquivo de chave no mesmo disco que os dados protegidos por ele. Isso reduz de fato a segurança, em troca de um servidor que volta a funcionar sozinho depois de uma reinicialização. Faça essa troca conscientemente e registre qual opção você escolheu.
Infisical: uma interface, um banco de dados e uma chave mestra que ainda fica com você
O Infisical é uma plataforma de secrets com interface web, projetos, ambientes e controle de acesso por usuário. Hospedá-lo com Compose é simples:
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 -dEdite .env antes de executar esse último comando. Dois valores precisam ser definidos por você, e um deles nunca deve ser alterado manualmente depois:
openssl rand -hex 16
openssl rand -base64 32O primeiro é ENCRYPTION_KEY, uma string hexadecimal de 16 bytes. É a chave usada para criptografar seus secrets dentro do PostgreSQL. Portanto, perdê-la transforma um backup perfeito do banco de dados em um conjunto de textos cifrados. Substituir essa chave por um valor escolhido por você em uma instância em execução impede que os secrets existentes sejam descriptografados. Para fazer a rotação, siga o procedimento documentado pelo Infisical. O console do servidor gera a nova chave, e a antiga continua válida até que todas as instâncias tenham feito a troca e você a remova. Se nunca removê-la, o Infisical a excluirá sozinho na primeira limpeza semanal depois de um período de retenção de 7 dias por padrão. Portanto, salve a chave antiga antes disso se ainda precisar dela. O segundo é AUTH_SECRET, uma string base64 de 32 bytes usada nas sessões. SITE_URL deve ser a URL absoluta que você realmente acessará, incluindo o protocolo. Caso contrário, o redirecionamento de login falhará.
O Infisical é mais adequado que o OpenBao quando o que você realmente precisa são pessoas: uma interface web para uma equipe pequena e separação entre ambientes, em vez de credenciais de banco de dados que expiram sozinhas. O custo inclui PostgreSQL, Redis e um certificado TLS. Agora você também precisa aplicar patches e fazer backup de todos eles.
O que acontece quando o serviço de segredos fica indisponível e a sua aplicação reinicia
Esta pergunta determina se um serviço de segredos deve ficar num único servidor. Os ficheiros podem ser lidos antes de a rede arrancar. Um serviço não pode.
Reinicie o servidor e a sua aplicação e o OpenBao arrancarão ao mesmo tempo. A aplicação pede a palavra-passe da base de dados, o OpenBao ainda está selado e o pedido falha. Se a unidade definir Restart=, o systemd reinicia a aplicação até que alguém introduza manualmente as partes necessárias para remover o selo ou até que o limite de taxa de arranque definido por StartLimitIntervalSec= e StartLimitBurst= interrompa as tentativas e deixe a unidade no estado de falha. Sem Restart=, cujo valor predefinido é no, a aplicação simplesmente permanece parada. Nada está avariado. Mas também nada está a funcionar.
Há duas formas corretas de tratar esta situação. Ordene as unidades e deixe a aplicação repetir a tentativa: After= o serviço de segredos, além de Restart=on-failure, um RestartSec= suficientemente longo para não sobrecarregar a API, e um limite de taxa de arranque que não desista antes de alguém poder remover o selo. Ou obtenha o segredo no momento da implantação, em vez de no arranque: escreva o segredo num ficheiro com modo 600 ou numa credencial do systemd, para que o sistema em execução dependa de um ficheiro, e não de uma API.
A expiração do token é o mesmo problema, mas num relógio mais lento. Os tokens e leases do OpenBao têm um tempo de vida. Por isso, um processo de longa duração que nunca os renova perde o acesso num momento sem relação com qualquer implantação. Esta falha é confusa precisamente porque nada mudou nesse dia.
Fazer o backup do próprio armazenamento
Cada opção apresentada tem uma chave, e um backup sem essa chave não tem utilidade. Registe onde a sua chave está guardada.
Num ficheiro env, o próprio ficheiro é o segredo, por isso o backup tem de ser encriptado. Com SOPS, o ficheiro encriptado pode ficar em qualquer localização pública, e a chave privada age em ~/.config/sops/age/keys.txt é o elemento que não pode perder. Para as credenciais do systemd, faça backup de /var/lib/systemd/credential.secret juntamente com os ficheiros .cred. Com Infisical, faça um dump do PostgreSQL e guarde ENCRYPTION_KEY separadamente. Depois de uma rotação, mantenha a chave antiga junto de qualquer dump criado antes dela, porque o restauro desse dump precisa da chave antiga.
O OpenBao com armazenamento raft cria o seu próprio snapshot:
bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snapO snapshot contém o seu armazenamento encriptado, por isso o restauro num servidor novo continua a precisar das shares de unseal de bao operator init. Um job noturno que copia snapshots para armazenamento de objetos, enquanto as shares não são guardadas em lado nenhum, é um backup de nada. Teste o restauro numa VPS descartável antes de depender dele.
Auditoria de logs: quem leu qual segredo
Os ficheiros não fornecem uma trilha de auditoria. O modo e o proprietário indicam quem poderia ler o segredo. Nunca indicam quem o leu. auditd com uma monitorização do caminho é o substituto mais próximo e informa que um ficheiro foi aberto, não qual valor foi utilizado.
O OpenBao regista cada pedido num dispositivo de auditoria que tem de ativar explicitamente. Desde a versão 2.3.2, a criação de um dispositivo através da API, que é o que bao audit enable faz, só funciona quando a configuração do servidor define unsafe_allow_api_audit_creation = true. Essa opção está desativada por predefinição. Em vez disso, declare o dispositivo na configuração do servidor, junto do listener. O OpenBao ativa-o no reinício ou através de SIGHUP:
audit "file" "local" {
description = "Local audit log"
options {
file_path = "/var/log/openbao_audit.log"
}
}Há dois factos sobre essa alteração no log que afetam a forma como executa o servidor. A maioria das strings nos pedidos e nas respostas é transformada por HMAC-SHA256 com um salt. Assim, pode comparar com o log um valor que já conhece sem que o próprio log contenha o texto simples. Os números inteiros e os booleanos são gravados em texto simples. Por isso, um segredo numérico não fica protegido por esse hashing.
Existe ainda uma armadilha operacional: o OpenBao não responde aos pedidos quando nenhum dispositivo de auditoria ativado consegue registá-los. Um dispositivo que falhe de forma bloqueante faz os pedidos ficarem pendentes até alguém corrigir o problema. Um disco cheio em /var/log faz a API de segredos ficar indisponível por conceção. Reserve espaço próprio para o log de auditoria e configure uma regra do logrotate no primeiro dia, não depois da primeira indisponibilidade.
Qual gestor de segredos self-hosted deve executar?
Conte as máquinas e conte as pessoas. Depois escolha.
- Uma máquina, uma pessoa: um ficheiro de ambiente pertencente a root que apenas o grupo do serviço possa ler (modo 640, como acima), ou um ficheiro com modo 600 que o próprio systemd lê para o serviço através de
EnvironmentFile=. Adicione credenciais do systemd quando quiser retirar o valor do ambiente do processo. - Uma máquina, duas a cinco pessoas, configuração já armazenada no git: SOPS com age. Cada pessoa recebe um par de chaves, e
.sops.yamllista todas as chaves públicas autorizadas a desencriptar. - Várias máquinas, um repositório de configuração, sem necessidade de credenciais com expiração: continue a usar SOPS com age, com uma chave de destinatário por host, para que uma chave de host roubada desencripte apenas os ficheiros desse host.
- Várias máquinas e várias equipas que precisam realmente de credenciais de base de dados com validade, além de um registo de auditoria que alguém consulte: OpenBao. Reserve no orçamento uma hora mensal de trabalho do operador para procedimentos de unsealing e testes de restauração.
A regra subjacente aos quatro casos é a mesma. Execute o componente mais pequeno que cumpra um requisito que consiga declarar claramente, porque um gestor de segredos indisponível não se distingue de um gestor de segredos vazio.
FAQ
Um gestor de segredos alojado localmente vale a pena para um único VPS?
Normalmente, não, se estiver a referir-se a um serviço como OpenBao ou Infisical. Num único servidor, com uma ou duas pessoas, um ficheiro de ambiente com permissões mode 600 ou uma credencial encriptada do systemd oferece a mesma proteção contra outro utilizador local, sem uma etapa de unseal e sem outro serviço para atualizar. Um serviço de segredos começa a compensar quando existem várias máquinas e várias pessoas, ou uma necessidade real de credenciais que expirem sem que alguém tenha de as rodar manualmente.
Qual é a diferença entre um gestor de palavras-passe e um gestor de segredos?
Um gestor de palavras-passe armazena credenciais introduzidas por uma pessoa, e uma pessoa desbloqueia-o enquanto está presente. Um gestor de segredos fornece credenciais a processos, por isso tem de funcionar às 03:00 sem ninguém a monitorizá-lo. Esta é a diferença essencial: um gestor de palavras-passe bloqueado obriga a introduzir novamente uma palavra-passe principal, enquanto um gestor de segredos selado interrompe todos os serviços que reiniciem enquanto permanecer selado.
O que acontece às minhas aplicações se o OpenBao ficar selado depois de um reboot?
Não conseguem obter os segredos e, por isso, não arrancam. Se as respetivas unidades definirem Restart=, o systemd tenta iniciá-las novamente até alguém fornecer o limiar de unseal, que por predefinição é de 3 em 5 partes, ou até o limite da taxa de arranque da unidade interromper as tentativas. O OpenBao mantém a root key apenas na memória, por isso cada reinício volta a selá-lo. Ative o auto unseal, aceitando que, num único VPS, a chave de unseal ficará no mesmo disco que os dados, ou escreva os segredos num ficheiro no momento do deploy para que o arranque nunca dependa da API.
Posso fazer commit de ficheiros encriptados com SOPS num repositório público?
Os valores estão encriptados, por isso estão protegidos contra qualquer pessoa sem a chave privada age. As chaves não estão encriptadas: um leitor consegue ver que detém STRIPE_SECRET_KEY e SMTP_PASSWORD, bem como a frequência com que cada uma muda. Estes metadados são aceitáveis para a maioria dos projetos e inaceitáveis para alguns. Mantenha a chave privada age fora do repositório e execute sops updatekeys em todos os ficheiros existentes sempre que adicionar ou remover um destinatário.