Naar de inhoud springen
Aurabase-logo
aurabasis

Kluis

Encryptie op veldniveau voor gevoelige Aurabase-gegevens. AES-256-GCM met van records afgeleide sleutel (HKDF-SHA256) of HashiCorp Vault-transit-backend in productie: dezelfde primitief beschermt uw Edge Functions-geheimen en interne platformgeheimen.

Uitleg6 min lezenNiveau tussenproductHerzien op 15 aug 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Een encryptieservice, geen apart product#

“Vault” is geen afzonderlijke HTTP-service op de gateway: het is een versleutelingsengine op veldniveau die automatisch uw gevoelige gegevens beschermt voordat deze naar de database worden geschreven: MFA geheimen, OAuth providertokens, projectverbindingsreeksen en de geheimen van uw Edge Functions.

Wat u als ontwikkelaar feitelijk manipuleert, zijn de geheimen per functie: sleutel/waarde-paren gedefinieerd via de CLI of de REST API, geïnjecteerd als omgevingsvariabelen in de werker die uw functie uitvoert.

Info

De naam “Vault” verwijst ook naar het HashiCorp Vault-infrastructuurproduct, dat in productie wordt ingezet als een optionele backend van deze service (beheer van de root-encryptiesleutel, rotatie, Postgres-referenties met een beperkte levensduur). De twee betekenissen bestaan ​​naast elkaar: de hier gedocumenteerde applicatieprimitief, en de infrastructuurtool die dit kan ondersteunen.

Twee backends, één leesformaat#

Bij het schrijven kiest de service een backend: Vault-transit indien geconfigureerd (bij voorkeur: de root-encryptiesleutel verlaat Vault nooit), anders een fallback AES-256-GCM lokaal met een sleutel afgeleid door registratie via HKDF-SHA256. Bij het lezen geeft het formaat van de cijfertekst aan welke backend deze heeft geproduceerd; er is geen gedwongen migratie nodig om van de ene naar de andere over te schakelen.

cijfertekst formaattext
vault:v1:AbCdEf...     # backend-transit - gedecodeerd via Vault (KEK nooit zichtbaar)
{"key_id":"v1",         # lokale AES-256-GCM-backend (fallback/dev)
 "nonce":"…","data":"…"}
sk_live_51J2x...       # niet-gecodeerde historische waarde (vóór activering van de codering)
Tip

De afleidingscontext (functiezijde) is project_id:function_name — hetzelfde geheim tweemaal gecodeerd voor twee functies produceert twee verschillende cijferteksten, en het verwijderen/hernoemen van de functie maakt de oude cijfertekst onleesbaar door constructie.

Wat de dienst biedt#

  • AES-256-GCM. Sleutel van 32 bytes afgeleid door registratie via HKDF-SHA256 (context = project_id:functie_naam). 96-bits nonce per schrijfbewerking.
  • Backend Vault-doorvoer. In productie verlaat de KEK Vault nooit: encryptie/decryptie gedelegeerd aan transit/encryptie|decryptie, gecodeerde tekstkluis met versiebeheer:vN:....
  • Oudere formaten lezen. Decodering detecteert opgeslagen formaat (kluis: → transit, {...} → lokale AES, platte tekst → niet-gecodeerde geschiedenis): failover van de backend zonder geforceerd herschrijven.
  • Bereik per functie. De hier gedocumenteerde applicatiegeheimen zijn beperkt tot een functie (project_id + naam), geïnjecteerd in de Deno-werker via Deno.env.get('KEY').
  • Speciale CLI. aura secrets list, set en unset nemen --function <name>. list toont waarden nooit in platte tekst.
  • Hergebruikt door het platform. Dezelfde coderingsservice beschermt ook, aan de serverzijde, MFA geheimen, OAuth tokens en verbindingsreeksen (db_url_encrypted, anon_key_encrypted).

Drie manieren van schrijven, één manier van lezen#

functions/echo.tstypescript
// Eenmaal geschreven (CLI of REST), wordt het geheim als een variabele geïnjecteerd
// omgeving van de werknemer die de functie uitvoert.
Deno.serve(async (req) => {
  const cle = Deno.env.get('STRIPE_SECRET_KEY')
  // ...
})
Tip

De CLI (aura secrets) en het speciale REST-eindpunt (/env) manipuleren dezelfde gegevens (de geheimen van een functie), maar niet noodzakelijkerwijs via hetzelfde schrijfpad. Zie aandachtspunt hieronder.

De codering is afhankelijk van het gekozen schrijfpad#

aura-functions laat twee manieren zien om de omgevingsvariabelen van een functie te wijzigen: het speciale PUT /v1/functions/:projectId/:nom/env-eindpunt (dat systematisch codeert via EncryptionService voordat het wordt geschreven), en het generieke PATCH /v1/functions/:projectId/:nom-eindpunt dat wordt gebruikt om een volledige functie bij te werken (code, runtime, env_vars inbegrepen) zonder deze codering te doorlopen.

Omgevingsvariabelen coderen

Omgevingsvariabelen geconfigureerd via /env worden in rust gecodeerd via AES-256-GCM voordat ze worden opgeslagen. Zowel bij lokale ontwikkeling als bij beheerde productie wordt deze encryptie transparant voor de ontwikkelaar uitgevoerd.

Om verder te gaan#