Saltar al contenido
Logotipo de Aurabase
aurabase

Bóveda

Cifrado a nivel de campo para datos confidenciales Aurabase. AES-256-GCM con clave derivada de registro (HKDF-SHA256) o backend de tránsito de HashiCorp Vault en producción: la misma primitiva protege sus secretos Edge Functions y los secretos internos de la plataforma.

Explicación6 min leerNivel intermedioRevisado el 15 ago 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Un servicio de cifrado, no un producto independiente#

"Vault" no es un servicio HTTP separado en la puerta de enlace: es un motor de cifrado a nivel de campo que protege automáticamente sus datos confidenciales antes de escribirlos en la base de datos: secretos MFA, tokens de proveedor OAuth, cadenas de conexión del proyecto y los secretos de su Edge Functions.

Lo que realmente manipula, como desarrollador, son los secretos por función: pares clave/valor definidos a través de la CLI o la API REST, inyectados como variables de entorno en el trabajador que ejecuta su función.

Información

El nombre "Vault" también se refiere al producto de infraestructura HashiCorp Vault, implementado en producción como un backend opcional de este servicio (administración de la clave de cifrado raíz, rotación, credenciales Postgres con una vida útil limitada). Los dos significados coexisten: la aplicación primitiva documentada aquí y la herramienta de infraestructura que puede admitirla.

Dos backends, un formato de lectura#

Al escribir, el servicio elige un backend: Vault transit si está configurado (preferido: la clave de cifrado raíz nunca sale de Vault); de lo contrario, un respaldo AES-256-GCM local con una clave derivada del registro a través de HKDF-SHA256. Cuando se lee, el formato del texto cifrado indica qué servidor lo produjo; no es necesaria una migración forzada para cambiar de uno a otro.

formato de texto cifradotext
vault:v1:AbCdEf...     # Tránsito backend: descifrado a través de Vault (KEK nunca expuesto)
{"key_id":"v1",         # backend local AES-256-GCM (alternativa/desarrollo)
 "nonce":"…","data":"…"}
sk_live_51J2x...       # valor histórico no cifrado (antes de la activación del cifrado)
Consejo

El contexto de derivación (lado de funciones) es project_id:function_name: el mismo secreto cifrado dos veces para dos funciones produce dos textos cifrados diferentes, y eliminar/cambiar el nombre de la función hace que el antiguo texto cifrado sea ilegible por construcción.

Qué ofrece el servicio#

  • AES-256-GCM. Clave de 32 bytes derivada del registro a través de HKDF-SHA256 (contexto = project_id:function_name). Nonce de 96 bits por escritura.
  • Tránsito de bóveda backend. En producción, KEK nunca sale de Vault: cifrado/descifrado delegado a tránsito/cifrado|descifrado, bóveda de texto cifrado versionado:vN:....
  • Lectura de formatos antiguos. El descifrado detecta el formato almacenado (bóveda: → tránsito, {...} → AES local, texto sin formato → historial no cifrado): conmutación por error de backend sin reescritura forzada.
  • Alcance por función. Los secretos de la aplicación documentados aquí tienen como alcance una función (project_id + nombre), inyectada al trabajador Deno a través de Deno.env.get('KEY').
  • CLI dedicada. aura secrets list, set y unset toman --function <name>. list nunca muestra valores en texto plano.
  • Reutilizado por la plataforma. El mismo servicio de cifrado también protege, en el lado del servidor, secretos MFA, tokens OAuth y cadenas de conexión (db_url_encrypted, anon_key_encrypted).

Tres formas de escribir, una forma de leer#

functions/echo.tstypescript
// Una vez escrito (CLI o REST), el secreto se inyecta como una variable.
// entorno del trabajador que ejecuta la función.
Deno.serve(async (req) => {
  const cle = Deno.env.get('STRIPE_SECRET_KEY')
  // ...
})
Consejo

La CLI (aura secrets) y el punto final REST dedicado (/env) manipulan los mismos datos (los secretos de una función), pero no necesariamente a través de la misma ruta de escritura. Ver punto de atención a continuación.

El cifrado depende de la ruta de escritura tomada#

aura-functions expone dos formas de modificar las variables de entorno de una función: el punto final dedicado PUT /v1/functions/:projectId/:nom/env (que cifra sistemáticamente a través de EncryptionService antes de escribir) y el punto final genérico PATCH /v1/functions/:projectId/:nom utilizado para actualizar una función completa (código, tiempo de ejecución, env_vars incluido) sin pasar por este cifrado.

Cifrar variables de entorno

Las variables de entorno configuradas mediante /env se cifran en reposo mediante AES-256-GCM antes de almacenarse. Tanto en el desarrollo local como en la producción gestionada, este cifrado se realiza de forma transparente para el desarrollador.

para ir más lejos#