密码学与证书 / 系统课时
申请包含两个域名的证书
申请包含两个域名的证书
本节用一次 Certbot 请求为两个域名签发同一张 SAN 证书,并同时用 Certbot 管理信息和 OpenSSL 检查最终域名列表。这样可以在进入 Nginx HTTPS 配置前确认两个主机名确实都包含在证书中。
学习目标
- 使用多个
-d参数申请包含两个域名的证书 - 理解同一 Webroot 如何服务两个域名的 HTTP-01 验证
- 从 Certbot 与证书 SAN 扩展中核对最终域名集合
先确认两个域名都能完成 HTTP-01
两个域名必须分别解析到能够提供 Challenge 文件的服务器,并且 http://<HOST>/.well-known/acme-challenge/<TOKEN> 能通过 80 端口访问。Webroot 插件会在指定目录下创建验证文件;任一域名无法被 CA 访问,整次包含两个名称的申请都会失败。([Certbot文档][1])
本例使用 /var/www/letsencrypt 作为两个域名共同的 Webroot。如果两个域名实际使用不同的 Webroot,Certbot 也允许重复指定 -w,后续 -d 会关联到它前面的 Webroot。([Certbot文档][1])
一次提交两个域名
Certbot 命令行支持重复使用 -d 指定多个域名;--cert-name 用于给 Certbot 管理的证书设置名称,它本身不会改变证书中的域名内容。([Certbot文档][3])
把两个 <HOST_*> 替换为真实域名。CERT_NAME 建议使用一个明确且未被其他证书占用的名称;如果该名称已经存在,Certbot 会把它作为现有证书对象处理。
DOMAIN1="<HOST_1>"
DOMAIN2="<HOST_2>"
WEBROOT="/var/www/letsencrypt"
CERT_NAME="nginx-site-san"
sudo certbot certonly \
--webroot \
--webroot-path "$WEBROOT" \
--cert-name "$CERT_NAME" \
-d "$DOMAIN1" \
-d "$DOMAIN2"
sudo certbot certificates --cert-name "$CERT_NAME"
sudo openssl x509 \
-in "/etc/letsencrypt/live/$CERT_NAME/fullchain.pem" \
-noout -ext subjectAltName预期结果
Certbot 申请成功,命令退出状态为 0。
Certificate Name: nginx-site-san
Domains: 同时包含 <HOST_1> 和 <HOST_2>
Subject Alternative Name: 同时包含 DNS:<HOST_1> 和 DNS:<HOST_2>首次使用该 Certbot 安装时,终端可能要求完成 ACME 账户注册或服务条款确认;这属于账户初始化,不改变本例的 Webroot 和两个 -d 参数关系。成功后,certbot certificates 会列出 Certbot 管理的证书名、域名、到期时间和证书路径。([Certbot文档][3])
为什么还要检查 SAN
浏览器进行主机名校验时,需要目标域名出现在证书的 Subject Alternative Name 中。仅看到 Certbot 命令执行结束还不够,最后一条 OpenSSL 命令直接读取已保存的证书,能够确认 <HOST_1> 与 <HOST_2> 都进入了实际证书。
如果 Certbot 管理列表里只有一个域名,先确认命令是否真的传入了两个 -d;如果签发阶段失败,则分别测试两个域名的 Challenge URL。不要反复盲目提交真实申请,先修复 DNS、Webroot 或 80 端口问题,再重新签发。