Kasa
Hassas Aurabase verileri için alan düzeyinde şifreleme. Kayıttan türetilmiş anahtara (HKDF-SHA256) sahip AES-256-GCM veya üretimdeki HashiCorp Vault geçiş arka ucu — aynı ilkel, Edge Functions sırlarınızı ve dahili platform sırlarınızı korur.
Ayrı bir ürün değil, bir şifreleme hizmeti#
“Vault”, ağ geçidindeki ayrı bir HTTP hizmeti değildir: hassas verilerinizi veritabanına yazmadan önce otomatik olarak koruyan, alan düzeyinde bir şifreleme motorudur - MFA sırları, OAuth sağlayıcı belirteçleri, proje bağlantı dizeleri ve Edge Functions sırlarınız.
Bir geliştirici olarak gerçekte manipüle ettiğiniz şey, işlev başına sırlardır: CLI veya REST API aracılığıyla tanımlanan ve işlevinizi yürüten çalışana ortam değişkenleri olarak enjekte edilen anahtar/değer çiftleri.
"Vault" adı aynı zamanda üretimde bu hizmetin isteğe bağlı arka ucu (kök şifreleme anahtarının yönetimi, rotasyon, sınırlı bir kullanım ömrüne sahip Postgres kimlik bilgilerinin yönetimi) olarak devreye alınan HashiCorp Vault altyapı ürününü de ifade eder. İki anlam bir arada var olur: burada belgelenen ilkel uygulama ve onu destekleyebilecek altyapı aracı.
İki arka uç, bir okuma formatı#
Yazma sırasında hizmet bir arka uç seçer: Vault transit yapılandırılmışsa (tercih edilir — kök şifreleme anahtarı hiçbir zaman Vault'tan ayrılmaz), aksi takdirde HKDF-SHA256 aracılığıyla kayıt yoluyla türetilen bir anahtarla bir yedek AES-256-GCM yerel. Okunduğunda şifreli metnin formatı, onu hangi arka ucun ürettiğini gösterir; birinden diğerine geçiş yapmak için zorunlu geçiş gerekmez.
vault:v1:AbCdEf... # arka uç geçişi — Vault aracılığıyla şifresi çözüldü (KEK hiçbir zaman açığa çıkmadı)
{"key_id":"v1", # yerel AES-256-GCM arka ucu (geri dönüş/geliştirme)
"nonce":"…","data":"…"}
sk_live_51J2x... # şifrelenmemiş geçmiş değer (şifrelemenin etkinleştirilmesinden önce)
Türetme bağlamı (işlevler tarafı) project_id:function_name'dir - iki işlev için iki kez şifrelenen aynı sır, iki farklı şifreli metin üretir ve işlevi kaldırmak/yeniden adlandırmak, eski şifreli metni yapı nedeniyle okunamaz hale getirir.
Hizmetin sağladığı şeyler#
- AES-256-GCM. HKDF-SHA256 aracılığıyla kayıt yoluyla türetilen 32 baytlık anahtar (bağlam = proje_id:işlev_adı). Yazma başına 96 bit tek seferlik.
- Arka Uç Kasası geçişi. Üretimde KEK, Vault'tan asla ayrılmaz: aktarım/şifreleme|şifre çözme, sürümlendirilmiş şifreli metin kasasına devredilen şifreleme/şifre çözme:vN:....
- Eski formatları okuma. Şifre çözme, depolanan formatı algılar (kasa: → aktarım, {...} → yerel AES, düz metin → şifrelenmemiş geçmiş): zorunlu yeniden yazmaya gerek kalmadan arka uç yük devretme.
- İşleve göre kapsam. Burada belgelenen uygulama gizli dizilerinin kapsamı, Deno çalışanına
Deno.env.get('KEY')aracılığıyla enjekte edilen bir işleve (proje_id + ad) göre belirlenir. - Özel CLI.
aura secrets list,setveunset--function <name>değerini alır.listhiçbir zaman değerleri düz metin olarak göstermez. - Platform tarafından yeniden kullanıldı. Aynı şifreleme hizmeti aynı zamanda sunucu tarafında MFA sırlarını, OAuth belirteçlerini ve bağlantı dizelerini (db_url_encrypted, anon_key_encrypted) korur.
Yazmanın üç yolu, okumanın tek yolu#
// Yazıldıktan sonra (CLI veya REST), sır değişken olarak enjekte edilir
// işlevi yürüten çalışanın ortamı.
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
CLI (aura secrets) ve tahsis edilmiş REST uç noktası (/env) aynı verileri (bir fonksiyonun sırlarını) işler, ancak aynı yazma yolu üzerinden olması gerekmez. Aşağıdaki dikkat noktasına bakın.
Şifreleme, alınan yazma yoluna bağlıdır#
aura-functions, bir fonksiyonun ortam değişkenlerini değiştirmenin iki yolunu ortaya çıkarır: adanmış PUT /v1/functions/:projectId/:nom/env uç noktası (yazmadan önce EncryptionService aracılığıyla sistematik olarak şifreler) ve bu şifrelemeden geçmeden bir fonksiyonun tamamını (kod, çalışma zamanı, env_vars dahil) güncellemek için kullanılan genel PATCH /v1/functions/:projectId/:nom uç noktası.
/env aracılığıyla yapılandırılan ortam değişkenleri, depolanmadan önce AES-256-GCM aracılığıyla beklemedeyken şifrelenir. Yönetilen üretimin yanı sıra yerel geliştirmede de bu şifreleme geliştirici için şeffaf bir şekilde gerçekleştirilir.
Daha ileri gitmek için#
- Edge Functions
Çalışma zamanları, çağrı, izinler — işlevlerinizin ve sırlarının yaşadığı yer.
- Cron
Bir zamanlamaya göre bir işlevi (ve dolayısıyla onun sırlarını) tetikleyin.
- Güvenlik ve RBAC
Roller, RLS politikaları, denetim — Aurabase güvenlik modelinin geri kalanı.
- REST API'si
Ham HTTP yüzeyi, hizmet anahtarı kimlik doğrulaması.