چرا یک مرجع صدور گواهی مدرک میخواهد
یک گواهی TLS بیان میکند که یک کلید عمومی به یک دامنه تعلق دارد. پیش از آنکه یک مرجع این بیان را امضا کند، به شواهدی نیاز دارد که هر کس گواهی را میخواهد دامنه را در کنترل دارد. در ACME، پروتکلی که Let's Encrypt و مراجع دیگر استفاده میکنند، شاهد یک چالش است: مرجع یک token تصادفی به کلاینت ACME شما میدهد، کلاینت آن را جایی منتشر میکند که فقط صاحب دامنه میتوانست، و مرجع آن را جستوجو میکند.
سه نوع چالش فقط در اینکه token کجا میرود با هم فرق دارند. همین یک تفاوت تعیین میکند چه گواهیهایی میتوانید بگیرید، کلاینت شما کجا باید اجرا شود و آیا چیزی جلوی سایت شما اهمیت دارد.
مقایسهٔ 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 را بسته نگه میدارند، به کنترل خود listener مربوط به TLS نیاز دارد و آن هم نمیتواند wildcard صادر کند.
DNS-01. کلاینت یک رکورد TXT را در _acme-challenge.<domain> منتشر میکند که مقداری برگرفته از token دارد، و مرجع آن را در DNS جستوجو میکند. هیچ چیز روی وبسرور درگیر نیست. wildcardها را اعتبارسنجی میکند، برای میزبانهایی که اینترنت به آنها نمیرسد کار میکند و مهم نیست چه چیزی جلوی سایت باشد. در عوض، کلاینت به راهی برای نوشتن رکوردهای DNS نیاز دارد: یک API، یا دستهای شما.
DNS-01 گامبهگام چگونه کار میکند
1. سفارش. کلاینت ACME شما گواهیای میخواهد که مثلاً example.com و *.example.com را پوشش دهد.
2. Token. برای هر نام، مرجع یک چالش DNS-01 برمیگرداند و کلاینت مقداری را که باید منتشر شود از token و کلید حساب خود محاسبه میکند.
3. رکورد TXT. مقدار در یک رکورد TXT با نام _acme-challenge.example.com قرار میگیرد. wildcard همان نام دامنهٔ ساده را استفاده میکند، پس برای گواهی هر دو به دو مقدار TXT زیر یک نام نیاز است. این عادی است: هر دو را اضافه کنید.
4. انتشار. رکورد باید به هر name server معتبر zone برسد، چون مرجع ممکن است از هر کدام و از چند مکان بپرسد.
5. اعتبارسنجی و صدور. کلاینت از مرجع میخواهد بررسی کند؛ مرجع مقدارها را پیدا میکند، نامها را اعتبارسنجیشده علامت میزند و کلاینت گواهی را دانلود میکند. بعد میتوان رکوردهای TXT را حذف کرد.
میتوانید پیش از آنکه از مرجع بخواهید نگاه کند، ببینید او چه خواهد دید.
پیش از اعتبارسنجی رکورد TXT را بررسی کنید
# what your resolver sees
dig +short TXT _acme-challenge.example.com
# ask every authoritative name server directly
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 اعتبارسنجی میکند و دلیلش ساده است: یک فایل روی یک وبسرور کنترل یک hostname را ثابت میکند، در حالی که یک wildcard از طرف هر hostname در zone سخن میگوید، پس اثبات باید از خود zone بیاید.
پیش از مهاجرت، پشت CDN، روی میزبانهای خصوصی
چون DNS-01 هرگز به وبسرور دست نمیزند، برایش مهم نیست ترافیک کجا میرود.
پیش از یک مهاجرت. گواهی پلتفرم جدید را صادر کنید در حالی که دامنه هنوز به پلتفرم قدیمی اشاره میکند. وقتی DNS را عوض میکنید، گواهی از قبل سر جایش است و HTTPS از نخستین درخواست کار میکند.
پشت یک CDN یا پروکسی. اعتبارسنجی به اینکه کدام سرور به پورت 80 پاسخ میدهد بستگی ندارد، پس همان کلاینت چه سایت مستقیم سرو شود چه از طریق CDN کار میکند.
میزبانهای خصوصی و داخلی. یک سرور staging، یک برنامهٔ اینترانت یا یک سرور ایمیل که اینترنت به آن نمیرسد باز هم میتواند گواهیای بگیرد که عموماً مورد اعتماد است، به شرط اینکه نامش در یک zone عمومی DNS باشد که بتوانید در آن بنویسید.
سرورهای بسیار، یک نام. پشت یک load balancer، HTTP-01 باید token را روی هر سروری که پاسخ میدهد پیدا کند. DNS-01 یک بار اعتبارسنجی میشود و شما گواهی را توزیع میکنید.
certbot، acme.sh و cert-manager
certbot از DNS-01 به دو شکل پشتیبانی میکند. یک افزونهٔ DNS رکوردهای TXT را از طریق API ارائهدهندهٔ DNS شما مینویسد و حذف میکند، که تمدید بدون نظارت را هم ممکن میکند؛ افزونه برای بیشتر ارائهدهندگان بزرگ DNS و برای بهروزرسانیهای پویای RFC 2136 به name serverهای خودتان وجود دارد. حالت دستی رکورد را چاپ میکند و منتظر میماند شما آن را اضافه کنید: برای یک گواهی یکباره خوب است، اما هر تمدید به یک انسان نیاز دارد.
acme.sh از DNS-01 با بیش از صد API ارائهدهنده پشتیبانی میکند، و در Kubernetes، cert-manager همین کار را از طریق solver با نام dns01 در یک Issuer انجام میدهد. هر کدام را به کار ببرید، مشخصات API را طوری نگه دارید که فقط root بتواند بخواند و به token کمترین مجوزی را بدهید که ارائهدهندهتان دارد، ایدهآل: ویرایش DNS برای یک zone. راهنمای certbot نصب، تمدید و سمت HTTP-01 را پوشش میدهد.
certbot: یک گواهی wildcard با DNS-01
# with a DNS plugin (here: RFC 2136 dynamic updates to your own name server)
sudo certbot certonly \
--dns-rfc2136 --dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
-d example.com -d '*.example.com'
# manual: certbot prints the TXT values and waits for you
sudo certbot certonly --manual --preferred-challenges dns \
-d example.com -d '*.example.com'
# test renewal (works with a plugin; manual mode needs you again)
sudo certbot renew --dry-run
در cdn.com.tr: گواهی edge، آماده پیش از تغییر DNS
وقتی یک دامنهٔ زنده را به cdn.com.tr منتقل میکنید، پنل گواهی edge را با DNS-01 صادر میکند در حالی که دامنه هنوز به ارائهدهندهٔ فعلی شما اشاره میکند. در زبانهٔ دامنهها در دامنهها و قوانین، تنظیم گواهی را بزنید و دریافت گواهی پیش از تغییر DNS را انتخاب کنید. جادوگر دامنهٔ ریشه و wildcard آن را نام میبرد، رکورد TXT را که باید در ارائهدهندهٔ فعلی DNS خود اضافه کنید نشان میدهد، رکورد را برای شما بررسی میکند و یک گواهی wildcard از Let's Encrypt صادر میکند که بهطور خودکار روی سرورهای CDN نصب میشود.
هر وقت آماده بودید DNS را عوض کنید: دامنه از نخستین ثانیه روی HTTPS سرو میشود، بدون فاصلهای برای صدور گواهی. پنل تاریخ انقضای گواهی را نشان میدهد و اجرای دوبارهٔ جادوگر همان چند دقیقه طول میکشد. راهنمای اعتبارسنجی DNS همهٔ صفحهها را قدمبهقدم نشان میدهد.
کی DNS-01 چالش درست است
گواهی پلتفرم جدید پیش از آنکه نخستین بازدیدکننده به آنجا برسد وجود دارد.
یک گواهی wildcard برای هر نام سطح اول، از جمله نامهایی که بعداً اضافه میکنید.
گواهیهایی که عموماً مورد اعتمادند برای سرورهای staging، اینترانت و ایمیل که اینترنت به آنها نمیرسد.
نحوه راهاندازی
راهنماهای گامبهگام در مرکز راهنما:
پرسشهای پرتکرار دربارهٔ 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 از هر name server معتبر بپرسید؛ اگر یکی هنوز بدون مقدار جدید پاسخ میدهد، صبر کنید.
آیا DNS-01 پشت CDN کار میکند؟
بله. چالش را DNS شما پاسخ میدهد، نه سروری که به ترافیک وب پاسخ میدهد، پس چه CDN جلوی سایت باشد چه نباشد یکسان کار میکند.
آیا گواهی DNS-01 خودکار تمدید میشود؟
با کلاینتی که DNS شما را از طریق API مینویسد، مثل یک افزونهٔ DNS برای certbot، acme.sh یا cert-manager، بله. در حالت دستی یک نفر در هر تمدید رکورد TXT را اضافه میکند، پس برایش برنامه بریزید یا به API بروید.
آیا دادن دسترسی به DNS من به یک کلاینت ACME امن است؟
محدودش کنید. tokenای بسازید که فقط zone مورد نظر را ویرایش کند، یا _acme-challenge را با یک CNAME به zone جداگانهای که فقط برای اعتبارسنجی است اشاره دهید، تا کلاینت نتواند چیز دیگری را تغییر دهد. مشخصات را طوری نگه دارید که فقط root بتواند بخواند.