密码学与证书 / 系统课时

申请包含两个域名的证书

申请包含两个域名的证书

本节用一次 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 会把它作为现有证书对象处理。

bash
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

预期结果

text
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 端口问题,再重新签发。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

申请包含两个域名的证书

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通