Volta
Crittografia a livello di campo per dati sensibili Aurabase. AES-256-GCM con chiave derivata dal record (HKDF-SHA256) o backend di transito HashiCorp Vault in produzione: la stessa primitiva protegge i tuoi segreti Edge Functions e i segreti della piattaforma interna.
Un servizio di crittografia, non un prodotto separato#
"Vault" non è un servizio HTTP separato sul gateway: è un motore di crittografia a livello di campo che protegge automaticamente i tuoi dati sensibili prima di scriverli nel database: segreti MFA, token del provider OAuth, stringhe di connessione del progetto e segreti del tuo Edge Functions.
Ciò che effettivamente manipoli, come sviluppatore, sono i segreti per funzione: coppie chiave/valore definite tramite la CLI o l'API REST, inserite come variabili di ambiente nel lavoratore che esegue la tua funzione.
Il nome "Vault" si riferisce anche al prodotto infrastrutturale HashiCorp Vault, distribuito in produzione come backend opzionale di questo servizio (gestione della chiave di crittografia root, rotazione, credenziali Postgres con una durata limitata). I due significati coesistono: la primitiva applicativa qui documentata, e lo strumento infrastrutturale in grado di supportarla.
Due backend, un formato di lettura#
In fase di scrittura, il servizio sceglie un backend: Transito Vault se configurato (preferito: la chiave di crittografia root non lascia mai Vault), altrimenti un fallback AES-256-GCM locale con una chiave derivata dalla registrazione tramite HKDF-SHA256. Una volta letto, il formato del testo cifrato indica quale backend lo ha prodotto: non è necessaria alcuna migrazione forzata per passare dall'uno all'altro.
vault:v1:AbCdEf... # transito backend: decrittografato tramite Vault (KEK mai esposto)
{"key_id":"v1", # backend AES-256-GCM locale (fallback/sviluppo)
"nonce":"…","data":"…"}
sk_live_51J2x... # valore storico non crittografato (prima dell'attivazione della crittografia)
Il contesto di derivazione (lato funzioni) è project_id:function_name: lo stesso segreto crittografato due volte per due funzioni produce due testi cifrati diversi e la rimozione/rinomina della funzione rende il vecchio testo cifrato illeggibile per costruzione.
Cosa fornisce il servizio#
- AES-256-GCM. Chiave da 32 byte derivata dalla registrazione tramite HKDF-SHA256 (contesto = project_id:function_name). Nonce a 96 bit per scrittura.
- Transito del Vault backend. In produzione, la KEK non lascia mai il Vault: crittografia/decrittografia delegata a transit/encrypt|decrypt, testo cifrato con versione vault:vN:....
- Lettura dei formati precedenti. La decrittografia rileva il formato memorizzato (vault: → transito, {...} → AES locale, testo normale → cronologia non crittografata): failover backend senza riscrittura forzata.
- Ambito per funzione. I segreti dell'applicazione documentati qui hanno come ambito una funzione (project_id + name), inserita nel Deno lavoratore tramite
Deno.env.get('KEY'). - CLI dedicata.
aura secrets list,seteunsetprendono--function <name>.listnon mostra mai i valori in testo semplice. - Riutilizzato dalla piattaforma. Lo stesso servizio di crittografia protegge anche, lato server, i segreti MFA, i token OAuth e le stringhe di connessione (db_url_encrypted, anon_key_encrypted).
Tre modi di scrivere, un modo di leggere#
// Una volta scritto (CLI o REST), il segreto viene iniettato come variabile
// ambiente del lavoratore che svolge la funzione.
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
La CLI (aura secrets) e l'endpoint REST dedicato (/env) manipolano gli stessi dati, i segreti di una funzione, ma non necessariamente attraverso lo stesso percorso di scrittura. Vedere il punto di attenzione di seguito.
La crittografia dipende dal percorso di scrittura utilizzato#
aura-functions espone due modi per modificare le variabili di ambiente di una funzione: l'endpoint dedicato PUT /v1/functions/:projectId/:nom/env (che crittografa sistematicamente tramite EncryptionService prima della scrittura) e l'endpoint generico PATCH /v1/functions/:projectId/:nom utilizzato per aggiornare un'intera funzione (codice, runtime, env_vars incluso) senza passare attraverso questa crittografia.
Le variabili di ambiente configurate tramite /env vengono crittografate quando sono inattive tramite AES-256-GCM prima di essere archiviate. Sia nello sviluppo locale che nella produzione gestita, questa crittografia viene eseguita in modo trasparente per lo sviluppatore.
Per andare oltre#
- Edge Functions
Runtime, invocazione, autorizzazioni: dove risiedono le tue funzioni e i relativi segreti.
- Cron
Attivare una funzione (e quindi i suoi segreti) in base a una pianificazione.
- Sicurezza e RBAC
Ruoli, policy RLS, controllo: il resto del modello di sicurezza Aurabase.
- API REST
Superficie HTTP non elaborata, autenticazione con chiave di servizio.