لماذا تطلب جهة الإصدار إثباتًا
تنصّ شهادة TLS على أن مفتاحًا عامًا يعود إلى نطاق. وقبل أن توقّع الجهة هذا النص، تحتاج إلى دليل على أن من يطلب الشهادة يتحكم بالنطاق. في ACME، البروتوكول الذي تستخدمه Let's Encrypt وجهات أخرى، الدليل هو التحدّي (challenge): تعطي الجهة عميل ACME لديك رمزًا عشوائيًا، فينشره العميل في مكان لا يصل إليه إلا مالك النطاق، وتبحث الجهة عنه.
تختلف أنواع التحدّي الثلاثة في مكان الرمز فقط. وهذا الفرق الواحد يحدد أي الشهادات تحصل عليها، وأين يجب أن يعمل عميلك، وهل يهم ما أمام موقعك.
مقارنة HTTP-01 وTLS-ALPN-01 وDNS-01
HTTP-01. يقدّم العميل ملفًا على http://<domain>/.well-known/acme-challenge/<token> وتجلبه الجهة عبر المنفذ 80. هو الافتراضي في معظم العملاء والأسهل بدءًا. يجب أن يشير النطاق أصلًا إلى خادم يستطيع تقديم الملف، وأن يكون المنفذ 80 مفتوحًا، ولا يمكنه إصدار شهادات wildcard.
TLS-ALPN-01. يجيب العميل عن اتصال TLS على المنفذ 443 بشهادة خاصة لبروتوكول acme-tls/1. يناسب الإعدادات التي تُبقي المنفذ 80 مغلقًا، ويحتاج إلى التحكم في مستمع TLS نفسه، ولا يستطيع إصدار شهادات wildcard أيضًا.
DNS-01. ينشر العميل سجل TXT عند _acme-challenge.<domain> يحمل قيمة مشتقة من الرمز، وتبحث عنه الجهة في DNS. لا شيء على خادم الويب يدخل في الأمر. يتحقق من wildcard، ويعمل للمضيفين الذين لا يصل إليهم الإنترنت، ويعمل مهما كان أمام الموقع. وفي المقابل يحتاج العميل إلى طريقة لكتابة سجلات DNS: واجهة API أو يداك.
كيف يعمل DNS-01 خطوة بخطوة
1. الطلب. يطلب عميل ACME شهادة تغطي، مثلًا، example.com و*.example.com.
2. الرمز. لكل اسم تعيد الجهة تحدّي DNS-01، ويحسب العميل القيمة التي سينشرها من الرمز ومن مفتاح حسابه.
3. سجل TXT. تُوضع القيمة في سجل TXT باسم _acme-challenge.example.com. يستخدم الـ wildcard الاسم نفسه الذي يستخدمه النطاق المجرد، فتحتاج شهادة تغطي الاثنين إلى قيمتي TXT تحت اسم واحد. وهذا طبيعي: أضف الاثنتين.
4. الانتشار. يجب أن يصل السجل إلى كل خادم أسماء موثوق (authoritative) للنطاق، لأن الجهة قد تسأل أيًّا منها ومن أماكن عدة.
5. التحقق والإصدار. يطلب العميل من الجهة أن تفحص؛ فتجد الجهة القيم وتعلّم الأسماء على أنها مُتحقَّق منها، وينزّل العميل الشهادة. ويمكن بعدها إزالة سجلات TXT.
تستطيع أن ترى ما ستراه الجهة قبل أن تطلب منها النظر.
افحص سجل TXT قبل التحقق
# ما يراه مُحلّل الأسماء لديك
dig +short TXT _acme-challenge.example.com
# اسأل كل خادم أسماء موثوق مباشرة
for ns in $(dig +short NS example.com); do
echo "$ns: $(dig +short TXT _acme-challenge.example.com @$ns)"
done
شهادات wildcard تحتاج DNS-01
تغطي شهادة wildcard كل اسم من المستوى الأول تحت نطاق: يطابق *.example.com الأسماء www.example.com وapi.example.com وأي نطاق فرعي تضيفه العام القادم، لكنه لا يطابق example.com نفسه ولا a.b.example.com. ولهذا تطلب أوامر wildcard عادةً example.com و*.example.com معًا.
لا تتحقق Let's Encrypt من أسماء wildcard إلا بـ DNS-01، والسبب بسيط: ملف على خادم ويب واحد يثبت التحكم باسم مضيف واحد، بينما يتكلم الـ wildcard باسم كل مضيف في المنطقة (zone)، فيجب أن يأتي الإثبات من المنطقة نفسها.
قبل الترحيل، وخلف CDN، وعلى المضيفين الخاصين
لأن DNS-01 لا يلمس خادم الويب أبدًا، فلا يهمه أين تذهب الحركة.
قبل الترحيل. أصدر الشهادة للمنصة الجديدة بينما ما زال النطاق يشير إلى القديمة. وحين تحوّل DNS تكون الشهادة موجودة فعلًا ويعمل HTTPS من أول طلب.
خلف CDN أو وسيط. لا يعتمد التحقق على أي خادم يجيب عن المنفذ 80، فيعمل العميل نفسه سواء قُدِّم الموقع مباشرة أو عبر CDN.
المضيفون الخاصون والداخليون. يستطيع خادم اختبار أو تطبيق شبكة داخلية أو خادم بريد لا يصل إليه الإنترنت أن يحصل على شهادة موثوقة علنًا، ما دام اسمه في منطقة DNS عامة تستطيع الكتابة فيها.
خوادم كثيرة، اسم واحد. خلف موازن تحميل، على HTTP-01 أن يجد الرمز على أي خادم يجيب. أما DNS-01 فيُتحقَّق منه مرة واحدة، وتوزّع أنت الشهادة.
certbot وacme.sh وcert-manager
يدعم certbot تحدّي DNS-01 بطريقتين. إضافة DNS تكتب سجلات TXT وتزيلها عبر واجهة API لمزوّد DNS لديك، وهذا يتيح أيضًا التجديد دون إشراف؛ وتوجد إضافات لمعظم مزوّدي DNS الكبار وللتحديثات الديناميكية RFC 2136 لخوادم أسمائك الخاصة. أما الوضع اليدوي فيطبع السجل وينتظر أن تضيفه: مناسب لشهادة لمرة واحدة، لكن كل تجديد يحتاج إلى شخص.
يدعم acme.sh تحدّي DNS-01 مع أكثر من مئة واجهة API لمزوّدين، وفي Kubernetes يفعل cert-manager الشيء نفسه عبر محلّ dns01 في Issuer. وأيًّا كان ما تستخدمه، اجعل بيانات اعتماد API مقروءة لـ root وحده وأعطِ الرمز أضيق صلاحية يوفرها مزوّدك، ويفضّل تعديل DNS لمنطقة واحدة. ويغطي دليل certbot التثبيت والتجديد وجانب HTTP-01.
certbot: شهادة wildcard عبر DNS-01
# مع إضافة DNS (هنا: تحديثات RFC 2136 الديناميكية لخادم أسمائك الخاص)
sudo certbot certonly \
--dns-rfc2136 --dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
-d example.com -d '*.example.com'
# يدوي: يطبع certbot قيم TXT وينتظرك
sudo certbot certonly --manual --preferred-challenges dns \
-d example.com -d '*.example.com'
# اختبار التجديد (يعمل مع الإضافة؛ والوضع اليدوي يحتاجك مجددًا)
sudo certbot renew --dry-run
على cdn.com.tr: شهادة الحافة جاهزة قبل أن تحوّل DNS
حين تنقل نطاقًا يعمل إلى cdn.com.tr، تُصدر اللوحة شهادة الحافة بـ DNS-01 بينما ما زال النطاق يشير إلى مزوّدك الحالي. في تبويب النطاقات من النطاقات والقواعد اضغط تعيين الشهادة واختر الحصول على شهادة قبل تحويل DNS. يسمّي المعالج النطاق الجذر وشهادته الـ wildcard، ويعرض سجل TXT الذي تضيفه لدى مزوّد DNS الحالي، ويفحص السجل عنك، ويُصدر شهادة Let's Encrypt wildcard تُثبَّت على خوادم CDN تلقائيًا.
حوّل DNS متى شئت: يُخدَّم النطاق عبر HTTPS من أول ثانية، دون فجوة أثناء إصدار الشهادة. وتعرض اللوحة تاريخ انتهاء الشهادة، وتشغيل المعالج مجددًا يستغرق الدقائق القليلة نفسها. ويمرّ دليل التحقق عبر DNS على كل شاشة.
متى يكون DNS-01 التحدّي الصحيح
تكون شهادة المنصة الجديدة موجودة قبل أن يصل إليها أول زائر.
شهادة wildcard واحدة لكل اسم من المستوى الأول، بما فيها ما تضيفه لاحقًا.
شهادات موثوقة علنًا لخوادم الاختبار والشبكة الداخلية والبريد التي لا يصل إليها الإنترنت.
كيفية الإعداد
أدلة خطوة بخطوة في مركز المساعدة:
الأسئلة الشائعة حول DNS-01
ما الفرق بين HTTP-01 وDNS-01؟
يثبت HTTP-01 التحكم بملف يُقدَّم على المنفذ 80 للنطاق؛ ويثبته DNS-01 بسجل TXT في DNS النطاق. يحتاج HTTP-01 إلى أن يشير النطاق إلى الخادم الذي يطلب الشهادة؛ أما DNS-01 فيعمل أينما يشير النطاق وهو التحدّي الذي يُصدر شهادات wildcard.
لماذا يوجد سجلا TXT بالاسم نفسه؟
تحتاج شهادة لـ example.com و*.example.com إلى تحقق واحد لكل اسم، وكلاهما يستخدم _acme-challenge.example.com. أضف القيمتين كسجلي TXT منفصلين واحتفظ بهما حتى ينتهي التحقق.
كم يستغرق الانتشار؟
عادةً بضع دقائق، بحسب مزوّد DNS لديك وTTL السجل. اسأل كل خادم أسماء موثوق بـ dig قبل بدء التحقق؛ وإن كان أحدها ما زال يجيب دون القيمة الجديدة فانتظر.
هل يعمل DNS-01 خلف CDN؟
نعم. يجيب DNS لديك عن التحدّي لا الخادم الذي يجيب عن حركة الويب، فيعمل بالطريقة نفسها مع وجود CDN أمام الموقع أو دونه.
هل تتجدد شهادة DNS-01 تلقائيًا؟
مع عميل يكتب في DNS لديك عبر واجهة API، مثل إضافة DNS في certbot أو acme.sh أو cert-manager، نعم. في الوضع اليدوي يضيف شخص سجل TXT عند كل تجديد، فخطّط لذلك أو انتقل إلى واجهة API.
هل من الآمن أن أمنح عميل ACME وصولًا إلى DNS لديّ؟
قيّده. أنشئ رمزًا يستطيع تعديل المنطقة المعنية وحدها، أو وجّه _acme-challenge بـ CNAME إلى منطقة منفصلة تُستخدم للتحقق فقط، فلا يستطيع العميل تغيير أي شيء آخر. وأبقِ بيانات الاعتماد مقروءة لـ root وحده.