إعداد الأسماء وTLS
يستجيب خادم Excubius لاسم أساسي ولأي عدد من الأسماء المستعارة، ويقدّم HTTPS في أحد ستة أوضاع، بدءًا من شهادة Let's Encrypt وحتى بوابة تُنهي TLS في الواجهة الأمامية. تحدد إجابات برنامج التثبيت القيم الأولى. وبعد ذلك تغيّرها في وحدة التحكم، ويُطبَّق التغيير خلال دقيقة دون إعادة تشغيل. يوضح هذا الدليل كيفية اختيارها وتغييرها.
قبل البدء
- لتغيير الأسماء وTLS في وحدة التحكم، تحتاج إلى دور Super admin.
- للعمل من الخادم بدلًا من ذلك، تحتاج إلى وصول SSH و
sudoحتى تتمكن من العمل بصفة حساب الخدمة (excubiusافتراضيًا). - أنشئ سجلات DNS أولًا. يجب أن يشير كل اسم إلى الخادم، أو إلى البوابة التي أمامه، من الأماكن التي سيستخدم الناس Excubius منها.
الأنواع الثلاثة للأسماء
| الاسم | ما هو |
|---|---|
| Primary name (الاسم الأساسي) | اسم المضيف في العنوان العام، مثل monitoring.ciguapa.example. وتستخدمه الروابط التي يرسلها Excubius في رسائل Slack وقضايا Jira. ويتم تسجيل الدخول عليه دائمًا: فمن يفتح اسمًا مستعارًا يُحوَّل إلى الاسم الأساسي لتسجيل الدخول |
| Aliases (الأسماء المستعارة) | أسماء أخرى يمكن للناس فتحها، مثل monitoring.areito.example في نطاق تتحكم فيه عندما تكون منطقة DNS الخاصة بالعميل بعيدة عن متناولك. ويستجيب الخادم لها جميعًا |
| Names in the certificate (الأسماء في الشهادة) | الأسماء التي تُطلب الشهادة لها. جميع الأسماء افتراضيًا، وتنضم الأسماء المستعارة الجديدة تلقائيًا. ألغِ تحديد اسم لا تستطيع الشهادة تغطيته، مثل اسم لا تتحكم في DNS الخاص به |
يضم الخادم 100 اسم على الأكثر في المجموع.
تبدأ عناوين إعادة التوجيه المسجلة لتسجيل الدخول عبر Microsoft Entra ID وGoogle بالاسم الأساسي. وعندما تغيّر الاسم الأساسي، حدّثها أولًا؛ راجع إعداد موفري تسجيل الدخول.
اختيار الوضع
| الوضع في وحدة التحكم | إجابة برنامج التثبيت | متى تستخدمه |
|---|---|---|
| Let's Encrypt over HTTP | letsencrypt | جميع الأسماء في الشهادة موجودة في DNS العام وتشير إلى هذا الخادم، ويمكن الوصول إلى المنفذ 80 من الإنترنت، مباشرةً أو عبر إعادة توجيه من NAT أو بوابة |
| Let's Encrypt over DNS | letsencrypt-dns | لديك بيانات اعتماد API لمنطقة DNS الخاصة بالأسماء. ولا يلزم أن يكون الخادم متاحًا من الإنترنت، لذلك فهذا هو الخيار المعتاد لخادم يُوصَل إليه عبر VPN |
| Self-signed | selfsigned | في أي مكان. تعرض المتصفحات تحذيرًا إلى أن يضع الناس ثقتهم في الشهادة على حواسيبهم وهواتفهم |
| Your own certificate | custom | تُصدر مؤسستك الشهادات. تلصق السلسلة والمفتاح، وتستبدلهما قبل انتهاء صلاحيتهما |
| Gateway in front | gateway | يُنهي موازن حمل أو وكيل عكسي، مثل Azure Application Gateway أو Front Door، اتصال TLS ويمرر HTTP عادي. ويُراعى رأس X-Forwarded-Proto الخاص به |
| Plain HTTP | later | تجربة أولى، أو شبكة تثق بها تمامًا. لا شيء مشفّر |
تغيير الأسماء أو الوضع في وحدة التحكم
- افتح Settings وحدد Server and certificates. ويمكنك أيضًا الوصول إليها من Settings › Instance عبر Server names and HTTPS.
- ضمن Names، تحقق من Primary name. لإضافة اسم مستعار، أدخله وحدد Add؛ ولإزالة اسم، حدد Remove بجواره.
- ضمن HTTPS، اختر الوضع واملأ ما يطلبه. تصف الأقسام التالية كل وضع.
- ضمن Names in the certificate، ألغِ تحديد أي اسم لا تستطيع الشهادة تغطيته.
- حدد Apply. تعرض الصفحة الرسالة Saved. The certificate service is applying it.
ضمن Current certificate ترى ما يجري تقديمه: الجهة المُصدِرة، والأسماء، وValid until، وLast attempt مع نتيجتها، وNext check. وإذا فشلت محاولة، يشرح What went wrong السبب.
يُتحقق من كل تغيير قبل حفظه، ويُكتب في سجل التدقيق.
Let's Encrypt عبر HTTP
أدخل E-mail for the Let's Encrypt account. قبل أن تطبّق التغيير، تأكد من أن كل اسم في الشهادة يشير علنًا إلى الخادم، ومن أن المنفذ 80 مفتوح من الإنترنت. ويُرفض الاسم الذي لا يمكن أن يكون عامًا، مثل عنوان IP أو اسم ينتهي بـ .local أو .internal أو .corp: ألغِ تحديده، أو استخدم شهادة موقّعة ذاتيًا.
Let's Encrypt عبر DNS
-
أدخل E-mail for the Let's Encrypt account.
-
اختر DNS provider لمنطقة الأسماء. وإذا لم يكن الموفر في القائمة، فاختر Other (acme.sh dnsapi id) وأدخل معرّف
dnsapiالخاص به في acme.sh. -
ضمن API credentials، أدخل القيم التي يقرؤها الموفر. تسردها وحدة التحكم لكل موفر:
الموفر معرّف dnsapiالمتغيرات Cloudflare dns_cfCF_Token,CF_Account_IDDreamHost dns_dreamhostDH_API_KEYAzure DNS dns_azureAZUREDNS_SUBSCRIPTIONID,AZUREDNS_TENANTID,AZUREDNS_APPID,AZUREDNS_CLIENTSECRETAmazon Route 53 dns_awsAWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEYGoDaddy dns_gdGD_Key,GD_SecretDigitalOcean dns_dgonDO_API_KEYGandi dns_gandi_livednsGANDI_LIVEDNS_TOKENHetzner dns_hetznercloudHETZNER_TOKENIONOS dns_ionosIONOS_PREFIX,IONOS_SECRETLinode (Akamai) dns_linode_v4LINODE_V4_API_KEYNamecheap dns_namecheapNAMECHEAP_USERNAME,NAMECHEAP_API_KEY,NAMECHEAP_SOURCEIPOVHcloud dns_ovhOVH_END_POINT,OVH_AK,OVH_AS,OVH_CKPorkbun dns_porkbunPORKBUN_API_KEY,PORKBUN_SECRET_API_KEY -
يمكنك اختياريًا ضبط Let's Encrypt server على Staging للتجربة دون المساس بحدود المعدل في Let's Encrypt. لا تثق المتصفحات بشهادات Staging؛ فعُد إلى Production عندما ينجح الأمر.
قيم بيانات الاعتماد للكتابة فقط: تُخزَّن مشفّرة ولا تُعرض مرة أخرى. وللاحتفاظ بقيمة مخزنة عند تعديل الإعدادات، اترك حقلها فارغًا.
موقّعة ذاتيًا
لا شيء لإدخاله. الشهادة صالحة لمدة 825 يومًا وتُجدَّد بالطريقة نفسها كغيرها. ولإيقاف تحذيرات المتصفح، حدد Download the certificate وثبّتها كشهادة موثوقة على الحواسيب والهواتف التي تستخدم الخادم.
شهادتك الخاصة
الصق Certificate chain بتنسيق PEM مع شهادة الخادم أولًا، وPrivate key بتنسيق PEM دون عبارة مرور. يجب أن يكون المفتاح من نوع RSA بطول 2048 بت أو أكثر، أو ECDSA. وترفض وحدة التحكم الشهادة المنتهية الصلاحية، أو التي لا تغطي أسماء الخادم، أو التي لا يطابقها مفتاحها. استبدل الاثنين قبل انتهاء صلاحية الشهادة؛ فـ Excubius لا يجددها نيابةً عنك.
بوابة في الواجهة الأمامية
لا شيء لإدخاله. اضبط البوابة لتمرير HTTP عادي إلى المنفذ 80 على الخادم ولإرسال الرأس X-Forwarded-Proto.
التجديد
التجديد تلقائي لشهادات Let's Encrypt والشهادات الموقّعة ذاتيًا. تفحص خدمة الشهادات الشهادة الفعالة كل يوم وتجددها عندما يتبقى 30 يومًا أو أقل. ولا يوجد مؤقت تحتاج إلى إعداده على الخادم.
- لا تزيل المحاولة الفاشلة ما يعمل. تستمر الشهادة السابقة، أو HTTP عادي، في الخدمة؛ ويظهر الخطأ في الصفحة مع وقت إعادة المحاولة التالية، بعد 15 دقيقة ثم يتضاعف الفاصل حتى يوم واحد.
- تُجرَّب أي تغييرات في الإعدادات فورًا.
- يطلب Renew now شهادة جديدة فورًا.
- ينتقل Use self-signed now إلى شهادة موقّعة ذاتيًا، وهي الطريقة السريعة للحصول على HTTPS ريثما يتعذر عمل Let's Encrypt.
تُعلَّم ملفات تعريف ارتباط الجلسة بالسمة Secure كلما وصل طلب عبر HTTPS، لذلك لا يتطلب تغيير الوضع إعادة تشغيل. اترك COOKIE_SECURE فارغًا في ملف الإعدادات؛ فهو لا يفعل سوى فرض السلوك في اتجاه واحد أو آخر.
يرد العنوانان /healthz و/heartbeat عبر HTTP عادي في كل وضع، لذلك يواصل المراقب الخارجي عمله أثناء تغيير TLS.
تغيير TLS من الخادم
عندما تكون وحدة التحكم بعيدة عن المتناول، مثلًا لأن الشهادة معطوبة ويرفض المتصفح الصفحة، غيّر الإعدادات نفسها من الخادم. يمر البرنامج النصي عبر عمليات التحقق نفسها وسجل التدقيق نفسه الذي تمر به وحدة التحكم.
-
اتصل عبر SSH وتحوّل إلى حساب الخدمة:
sudo -iu excubius -
اعرض الإعدادات والشهادة الحالية:
/opt/excubius/current/scripts/enable-tls.sh --status -
غيّر ما تحتاج إليه. مثلًا، للتحويل إلى شهادة موقّعة ذاتيًا:
/opt/excubius/current/scripts/enable-tls.sh --mode selfsignedأو استخدم Let's Encrypt عبر DNS مع Cloudflare، باسمين وشهادة للاسم الثاني فقط. تُقرأ بيانات الاعتماد على هيئة أسطر
KEY=VALUEمن الإدخال القياسي:/opt/excubius/current/scripts/enable-tls.sh --mode letsencrypt-dns \--email ops@areito.example --dns-provider dns_cf \--names "monitoring.ciguapa.example monitoring.areito.example" \--cert-names monitoring.areito.example < credentials.txt -
للتجديد فورًا، شغّل
enable-tls.sh --renew.
استبدل /opt/excubius إذا اخترت دليل تثبيت آخر. شغّل enable-tls.sh --help لعرض كل الخيارات، بما فيها --staging و--production. ولا يمكن رفع شهادتك الخاصة إلا من وحدة التحكم.
تغيير الإجابات باستخدام برنامج التثبيت
يطرح sudo ./install.sh --reconfigure كل سؤال من جديد. وتُطبَّق إجابات TLS التي تقدمها حينئذٍ على المنصة العاملة، كما لو غيّرتها في وحدة التحكم.