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.
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.
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.
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)
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,setenunsetnemen--function <name>.listtoont 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#
// 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')
// ...
})
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 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#
- Edge Functions
Runtimes, aanroep, machtigingen: waar uw functies en hun geheimen zich bevinden.
- Cron
Activeer een functie (en dus de geheimen ervan) volgens een schema.
- Beveiliging en RBAC
Rollen, RLS beleid, auditing: de rest van het Aurabase beveiligingsmodel.
- REST-API
Ruw HTTP-oppervlak, servicesleutelverificatie.