إعدادات متغيرات البيئة

بجانب النظام يمكنك أيضًا تكوين نواة ngSurvey باستخدام متغير البيئة التالي. يمكن أيضًا تعيين هذه المتغيرات إما في ملف web.config إذا كنت تستخدم IIS أو ضمن ملف ngsurvey.settings.json.

في خدمة تطبيق Azure Linux الافتراضية أو في حاوية Linux مخصصة أي : في اسم المتغير يجب استبداله بـ __ (شرطان سفليان متتاليان).

🔅 متغيرات البيئة

• NGSurvey:Secretمفتاح التشفير المستخدم لتوقيع JWT وعلامات عناصر الأمان. يجب أن يكون طوله لا يقل عن 64 حرفًا.

• NGSurvey:AutoDBSetup بشكل افتراضي سيقوم ngSurvey بتكوين قاعدة البيانات المستهدفة أو ترقيةها تلقائيًا. إذا أردت تعطيل عملية التثبيت/الترقية التلقائية يمكنك ضبط هذا المتغير إلى false. في هذه الحالة سيتعين عليك تثبيت قاعدة البيانات يدويًا باستخدام dacpac لملف Microsoft SQL Server. سيتم تثبيت MariaDB أو MySQL مباشرةً بواسطة ngSurvey فقط، نحن لا نقدم أي سكربتات أو تعليمات برمجية لتثبيت وإعداد قاعدة البيانات يدويًا بنفسك.

• NGSurvey:MailingBatchPoolingDelayهو التأخير بالدقائق الذي بعده ستتم معالجة دفعات البريد المتعلقة بالحملات مثل إرسال البريد الإلكتروني. الافتراضي هو دقيقة واحدة.

• NGSurvey:MaxMailingThread يتيح لك تحديد عدد خيوط العمل التي ستُستخدم أثناء عملية إرسال البريد الإلكتروني. احذر عند تعيين عدد الخيوط لأن كل خيط سيفتح اتصالًا إلى خادم البريد الخاص بك. الافتراضي هو 2.

• NGSurvey:EnableTenants إذا كنت تملك ترخيص Tenant يجب عليك تمكين Tenants في تثبيتك عن طريق ضبط هذا المتغير إلى true.

• NGSurvey:DisableEmailBlacklisting يعطل القدرة على إدراج عناوين البريد الإلكتروني في القائمة السوداء للحملات إذا تم تعيينه إلى true.

• NGSurvey:DisableMobilePhoneNumberBlacklisting يعطل القدرة على إدراج أرقام الهواتف المحمولة في القائمة السوداء للحملات إذا تم تعيينه إلى true.

• NGSurvey:EnableSwagger إذا تم ضبطه على false سيعطل الوصول إلى توثيق API على https://yourngsurveysite/api.

• NGSurvey:DistributedCacheيقوم بتمكين الـ distributed cache إذا تم ضبطه على true. يجب تمكين distributed cache إذا كنت تستخدم ngSurvey على cluster مثل إعداد

• NGSurvey:CacheTimeout يستخدم ngSurvey ذاكرات تخزين مؤقت داخلية لتحسين الأداء. بشكل افتراضي هذه الذاكرات لا تنتهي صلاحيتها. يمكنك ضبط مهلة بالدقائق إذا رغبت في تحديد وقت انتهاء صلاحية لهذه الذاكرات ليتم مسحها بشكل دوري.

• NGSurvey:PanelSyncronizerThreadsNumber يحدد عدد الخيوط التي ستُستخدم لمزامنة اللوحات مع مصادر بياناتها. الافتراضي هو 6. احذر لأن كل خيط قد يفتح اتصالًا جديدًا إلى مصدر البيانات الذي تتصل به اللوحة.

• NGSurvey:Languages مصفوفة من رموز اللغات التي ستكون قابلة للاختيار لقسم الإدارة. :

• NGSurvey:ClusterNode يحدد عند ضبطه إلى true أن هذه النسخة تعمل على عقدة عنقودية. النسخ التي تم ضبط ClusterNode لها على true لن تشغّل أي نوع من المهام الخلفية. يجب أن تبقي المهام الخلفية إما على نسخ منفصلة لا تخدم أي استبيانات أو على نسخة واحدة فقط.

• NGSurvey:EncryptionKey سيستخدم هذا المفتاح لتشفير جميع البيانات على مستوى قاعدة البيانات مثل سلاسل الاتصال، كلمات المرور، والإعدادات الحساسة. يجب ألا يقل طوله عن 64 حرفًا. تأكد من الاحتفاظ بنسخة احتياطية من المفتاح لأنه بدون المفتاح قد لا تتمكن من استرداد أي من بيانات ngSurvey الخاصة بك.

• NGSurvey:AccountLockoutThreshold عدد المرات التي يمكن فيها لمحاولة تسجيل الدخول المحاولة قبل أن يتم قفلها.

