Cofre
Criptografia em nível de campo para dados Aurabase confidenciais. AES-256-GCM com chave derivada de registro (HKDF-SHA256) ou backend de trânsito HashiCorp Vault em produção — a mesma primitiva protege seus segredos Edge Functions e segredos internos da plataforma.
Um serviço de criptografia, não um produto separado#
“Vault” não é um serviço HTTP separado no gateway: é um mecanismo de criptografia em nível de campo que protege automaticamente seus dados confidenciais antes de gravar no banco de dados – segredos MFA, tokens de provedor OAuth, cadeias de conexão do projeto e os segredos do seu Edge Functions.
O que você realmente manipula, como desenvolvedor, são os segredos por função: pares chave/valor definidos por meio da CLI ou da API REST, injetados como variáveis de ambiente no trabalhador que executa sua função.
O nome “Vault” também se refere ao produto de infraestrutura HashiCorp Vault, implantado em produção como um back-end opcional deste serviço (gerenciamento da chave de criptografia raiz, rotação, credenciais Postgres com vida útil limitada). Os dois significados coexistem: a primitiva de aplicação documentada aqui e a ferramenta de infraestrutura que pode suportá-la.
Dois backends, um formato de leitura#
Na gravação, o serviço escolhe um back-end: Trânsito do Vault se configurado (preferencial - a chave de criptografia raiz nunca sai do Vault), caso contrário, um substituto AES-256-GCM local com uma chave derivada do registro via HKDF-SHA256. Quando lido, o formato do texto cifrado indica qual back-end o produziu — nenhuma migração forçada é necessária para mudar de um para outro.
vault:v1:AbCdEf... # trânsito de back-end – descriptografado via Vault (KEK nunca exposto)
{"key_id":"v1", # back-end AES-256-GCM local (fallback/dev)
"nonce":"…","data":"…"}
sk_live_51J2x... # valor histórico não criptografado (antes da ativação da criptografia)
O contexto de derivação (lado das funções) é project_id:function_name — o mesmo segredo criptografado duas vezes para duas funções produz dois textos cifrados diferentes, e remover/renomear a função torna o texto cifrado antigo ilegível por construção.
O que o serviço oferece#
- AES-256-GCM. Chave de 32 bytes derivada de registro via HKDF-SHA256 (contexto = project_id:function_name). Nonce de 96 bits por gravação.
- Trânsito do cofre de back-end. Na produção, a KEK nunca sai do Vault: criptografia/descriptografia delegada para trânsito/criptografar|descriptografar, vault de texto cifrado versionado:vN:....
- Lendo formatos mais antigos. A descriptografia detecta o formato armazenado (cofre: → trânsito, {...} → AES local, texto simples → histórico não criptografado): failover de back-end sem reescrita forçada.
- Escopo por função. Os segredos do aplicativo documentados aqui têm como escopo uma função (project_id + nome), injetada no trabalhador Deno por meio de
Deno.env.get('KEY'). - CLI dedicada.
aura secrets list,seteunsetlevam--function <name>.listnunca mostra valores em texto simples. - Reutilizado pela plataforma. O mesmo serviço de criptografia também protege, no lado do servidor, segredos MFA, tokens OAuth e cadeias de conexão (db_url_encrypted, anon_key_encrypted).
Três formas de escrever, uma forma de ler#
// Uma vez escrito (CLI ou REST), o segredo é injetado como uma variável
// ambiente do trabalhador que executa a função.
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
A CLI (aura secrets) e o endpoint REST dedicado (/env) manipulam os mesmos dados – os segredos de uma função – mas não necessariamente através do mesmo caminho de gravação. Veja ponto de atenção abaixo.
A criptografia depende do caminho de gravação seguido#
aura-functions expõe duas maneiras de modificar as variáveis de ambiente de uma função: o endpoint PUT /v1/functions/:projectId/:nom/env dedicado (que criptografa sistematicamente via EncryptionService antes da gravação) e o endpoint PATCH /v1/functions/:projectId/:nom genérico usado para atualizar uma função inteira - código, tempo de execução, env_vars incluído - sem passar por essa criptografia.
Variáveis de ambiente configuradas via /env são criptografadas em repouso via AES-256-GCM antes de serem armazenadas. Tanto no desenvolvimento local quanto na produção gerenciada, essa criptografia é realizada de forma transparente para o desenvolvedor.
Para ir mais longe#
- Edge Functions
Tempos de execução, invocação, permissões — onde residem suas funções e seus segredos.
- Cron
Acione uma função (e, portanto, seus segredos) de acordo com uma programação.
- Segurança e RBAC
Funções, políticas RLS, auditoria — o resto do modelo de segurança Aurabase.
- API REST
Superfície HTTP bruta, autenticação de chave de serviço.