تخطي إلى المحتوى
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

إلى جانب إعدادات النظام يمكنك أيضًا تهيئة المكوّن الأساسي لـ 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:DisableEmailBlacklisting تُعطّل القدرة على إدراج رسائل البريد الإلكتروني في القائمة السوداء للحملات إذا تم تعيينها إلى true.

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

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

  • NGSurvey:DistributedCacheيُفعّل ذاكرة التخزين المؤقت الموزعة إذا تم تعيينه إلى true. يجب تفعيل ذاكرة التخزين المؤقت الموزعة إذا كنت تستخدم ngSurvey على عنقود مثل التكوين

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

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

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

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

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

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

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

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

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

  • NGSurvey:CaptchaDisabled تؤدي إلى تعطيل ميزات CAPTCHA إذا تم تعيينها إلى true.

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

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

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

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

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

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

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

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

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

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

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

  • AzureAd:ClientId معرّف العميل الخاص بـ Azure key vault.

  • AzureAd:ClientSecret السرّ الخاص بالعميل للوصول إلى Azure key vault.

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

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

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

  • NGSurvey:ActivityLogAzureAuthenticationId معرّف مصادقة عامل Azure Log التحليلات

  • 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 أيام.

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

  • NGSurvey:PostgresAzureScope نطاق Azure الذي يدير رموز الوصول الخاصة بـ Entra لاستخدام Postgres مع حساب مُدار من Entra.

آخر تحديث

هل كان هذا مفيدا؟