• NGSurvey:AccountLockoutDuration عدد الدقائق التي يظل فيها حساب تسجيل الدخول مقفلًا قبل السماح بالمحاولة مرة أخرى.

• NGSurvey:EnableHSTSيقوم بتمكين HSTS إذا كنت تستخدم SSL فسيتم تعيين جميع ملفات تعريف الارتباط كآمنة.

• NGSurvey:WebSetupDisabled تعطيل واجهة التثبيت عبر الويب لـ ngSurvey عن طريق ضبطها إلى true.

• NGSurvey:CaptchaDisabled تعطيل ميزات captcha إذا تم ضبطها إلى true.

• NGSurvey:TwoFactorDisabled يعطل المصادقة ثنائية العامل عند تسجيل الدخول إذا تم ضبطه على true. يمكن استخدامه لتجاوز المصادقة الثنائية إذا طرأت أي مشكلة.

• NGSurvey:ClearActivityLogsOlderThanDays عدد الأيام للاحتفاظ ببيانات سجل النشاط.

• NGSurvey:ClearActivityLogTresholdDays عدد الأيام قبل أن يتم حذف بيانات سجل النشاط نهائيًا.

• NGSurvey:EncryptActivityLog إذا تم ضبطه على true فسيقوم بتشفير بيانات سجل النشاط على مستوى قاعدة البيانات.

• NGSurvey:PersitentMailStorageLocation المسار إلى مجلد يمكن استخدامه لنسخ رسائل الاحتياطية التي تُحفظ في مجلد pickup الخاص بـ Exchange في حال كنت تستخدم مجلد Exchange pickup لإرسال البريد الإلكتروني.

• NGSurvey:MaxAllowedTextSize الحد الأقصى المسموح به لحجم النص بالبايت الذي يمكن تخزينه في النظام. يمكن استخدامه لمنع هجمات فيضان الذاكرة على النظام. الافتراضي هو 10485760.

• NGSurvey:MailServerTest إذا تم ضبطه على true فلن يرسل رسائل البريد الإلكتروني مباشرة عبر خادم البريد المُكوّن.

• NGSurvey:LoadTest إذا تم ضبطه على true سيسمح بنشر إجابات نفس المستجيب عدة مرات.

• NGSurvey:AdminDisabled إذا تم ضبطه على true سيعطل جميع ميزات المسؤول المتعلقة بـ API. إذا تم تعطيله ستكون متاحة فقط واجهات API المتعلقة باسترجاع الاستبيانات وتقديمات المستجيبين.

• NGSurvey:CPSPolicyإذا تم ضبطه على "Self" فسيطبق سياسة أمان المحتوى (CSP) على المتصفح. لاحظ أن عناصر الإجابة المستندة إلى الويدجت وأي ميزات JavaScript مخصصة سيتم تعطيلها إذا تم ضبطها على Self.

• KeyVault:Name اسم Key Vault في Azure إذا خططت لتخزين متغيرات البيئة في Key Vault الخاص بـ Azure.

• AzureAd:ClientId معرِّف العميل (Client Id) الخاص بـ Azure.

• AzureAd:ClientSecret السر السري للعميل للوصول إلى Key Vault الخاص بـ Azure.

• NGSurvey:RedisConnectionString سلسلة الاتصال إلى خادم التخزين المؤقت Redis.

• NGSurvey:RedisInstanceName اسم مثيل Redis اختياري

• NGSurvey:ActivityLogAzureWorkspaceId معرّف مساحة عمل Azure Log Analytics لتسجيل الأنشطة

• NGSurvey:ActivityLogAzureAuthenticationId معرّف مصادقة وكيل Azure Log Analytics

• NGSurvey:ActivityLogAwsAccessKeyId معرّف مفتاح الوصول لـ AWS CloudWatch لتسجيل الأنشطة

• NGSurvey:ActivityLogAwsSecretAccessKey المفتاح السري لـ AWS CloudWatch

• NGSurvey:ActivityLogAwsRegion منطقة AWS CloudWatch

• NGSurvey:ActivityLogAwsLogGroup مجموعة سجلات AWS CloudWatch

• NGSurvey:ActivityLogApplicationInsightsKey مفتاح Azure Application Insights لتسجيل الأنشطة

• NGSurvey:ActivityLogUseEventLog إذا تم ضبطه على true فسيسجل الأنشطة في سجل أحداث Windows.

• NGSurvey:AccountJWTAccessTokenExpiration مدة انتهاء صلاحية رمز JWT لمطور على مستوى الحساب بالدقائق. الافتراضي 90 يومًا، الحد الأقصى 6 أشهر.

• NGSurvey:FormJWTAccessTokenExpiration مدة انتهاء صلاحية رمز JWT لمطور على مستوى الاستبيان/النموذج بالدقائق. الافتراضي يومان، الحد الأقصى 7 أيام.