إدارة الأسرار
تخزين آمن لبيانات الاعتماد
عندما يحتاج تطبيقك إلى الاتصال بخدمات خارجية - مثل إرسال رسائل البريد الإلكتروني من خلال SendGrid، أو معالجة المدفوعات باستخدام Stripe، أو استخدام OpenAI لميزات الذكاء الاصطناعي - فإنك تحتاج إلى تخزين مفاتيح API وبيانات الاعتماد بشكل آمن. يقوم نظام إدارة أسرار Kliv بالتعامل مع هذا الأمر تلقائيًا.
ما الذي يجعل الأسرار آمنة:
- التخزين المشفر في قاعدة البيانات
- لا يتم عرضها مطلقًا بالكامل بعد حفظها
- تُحقَن تلقائيًا في Edge functions عند الحاجة
- على مستوى الحساب لذا يمكنك تخزين كل مفتاح مرة واحدة فقط
- مسارات التدقيق تتبع وقت إنشاء الأسرار أو تحديثها
كيف تعمل الأسرار
عندما تخبر الذكاء الاصطناعي برغبتك في التكامل مع خدمة خارجية، فسوف يطلب منك بيانات الاعتماد اللازمة. بمجرد تقديم مفتاح API، يقوم الذكاء الاصطناعي بتخزينه بشكل آمن باسم وصفي (مثل OPENAI_API_KEY أو STRIPE_SECRET_KEY). ومن الآن فصاعدًا، يمكن لأي Edge function تحتاج إلى بيانات الاعتماد هذه الوصول إليها تلقائيًا.
العرض المقنع: بعد حفظ السر، لن ترى سوى نسخة مقنعة جزئيًا في واجهة المستخدم الإدارية. على سبيل المثال، يظهر sk-proj-abc123xyz789 بالشكل sk-p****9789. يتيح لك هذا التحقق من المفتاح دون الكشف عن القيمة الكاملة.
الحقن التلقائي: عند تشغيل إحدى Edge functions، تُحقَن الأسرار التي تشير إليها بشكل آمن لتلك التشغيلة فقط. يكتب الذكاء الاصطناعي الوظيفة لقراءتها عبر واجهة الأسرار في المنصة، وتوفّر المنصة القيمة الفعلية في وقت التشغيل — بحيث يسري مفعول أي مفتاح مُبدَّل في التشغيلة التالية للوظيفة.
إدارة الأسرار
من خلال واجهة الإدارة، يمكنك:
- عرض جميع أسرارك (مع القيم المقنعة)
- أضف أسرارًا جديدة أو قم بتحديث الأسرار الموجودة
- احذف الأسرار التي لم تعد بحاجة إليها
- معرفة متى تم إنشاء كل سر أو تحديثه آخر مرة
يمكن للذكاء الاصطناعي أيضًا إنشاء أسرار وتحديثها لك عندما تصف عمليات التكامل التي ترغب في بنائها.
الاستخدامات الشائعة للأسرار
- خدمات البريد الإلكتروني: بيانات اعتماد SendGrid أو Mailgun أو SMTP
- معالجة الدفع: Stripe أو PayPal أو مفاتيح API أخرى للدفع
- خدمات الذكاء الاصطناعي: مفاتيح OpenAI أو Anthropic أو Google API
- الرسائل القصيرة/الاتصالات: رموز مصادقة Twilio
- واجهات برمجة التطبيقات الخارجية: أي خدمة خارجية يتكامل معها تطبيقك
- Webhooks: أسرار التوقيع للتحقق من webhooks الواردة
- اتصالات قاعدة البيانات: سلاسل الاتصال لقواعد البيانات الخارجية
أفضل الممارسات
✅ استخدم أسماء وصفية - قم بتسمية الأسرار بشكل واضح مثل SENDGRID_API_KEY بدلاً من key1 أو secret.
✅ بدّلها بانتظام - حدّث الأسرار بشكل دوري، خاصة بالنسبة للخدمات الهامة.
✅ الحذف عند الانتهاء - قم بإزالة أسرار الخدمات التي لم تعد تستخدمها.
❌ لا تشارك الأسرار - يجب أن تستخدم كل بيئة (اختبار، إنتاج) مفاتيح API مختلفة.
❌ لا تُودِعها في الكود - يتم تخزين الأسرار بشكل منفصل عن الكود الخاص بك لسبب ما. لا تضع أبدًا مفاتيح API مباشرة في ملفات المصدر الخاصة بك.
الوثائق ذات الصلة: