Tresor
Verschlüsselung auf Feldebene für vertrauliche Aurabase-Daten. AES-256-GCM mit datensatzabgeleitetem Schlüssel (HKDF-SHA256) oder HashiCorp Vault-Transit-Backend in der Produktion – das gleiche Grundelement schützt Ihre Edge Functions-Geheimnisse und internen Plattformgeheimnisse.
Ein Verschlüsselungsdienst, kein separates Produkt#
„Vault“ ist kein separater HTTP-Dienst auf dem Gateway: Es handelt sich um eine Verschlüsselungs-Engine auf Feldebene, die Ihre sensiblen Daten automatisch schützt, bevor sie in die Datenbank schreiben – MFA-Geheimnisse, OAuth-Provider-Tokens, Projektverbindungszeichenfolgen und die Geheimnisse Ihres Edge Functions.
Was Sie als Entwickler tatsächlich manipulieren, sind die Geheimnisse pro Funktion: Schlüssel/Wert-Paare, die über die CLI oder die REST-API definiert und als Umgebungsvariablen in den Worker eingefügt werden, der Ihre Funktion ausführt.
Der Name „Vault“ bezieht sich auch auf das Infrastrukturprodukt HashiCorp Vault, das in der Produktion als optionales Backend dieses Dienstes eingesetzt wird (Verwaltung des Root-Verschlüsselungsschlüssels, Rotation, Postgres Anmeldeinformationen mit begrenzter Lebensdauer). Die beiden Bedeutungen existieren nebeneinander: das hier dokumentierte Anwendungsprimitiv und das Infrastrukturtool, das es unterstützen kann.
Zwei Backends, ein Leseformat#
Beim Schreiben wählt der Dienst ein Backend aus: Vault-Transit, falls konfiguriert (bevorzugt – der Root-Verschlüsselungsschlüssel verlässt Vault nie), andernfalls ein Fallback AES-256-GCM lokal mit einem durch Registrierung über HKDF-SHA256 abgeleiteten Schlüssel. Beim Lesen gibt das Format des Chiffretextes an, welches Backend ihn erstellt hat – es ist keine erzwungene Migration erforderlich, um von einem zum anderen zu wechseln.
vault:v1:AbCdEf... # Backend-Transit – über Vault entschlüsselt (KEK wird nie offengelegt)
{"key_id":"v1", # lokales AES-256-GCM-Backend (Fallback/Entwicklung)
"nonce":"…","data":"…"}
sk_live_51J2x... # unverschlüsselter historischer Wert (vor Verschlüsselungsaktivierung)
Der Ableitungskontext (Funktionsseite) ist project_id:function_name – das gleiche Geheimnis, das zweimal für zwei Funktionen verschlüsselt wurde, erzeugt zwei verschiedene Chiffretexte, und das Entfernen/Umbenennen der Funktion macht den alten Chiffretext konstruktionsbedingt unlesbar.
Was der Dienst bietet#
- AES-256-GCM. 32-Byte-Schlüssel, abgeleitet durch Registrierung über HKDF-SHA256 (Kontext = Projekt-ID: Funktionsname). 96-Bit-Nonce pro Schreibvorgang.
- Backend-Vault-Transit. In der Produktion verlässt der KEK niemals Vault: Verschlüsselung/Entschlüsselung wird an transit/encrypt|decrypt delegiert, versionierter Chiffretext vault:vN:....
- Ältere Formate lesen. Entschlüsselung erkennt gespeichertes Format (Tresor: → Transit, {...} → lokales AES, Klartext → unverschlüsselter Verlauf): Backend-Failover ohne erzwungenes Umschreiben.
- Geltungsbereich nach Funktion. Die hier dokumentierten Anwendungsgeheimnisse beziehen sich auf eine Funktion (Projekt-ID + Name), die über
Deno.env.get('KEY')in den Worker Deno eingefügt wird. - Dedizierte CLI.
aura secrets list,setundunsetnehmen--function <name>.listzeigt Werte niemals im Klartext an. - Wird von der Plattform wiederverwendet. Derselbe Verschlüsselungsdienst schützt auf der Serverseite auch MFA-Geheimnisse, OAuth-Tokens und Verbindungszeichenfolgen (db_url_encrypted, anon_key_encrypted).
Drei Arten zu schreiben, eine Art zu lesen#
// Nach dem Schreiben (CLI oder REST) wird das Geheimnis als Variable eingefügt
// Umgebung des Arbeiters, der die Funktion ausführt.
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
Die CLI (aura secrets) und der dedizierte REST-Endpunkt (/env) manipulieren dieselben Daten – die Geheimnisse einer Funktion –, jedoch nicht unbedingt über denselben Schreibpfad. Siehe Aufmerksamkeitspunkt unten.
Die Verschlüsselung hängt vom verwendeten Schreibpfad ab#
aura-functions bietet zwei Möglichkeiten zum Ändern der Umgebungsvariablen einer Funktion: den dedizierten PUT /v1/functions/:projectId/:nom/env-Endpunkt (der vor dem Schreiben systematisch über EncryptionService verschlüsselt) und den generischen PATCH /v1/functions/:projectId/:nom-Endpunkt, der zum Aktualisieren einer gesamten Funktion – Code, Laufzeit, env_vars einschließlich – verwendet wird, ohne diese Verschlüsselung zu durchlaufen.
Über /env konfigurierte Umgebungsvariablen werden im Ruhezustand über AES-256-GCM verschlüsselt, bevor sie gespeichert werden. Sowohl in der lokalen Entwicklung als auch in der verwalteten Produktion erfolgt diese Verschlüsselung transparent für den Entwickler.
Um weiter zu gehen#
- Edge Functions
Laufzeiten, Aufrufe, Berechtigungen – wo Ihre Funktionen und ihre Geheimnisse leben.
- Cron
Lösen Sie eine Funktion (und damit ihre Geheimnisse) nach einem Zeitplan aus.
- Sicherheit und RBAC
Rollen, RLS-Richtlinien, Überwachung – der Rest des Aurabase-Sicherheitsmodells.
- REST-API
Rohe HTTP-Oberfläche, Dienstschlüsselauthentifizierung.