Ir para o conteúdo
Aura Logo
aurabase

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.

Explicação6 min lidoNível intermediárioRevisado em 15 de ago. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

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.

Informações

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.

formato de texto cifradotext
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)
Dica

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, set e unset levam --function <name>. list nunca 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#

functions/echo.tstypescript
// 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')
  // ...
})
Dica

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.

Criptografando variáveis de ambiente

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#