تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.
pkg: "@nocobase/plugin-environment-variables"
المتغيرات والمفاتيح السرية
This feature is provided by the plugin «المتغيرات والأسرار»مقدمة
تتيح لك هذه الميزة إمكانية إعداد وإدارة المتغيرات البيئية والمفاتيح السرية بشكل مركزي، وذلك لأغراض تخزين البيانات الحساسة، وإعادة استخدام بيانات الإعدادات، وعزل إعدادات البيئات المختلفة.
الاختلافات عن ملفات .env
| الميزة | ملف .env | المتغيرات والمفاتيح السرية المُعدّة ديناميكيًا |
|---|---|---|
| موقع التخزين | تُخزّن في ملف .env في الدليل الجذر للمشروع | تُخزّن في جدول environmentVariables بقاعدة البيانات |
| طريقة التحميل | تُحمّل إلى process.env باستخدام أدوات مثل dotenv عند بدء تشغيل التطبيق | تُقرأ ديناميكيًا وتُحمّل إلى app.environment عند بدء تشغيل التطبيق |
| طريقة التعديل | تتطلب التعديل المباشر للملف، ويجب إعادة تشغيل التطبيق لتطبيق التغييرات | تدعم التعديل أثناء التشغيل، وتُطبّق التغييرات فورًا بعد إعادة تحميل إعدادات التطبيق |
| عزل البيئات | تتطلب كل بيئة (تطوير، اختبار، إنتاج) صيانة منفصلة لملفات .env | تتطلب كل بيئة (تطوير، اختبار، إنتاج) صيانة منفصلة للبيانات في جدول environmentVariables |
| سيناريوهات الاستخدام | مناسبة للإعدادات الثابتة، مثل معلومات قاعدة البيانات الرئيسية للتطبيق | مناسبة للإعدادات الديناميكية التي تتطلب تعديلات متكررة أو ترتبط بمنطق الأعمال، مثل قواعد البيانات الخارجية، ومعلومات تخزين الملفات، وما إلى ذلك. |
التثبيت
إضافة مدمجة، لا تتطلب تثبيتًا منفصلاً.
الاستخدام
إعادة استخدام بيانات الإعدادات
على سبيل المثال، إذا كانت هناك حاجة لعقد بريد إلكتروني في عدة أماكن ضمن سير العمل، وتتطلب جميعها إعداد SMTP، فيمكن تخزين إعداد SMTP العام في المتغيرات البيئية.
تخزين البيانات الحساسة
تخزين معلومات إعدادات قواعد البيانات الخارجية المختلفة، ومفاتيح تخزين الملفات السحابية، وغيرها من البيانات الحساسة.
عزل إعدادات البيئات
في بيئات مختلفة مثل التطوير والاختبار والإنتاج، تُستخدم استراتيجيات إدارة إعدادات مستقلة لضمان عدم تداخل إعدادات وبيانات كل بيئة. تمتلك كل بيئة إعداداتها ومتغيراتها ومواردها المستقلة، مما يجنب التعارضات بين بيئات التطوير والاختبار والإنتاج، ويضمن في الوقت نفسه أن النظام يعمل كما هو متوقع في كل بيئة.
على سبيل المثال، قد تختلف إعدادات خدمات تخزين الملفات بين بيئات التطوير والإنتاج، كما هو موضح أدناه:
بيئة التطوير
بيئة الإنتاج
إدارة المتغيرات البيئية
إضافة المتغيرات البيئية
- تدعم الإضافة الفردية والجماعية
- تدعم التخزين بنص عادي ومشفر
إضافة فردية
إضافة جماعية
ملاحظات هامة
إعادة تشغيل التطبيق
بعد تعديل أو حذف المتغيرات البيئية، ستظهر رسالة في الأعلى تطلب إعادة تشغيل التطبيق. لن تُطبّق التغييرات على المتغيرات البيئية إلا بعد إعادة تشغيل التطبيق.
التخزين المشفر
تستخدم البيانات المشفرة للمتغيرات البيئية تشفير AES المتماثل. يُخزّن المفتاح الخاص (PRIVATE KEY) للتشفير وفك التشفير في مجلد التخزين. يُرجى الاحتفاظ به بأمان؛ ففي حال فقدانه أو الكتابة فوقه، لن تتمكن من فك تشفير البيانات المشفرة.
الإضافات المدعومة حاليًا للمتغيرات البيئية
الإجراء: طلب مخصص
المصادقة: CAS
المصادقة: DingTalk
المصادقة: LDAP
المصادقة: OIDC
المصادقة: SAML
المصادقة: WeCom
مصدر البيانات: MariaDB خارجي
مصدر البيانات: MySQL خارجي
مصدر البيانات: Oracle خارجي
مصدر البيانات: PostgreSQL خارجي
مصدر البيانات: SQL Server خارجي
مصدر البيانات: KingbaseES
مصدر البيانات: REST API
تخزين الملفات: محلي
تخزين الملفات: Aliyun OSS
تخزين الملفات: Amazon S3
تخزين الملفات: Tencent COS
تخزين الملفات: S3 Pro
غير متوفرة حاليًا
الخرائط: AMap
الخرائط: Google
إعدادات البريد الإلكتروني
غير متوفرة حاليًا
الإشعارات: البريد الإلكتروني
النماذج العامة
إعدادات النظام
التحقق: رسائل Aliyun القصيرة
التحقق: رسائل Tencent القصيرة
سير العمل
