قبو
تشفير على مستوى الحقل لبيانات Aurabase الحساسة. AES-256-GCM مع مفتاح مشتق من السجل (HKDF-SHA256)، أو الواجهة الخلفية لعبور HashiCorp Vault في الإنتاج - نفس المبدأ الأساسي يحمي أسرار Edge Functions وأسرار النظام الأساسي الداخلي.
خدمة تشفير، وليس منتج منفصل#
"Vault" ليس خدمة HTTP منفصلة على البوابة: إنه محرك تشفير على مستوى الحقل يحمي بياناتك الحساسة تلقائيًا قبل الكتابة إلى قاعدة البيانات - أسرار MFA، ورموز موفر OAuth، وسلاسل اتصال المشروع، وأسرار Edge Functions.
ما تتعامل معه فعليًا، كمطور، هو الأسرار لكل وظيفة: أزواج المفاتيح/القيمة المحددة عبر واجهة سطر الأوامر (CLI) أو REST API، والتي يتم حقنها كمتغيرات بيئة في العامل الذي ينفذ وظيفتك.
يشير اسم "Vault" أيضًا إلى منتج البنية التحتية HashiCorp Vault، الذي تم نشره في الإنتاج كواجهة خلفية اختيارية لهذه الخدمة (إدارة مفتاح تشفير الجذر، والتدوير، وبيانات اعتماد Postgres ذات عمر محدود). ويتعايش المعنيان: التطبيق البدائي الموثق هنا، وأداة البنية التحتية التي يمكن أن تدعمه.
واجهتان خلفيتان، وتنسيق قراءة واحد#
عند الكتابة، تختار الخدمة واجهة خلفية: عبور Vault إذا تم تكوينها (المفضل - مفتاح تشفير الجذر لا يترك Vault أبدًا)، وإلا فإن البديل AES-256-GCM محلي مع مفتاح مشتق عن طريق التسجيل عبر HKDF-SHA256. عند القراءة، يشير تنسيق النص المشفر إلى الواجهة الخلفية التي أنتجته، ولا يلزم الترحيل القسري للتبديل من واحد إلى الآخر.
vault:v1:AbCdEf... # النقل الخلفي - تم فك تشفيره عبر Vault (لم يتم الكشف عن KEK مطلقًا)
{"key_id":"v1", # الواجهة الخلفية المحلية AES-256-GCM (احتياطي/مطور)
"nonce":"…","data":"…"}
sk_live_51J2x... # القيمة التاريخية غير المشفرة (قبل تفعيل التشفير)
سياق الاشتقاق (جانب الوظائف) هو project_id:function_name - نفس السر المشفر مرتين لوظيفتين ينتج نصين مشفرين مختلفين، وإزالة/إعادة تسمية الوظيفة تجعل النص المشفر القديم غير قابل للقراءة عن طريق البناء.
ما تقدمه الخدمة#
- AES-256-GCM. مفتاح 32 بايت مشتق من التسجيل عبر HKDF-SHA256 (السياق = project_id:function_name). 96 بت نونس لكل كتابة.
- عبور الواجهة الخلفية للقبو. في مرحلة الإنتاج، لا تترك KEK مطلقًا Vault: التشفير/فك التشفير مفوض للعبور/التشفير|فك التشفير، إصدار النص المشفر vault:vN:....
- قراءة التنسيقات القديمة. يكتشف فك التشفير التنسيق المخزن (القبو: → العبور، {...} → AES المحلي، نص عادي → سجل غير مشفر): تجاوز فشل الواجهة الخلفية دون إعادة الكتابة القسرية.
- النطاق حسب الوظيفة. يتم تحديد أسرار التطبيق الموثقة هنا لوظيفة (project_id + name)، ويتم إدخالها إلى العامل Deno عبر
Deno.env.get('KEY'). - واجهة سطر الأوامر المخصصة.
aura secrets listوsetوunsetيأخذون--function <name>.listلا يعرض أبدًا القيم في نص عادي. - أعيد استخدامه بواسطة المنصة. تحمي خدمة التشفير نفسها أيضًا، على جانب الخادم، أسرار MFA ورموز OAuth وسلاسل الاتصال (db_url_encrypted وanon_key_encrypted).
ثلاث طرق للكتابة، وطريقة واحدة للقراءة#
// بمجرد كتابته (CLI أو REST)، يتم إدخال السر كمتغير
// بيئة العامل الذي ينفذ الوظيفة.
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
تتعامل واجهة سطر الأوامر (aura secrets) ونقطة نهاية REST المخصصة (/env) مع نفس البيانات - أسرار الوظيفة - ولكن ليس بالضرورة من خلال نفس مسار الكتابة. انظر نقطة الاهتمام أدناه.
يعتمد التشفير على مسار الكتابة المتخذ#
يعرض aura-functions طريقتين لتعديل متغيرات البيئة الخاصة بالوظيفة: نقطة النهاية PUT /v1/functions/:projectId/:nom/env المخصصة (التي تقوم بالتشفير بشكل منهجي عبر EncryptionService قبل الكتابة)، ونقطة النهاية PATCH /v1/functions/:projectId/:nom العامة المستخدمة لتحديث وظيفة بأكملها - التعليمات البرمجية ووقت التشغيل وenv_vars متضمنة - دون المرور بهذا التشفير.
يتم تشفير متغيرات البيئة التي تم تكوينها عبر /env في حالة عدم النشاط عبر AES-256-GCM قبل تخزينها. في التطوير المحلي وكذلك في الإنتاج المُدار، يتم تنفيذ هذا التشفير بشفافية للمطور.