CAA 记录配置实战:RFC 8659 原理、dig 验证与 7 个排错步骤
CAA 记录配置的核心是:在域名权威 DNS 添加 `0 issue "letsencrypt.org"` 这类记录,声明允许哪些 CA 签发证书;不配置等于默认允许所有 CA,配置错误则会让 Let's Encrypt 等 CA 拒绝签发。 最小可用配置为 3 条:`0 issue "letsencrypt.org"`、`0 issuewild "letsencrypt.org"`、`0 iodef "mailto:security@example.com"`,TTL 建议 300-3600 秒。 验证命令:`dig CAA example.com +short @1.1.1.1` 应返回与权威 DNS 一致的记录;用 `certbot certonly --dry-run`(Certbot 2.11.0)做 staging 签发测试。 报错 `CAA record for example.com prevents issuance` 多数是值写成 `https://letsencrypt.org` 或只配了父域;按 RFC 8659 检查 issue/issuewild 与子域继承关系。
CAA 记录是什么?为什么没配或配错会让证书签发失败
CAA(Certification Authority Authorization,证书颁发机构授权)是 RFC 8659(2019 年 11 月发布,取代 2014 年的 RFC 6844)定义的 DNS 资源记录,IANA 类型号为 257。它的作用只有一个:让域名持有人通过 DNS 白名单声明”哪些 CA 可以为我签发证书”。据 RFC 8659 第 3 节,CA 在签发前必须从目标域名开始逐级向上查询 CAA 集合;一旦查到 issue 或 issuewild 属性,而其中没有列出自己的标识,CA 必须拒绝签发。也就是说,caa记录配置 不是”锦上添花的安全加固”,而是能直接卡死签发流程的硬约束。
一条标准记录由 flag、tag、value 三段组成,写成 zone 文件里就是:
; $ORIGIN example.com. TTL 默认 300,可按权威 DNS 的最小 TTL 策略调整
example.com. 300 IN CAA 0 issue "letsencrypt.org" ; 允许 Let's Encrypt 签普通证书
example.com. 300 IN CAA 0 issuewild "letsencrypt.org" ; 通配符必须单独授权
example.com. 300 IN CAA 0 iodef "mailto:security@example.com" ; 违规签发举报地址
用 dig 直接看权威应答,这是验证 caa记录配置 是否生效最快的方式:
$ dig +short CAA example.com
0 issue "letsencrypt.org"
0 issuewild "letsencrypt.org"
0 iodef "mailto:security@example.com"
# 逐级向上排查父域是否有更严格的隐藏限制(RFC 8659 §3 的树爬行为)
$ for d in shop.example.com example.com com; do printf '== %s ==n' "$d"; dig +short CAA "$d"; done
| 字段 / tag | 取值范围与默认值 | 含义与踩坑点 |
|---|---|---|
| flag | 0 或 128(bit 0 = issuer critical) | 目前仅定义 bit 0;置 128 表示 CA 若无法识别该 tag 必须拒绝签发,一般填 0 |
| issue | 域名或 ;(空值) |
普通证书白名单;写 0 issue ";" 表示禁止任何 CA 签发 |
| issuewild | 同上 | 只约束通配符证书;缺省时回退到 issue 的集合 |
| iodef | mailto: / http(s) URL | 仅用于接收违规签发报告,不影响签发判定 |
最常见的三类失败场景,几乎都源于对”向上继承”和”issuewild 独立授权”的误解:① 早期只写了 issue "digicert.com",后来改用 Let’s Encrypt 续期,Boulder 直接返回 CAA record for example.com prevents issuance;② 父域 example.com 配了严格白名单,子域 shop.example.com 没有自己的 CAA,于是继承父域规则,CA 白名单不匹配时一样被拒;③ 通配符证书 *.example.com 只配了 issue 漏配 issuewild,导致通配符订单失败。据 Let’s Encrypt 文档,CAA 检查发生在 ACME 订单 finalize 之前,失败会阻止证书下发,但不影响已签发证书——CAA 只约束新签发与续期,不会触发吊销,旧证书可继续使用至 notAfter。
CAA 查询本身依赖 DNS 可用性,这一点常被忽略。权威 DNS 超时、DNSSEC 签名过期或 NS 配置错误都会让查询返回 SERVFAIL,而 CA 不会”查不到就放行”:Let’s Encrypt 的典型报错是 DNS problem: SERVFAIL looking up CAA for example.com - the domain's nameservers may be malfunctioning。排错时先用 dig CAA example.com +norec @ns1.example.com 直连权威服务器确认记录存在,再用 dig +dnssec 检查 RRSIG 有效期,就能把”CAA 配错”和”DNS 坏了”两类问题区分开——这与 SPF、DKIM 等其它 DNS 承载的安全策略一样,最终可信度取决于 DNS 基础设施本身。
配置 CAA 记录的完整实操步骤(从盘点域名到 staging 测试)
问:CAA 记录配错最常见的原因是什么?答:只写了主 CA、忘了 issuewild,或者 TTL 太长导致改错后无法快速回滚。下面 7 步可直接照抄,一次 caa记录配置 全程通常不超过 15 分钟。
- 盘点域名与 CA。先列出主域、常用子域(www、api、cdn)与通配符。据 RFC 8659 第 3 节,CA 从目标 FQDN 逐级向上查找,遇到第一个含 CAA 的 RRset 即停止,因此子域未配就继承父域策略。
# 逐级查询,@ 指定公共解析器,绕开本地递归缓存 dig +short CAA example.com @8.8.8.8 dig +short CAA www.example.com @1.1.1.1 # 需要看 TTL 时保留完整输出,TTL 在第二列 dig CAA example.com @8.8.8.8无输出即表示尚未配置,此时任何公共 CA 都可以签发。
- 确定允许名单。生产环境至少写两条
issue:主 CA 与备用 CA。BIND/通用 zone 文件写法:; 主 CA + 备用 CA,缺一条换 CA 时就会被阻断 example.com. 3600 IN CAA 0 issue "letsencrypt.org" example.com. 3600 IN CAA 0 issue "digicert.com" ; 首列 0 是 flags;128 表示 critical,未知标签会让整条 RRset 被 CA 判为不可用,非必要保持 0只写一家时,Let’s Encrypt Boulder 会返回
CAA record for example.com prevents issuance,签发直接失败。 - 单独处理通配符。
; 允许 Let's Encrypt 签发 *.example.com example.com. 3600 IN CAA 0 issuewild "letsencrypt.org" ; 明确禁止任何 CA 签通配符:分号是 RFC 8659 定义的空值 example.com. 3600 IN CAA 0 issuewild ";"不写
issuewild时,CA 会回退到issue标签判定,等于默认放行,所以”留空”和”禁止”是两回事。 - 加 iodef 报告地址。
example.com. 3600 IN CAA 0 iodef "mailto:security@example.com"RFC 8659 将其定义为可选,部分 CA 会在违规签发时发送邮件;据 Let’s Encrypt 文档,它不保证推送,不能替代证书透明度(CT)监控。
- 设置 TTL。按阶段选择,别一步到位写死一天:
阶段 建议 TTL 改错后最长等待 理由 首次上线 / 迁移 CA 300 秒 5 分钟 试错成本最低 稳定运行 3600 秒 1 小时 查询量与回滚速度的平衡点 图省事写 86400 86400 秒 24 小时 写错一条 issue就锁死签发一整天 - 发布并等待传播。在权威 DNS 保存后,多解析器交叉验证,等待旧 TTL 过期(通常 5–60 分钟):
for r in 1.1.1.1 8.8.8.8 223.5.5.5; do echo "== $r =="; dig +short CAA example.com @$r done三处结果一致才算收敛,只看本地递归缓存会误判。
- 做 staging 测试。先打测试目录,避免消耗生产速率限制:
# Certbot 2.11.0+,--dry-run 走 Let's Encrypt staging certbot certonly --dry-run -d example.com -d "*.example.com" # acme.sh 3.0.8+,--staging 指向 staging 目录 acme.sh --issue --staging -d example.com -d "*.example.com" --dns dns_cfdry-run 通过说明 CAA 允许名单、
issuewild与 DNS 传播都没问题,再切生产正式签发。以上命令在 Certbot 1.x 与 acme.sh 2.x 上参数语义一致,可直接复用。
配置/命令示例:BIND、Cloudflare、Route 53 与 DNSPod 怎么写
不同 DNS 服务商把 CAA 记录保存成同一种数据(RFC 8659 §4.1 定义的 flags tag value 三元组),区别只在于控制台或配置文件里的录入形式。因此,无论用哪家服务,先确认 flags 的取值:0 表示非关键(CA 遇到不认识的 tag 可以忽略),128 表示关键(CA 必须拒绝签发)。大多数场景写 0 即可。
BIND 9.18 的 zone 文件要写哪三行? 直接在 /etc/bind/db.example.com 里追加(BIND 从 9.16 起原生支持 CAA 类型,无需额外插件):
; /etc/bind/db.example.com —— 适用于 BIND 9.16 / 9.18 / 9.20
$TTL 300 ; 默认 TTL 300 秒,行内显式 TTL 优先级更高
example.com. 300 IN CAA 0 issue "letsencrypt.org" ; 授权 Let's Encrypt 签发普通证书
example.com. 300 IN CAA 0 issuewild "letsencrypt.org" ; 单独授权通配符证书
example.com. 300 IN CAA 0 iodef "mailto:security@example.com" ; 违规签发上报地址
保存后先做语法校验再重载,两步都不能省(named-checkzone 不通过时 rndc reload 会静默保留旧区数据):
# 1) 校验区文件语法与 serial
named-checkzone example.com /etc/bind/db.example.com
# 期望输出:zone example.com/IN: loaded serial 2024051501
# 2) 只重载这一个 zone,避免影响其他域
rndc reload example.com
# 期望输出:zone reload up-to-date 或 server reload successful
改完记得递增 SOA 里的 serial,否则从服务器不会触发 AXFR/IXFR 同步。
四大服务商录入方式对比(TTL 一列给出的是可填最小值,据各家公开文档):
| 服务商 | 录入路径 | 值填写形式 | TTL | 注意事项 |
|---|---|---|---|---|
| BIND 9.18 | zone 文件文本 | 0 issue "letsencrypt.org"(引号必写) |
≥ 0,常设 300 | 改后必须 named-checkzone + rndc reload |
| Cloudflare | DNS → Records → Add record,Type 选 CAA | Flags 0、Tag issue、CA domain name 填 letsencrypt.org(不加引号) |
Auto 或 300 s | 橙色云代理不影响 CAA,因为 CAA 由权威 DNS 直接应答,不经过反代 |
| AWS Route 53 | 控制台或 change-resource-record-sets |
0 issue "letsencrypt.org"(JSON 里需转义 ") |
≥ 0 | 同一 Name+Type 的多条值放在同一 ResourceRecordSet 里 |
| DNSPod / 阿里云 | 记录类型选 CAA,主机记录 @ |
0 issue "letsencrypt.org" |
600 s(默认) | 老套餐控制台无 CAA 类型时用 API,或把 NS 切到支持 CAA 的服务商 |
Route 53 用 CLI 一次写三条,先落盘 caa.json(UPSERT 可重复执行,幂等):
{
"Comment": "CAA for example.com",
"Changes": [{
"Action": "UPSERT",
"ResourceRecordSet": {
"Name": "example.com",
"Type": "CAA",
"TTL": 300,
"ResourceRecords": [
{ "Value": "0 issue "letsencrypt.org"" },
{ "Value": "0 issuewild "letsencrypt.org"" },
{ "Value": "0 iodef "mailto:security@example.com"" }
]
}
}]
}
aws route53 change-resource-record-sets
--hosted-zone-id Z123456
--change-batch file://caa.json
# 返回 ChangeInfo.Status = PENDING,通常 60 秒内变 INSYNC
怎么验证写对了? 用 dig(BIND 9.18.24 实测)查权威应答:
dig CAA example.com +short
# 0 issue "letsencrypt.org"
# 0 issuewild "letsencrypt.org"
# 0 iodef "mailto:security@example.com"
dig CAA example.com
# ;; ANSWER SECTION:
# example.com. 300 IN CAA 0 issue "letsencrypt.org"
# example.com. 300 IN CAA 0 issuewild "letsencrypt.org"
如果 +short 为空,先用 dig NS example.com 找到权威服务器,再 dig @ns1.example.com CAA example.com +norecurse 绕开缓存判断是“没写进去”还是“TTL 未过期”。据 Let’s Encrypt 文档,CAA 检查发生在每次签发前,最长会缓存 8 小时,所以排错时不要只看本地递归解析器的结果。
issue、issuewild、iodef 与 flag 怎么选:参数对比表
问:issue、issuewild、iodef 这三个 tag 到底该配哪几个,flag 写 0 还是 128?先给结论——除非你确实需要强制 CA 理解一条自定义策略,flag 一律写 0。据 RFC 8659 第 4.1 节,flag 只有两个合法取值:0 表示普通记录,128 表示 critical;CA 遇到 critical 且自己不认识的 tag 时,必须拒绝签发。这意味着你在生产域名上随手写一条 128 issue “…”,等于把签发权押在”所有 CA 都认识这条记录”上,任何不兼容的实现都会直接阻断。
| 方案 | 记录示例 | 适用场景 | 风险 |
|---|---|---|---|
| 仅 issue 单 CA | 0 issue “letsencrypt.org” | 个人站、单一 CA | 换 CA 忘记更新会阻断签发 |
| issue 双 CA | 0 issue “letsencrypt.org” + 0 issue “digicert.com” | 生产站、需要备用 CA | 任一 CA 都可签发,需评估信任面 |
| issue + issuewild | 再加 0 issuewild “letsencrypt.org” | 有通配符证书 | 显式写了 issuewild 却漏掉目标 CA,通配符签发即被阻断 |
| 禁止通配符 | 0 issuewild “;” | 不允许 *.example.com | 业务确实需要通配符时会被硬性阻断 |
| flag 128 critical | 128 issue “letsencrypt.org” | 强制 CA 理解自定义策略 | 未知 tag 会被 CA 拒绝 |
| iodef | 0 iodef “mailto:security@example.com” | 接收违规报告 | 并非所有 CA 都发送 |
关于”漏配 issuewild 会导致通配符失败”这个流传很广的说法,需要按 RFC 8659 第 4.3 节纠正:如果域名下不存在任何 issuewild 记录,issue 记录同时授权通配符与非通配符签发;真正失败的是两种情况——显式写了 issuewild 但没包含目标 CA,或者写了 issuewild “;” 主动禁止。所以通配符站点更稳妥的做法是 issue 与 issuewild 各写一条相同内容,行为可预期、排错时也少一层推断。
标准 tag 只有 issue、issuewild、iodef 三个(RFC 8659 第 4 节),大小写不敏感但建议统一小写;写成 issues、issue-wild 这类拼写,多数校验工具会直接抛 Invalid property tag 并忽略整条记录,等于你的 caa记录配置 静默失效。一条可直接落地的组合如下:
; example.com 区域文件片段
; 主 CA + 备用 CA,flag 均为 0(非 critical)
example.com. 3600 IN CAA 0 issue "letsencrypt.org"
example.com. 3600 IN CAA 0 issue "digicert.com"
; 通配符授权,内容与 issue 保持一致,避免歧义
example.com. 3600 IN CAA 0 issuewild "letsencrypt.org"
; 违规签发报告地址,仅收报告,不参与授权判断
example.com. 3600 IN CAA 0 iodef "mailto:security@example.com"
; 只允许指定 ACME 账户签发,进一步收紧权限
example.com. 3600 IN CAA 0 issue "letsencrypt.org; accounturi=https://acme-v02.api.letsencrypt.org/acme/acct/123456"
value 字段只写 CA 的授权域名,不要带 https://、路径或邮箱地址;邮箱只出现在 iodef 的 mailto: 里。追加参数用分号分隔,Let’s Encrypt 官方文档明确支持 accounturi 与 validationmethods 两个参数,前者把签发权限锁定到单个 ACME 账户,是防止同 CA 下其他账户滥签的实用手段。改完务必验证:
# 直连公共 DNS,绕开本地缓存,确认记录已生效
dig +short CAA example.com @1.1.1.1
# 期望输出(注意引号是 dig 显示格式,不是记录内容的一部分):
# 0 issue "letsencrypt.org"
# 0 issue "digicert.com"
# 0 issuewild "letsencrypt.org"
# 0 iodef "mailto:security@example.com"
# 通配符证书场景:CA 会向父域 example.com 查询 CAA,而非 *.example.com
dig +short CAA example.com @8.8.8.8
TTL 建议 300–3600 秒:300 秒适合迁移期和回滚期,错误配置最多影响 5 分钟;3600 秒适合稳定生产;86400 秒会让一次手误在整整一天里持续生效。另外提醒一点,列多个 CA 只放开签发权限,不改变证书类型——Let’s Encrypt 仍是免费 90 天 DV 证书,DigiCert、Sectigo 的商业 DV 单域通常每年 100–500 元,OV/EV 更高,别指望靠多加一条 issue 记录换来更高保障等级。如果配置写错,ACME 客户端会返回形如 urn:ietf:params:acme:error:caa :: CAA record for example.com prevents issuance 的错误,这时按”先 dig 确认记录、再核对 tag 拼写与 value 域名、最后检查 issuewild 覆盖”的顺序排查即可。
常见报错与排查:CAA record prevents issuance 怎么处理
先看报错原文长什么样,再对症下药。Let’s Encrypt 返回的 ACME 错误体里,CAA 相关的失败通常是三种前缀之一,含义完全不同,别一上来就去改 DNS。
情况一:urn:ietf:params:acme:error:caa: Error finalizing order :: CAA record for example.com prevents issuance
这句话的准确含义是”你有 CAA 记录,但里面没有列出当前 CA”。反过来,完全没有 CAA 记录时任何 CA 都被允许,这是 RFC 8659 第 4 节明确规定的默认放行语义,所以”删记录”确实能签发,但那等于对所有 CA 开放,不建议。正确做法是补一条 issue:
# 查询:先确认权威返回的到底是什么(-t CAA 与简写等价)
dig +short CAA example.com @8.8.8.8
# 修复:在 DNS 服务商处添加以下记录(注意值是纯域名,不带协议与斜杠)
example.com. 300 IN CAA 0 issue "letsencrypt.org"
# 需要签发通配符证书时再加一条,issuewild 缺省会回退到 issue
example.com. 300 IN CAA 0 issuewild "letsencrypt.org"
# 可选:接收 CA 的违规通知邮箱
example.com. 300 IN CAA 0 iodef "mailto:ops@example.com"
情况二:CAA record for www.example.com prevents issuance
注意报错里的主机名是 www。按 RFC 8659 第 3 节的”树攀爬”算法,CA 会从 www.example.com 逐级向上查,直到找到第一条 CAA 为止;www 自己没记录就会继承 example.com 的限制。所以要么在 www 单独放行,要么在父域放行——后者更省事。
情况三:DNS problem: SERVFAIL looking up CAA for example.com
这是解析层故障,不是策略问题。用下面三条命令分层定位:
dig +trace CAA example.com # 看是哪一级 NS 不响应/无响应
dig +dnssec CAA example.com @8.8.8.8 # 看是否返回 RRSIG,签名过期会 SERVFAIL
dig +short NS example.com # 核对 NS 是否指向已下线的旧 DNS 服务商
# 直接问权威服务器,绕过递归缓存(把 ns1 换成你的实际 NS)
dig +norecurse CAA example.com @ns1.example.com
重点检查三处:权威 DNS 的 53 端口(UDP/TCP 都要通,TC 标志置位后走 TCP)、NS 记录是否还有效、RRSIG 的有效期。据 Let’s Encrypt 文档说明,其验证节点对 CAA 查询的容忍度有限,权威侧超时几次就会整体判为 SERVFAIL。
情况四:CAA record is invalid: Invalid property tag
tag 拼错了。RFC 8659 只注册了三个属性,其余一律非法:
| 写法 | dig 中的表现 | 结果 |
|---|---|---|
0 issue "letsencrypt.org" |
正常返回 | ✅ 标准 |
0 issues "letsencrypt.org" |
tag 无法识别 | ❌ Invalid property tag |
0 issue-wild "..." |
应为 issuewild |
❌ Invalid property tag |
0 issue "https://letsencrypt.org" |
值含协议头 | ❌ 视为不匹配,仍 prevents issuance |
0 issue "letsencrypt.org/" |
值带尾斜杠 | ❌ 不匹配 |
0 issue " letsencrypt.org" |
前导空格被转义 | ❌ 不匹配 |
情况五:记录里明明有 Let’s Encrypt,仍报 prevents issuance
九成是 value 格式问题:正确值只能是裸域名 letsencrypt.org,不带 https://、不带路径、不带空格。用 dig +short CAA example.com 看引号内是否被 DNS 面板自动转义或截断。
情况六:刚改完仍然失败
递归解析器还在缓存旧记录。同时对比三个视角,确认是否已生效:
dig +short CAA example.com @8.8.8.8
dig +short CAA example.com @1.1.1.1
dig +norecurse CAA example.com @ns1.example.com # 权威侧应已是最新值
如果权威已更新而公共解析器仍旧值,就把 TTL 临时降到 300 秒等待收敛,验证通过后再回滚到常规值(常见 3600)。这也是为什么建议在首次做 caa记录配置 时就采用短 TTL,改错时代价最小。
如何验证 CAA 配置已经生效(dig、在线工具与签发测试)
配置完 CAA 记录不等于生效——递归解析器缓存、分线路解析、甚至只改了一条而漏了 issuewild,都会让”看起来对”的记录在签发时被拒绝。下面这套验证流程按”递归侧 → 权威侧 → 多解析器 → 在线工具 → 真实签发”逐层收窄,任何一步失败都能定位到具体环节。
第一步:递归侧先看结果。据 RFC 8659 第 4 节,issue、issuewild、iodef 是三个独立属性,一个典型的双证书(单域名 + 泛域名)配置应返回 3 条记录:
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
# 期望 3 条记录,顺序无关;+short 只输出 RDATA
$ dig CAA example.com +short
0 issue "letsencrypt.org"
0 issuewild "letsencrypt.org"
0 iodef "mailto:security@example.com"
第二步:绕开缓存,直查权威服务器。递归结果可能来自 TTL 内的旧缓存,必须回到权威 NS 确认:
# 先找出权威 NS
$ dig NS example.com +short
ns1.example.com.
ns2.example.com.
# +norecurse 禁止递归,aa 标志表示这是权威应答(Authoritative Answer)
$ dig CAA example.com @ns1.example.com +norecurse
;; flags: qr aa rd; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
如果 flags 里没有 aa,说明你查到的不是权威服务器,结论无效。
第三步:多解析器横向对比。据 Let’s Encrypt 文档,签发时的 CAA 查询来自其自建的多地递归解析器,所以不同线路的解析结果必须一致:
for r in 8.8.8.8 1.1.1.1 223.5.5.5 9.9.9.9; do
echo "== $r"; dig +short CAA example.com @$r
done
输出不一致时优先怀疑两件事:一是旧记录 TTL 未过期(先用 dig CAA example.com +noall +answer 看剩余 TTL,把 TTL 从 3600 临时降到 300 再改);二是分线路/GeoDNS 只改了默认线路。另外 RFC 8659 第 3 节规定 CAA 查找需沿 CNAME 链回溯,若 example.com 被 CNAME 到别的 zone,要确认目标 zone 上的 CAA 也是对的。
第四步:在线工具交叉验证。
| 工具 | 入口 | 看什么 | 局限 |
|---|---|---|---|
| Google Admin Toolbox Dig | toolbox.googleapps.com/apps/dig | 类型选 CAA,可切换 8.8.8.8 / 4.4.4.4 | 只反映 Google 递归视图 |
| DNSViz | dnsviz.net | DNSSEC 链是否完整、CAA 是否被正确签名 | 无 DNSSEC 时信息量有限 |
| Let’s Debug | letsdebug.net | 模拟 Let’s Encrypt 的 CAA 检查路径与报错 | 预检查,不等于真实签发 |
第五步:用真实 CA 的预检接口验证。这是唯一能证明”CA 会接受这条 CAA”的方式。Certbot 2.11.0 的 --dry-run 走 staging 环境,不消耗生产速率限制:
# --dry-run 内部使用 staging ACME 端点,输出以 The dry run was successful. 结尾
$ certbot certonly --dry-run -d example.com -d "*.example.com"
The dry run was successful.
# acme.sh 3.0.8 等价写法:--staging 走 Let's Encrypt staging
$ acme.sh --issue --staging -d example.com -d "*.example.com" --dns dns_cf
常见误区:不要把 TLS 握手当成 CAA 验证。
# 这条命令只检查证书链、SNI 和有效期,与 CAA 完全无关
$ openssl s_client -connect example.com:443 -servername example.com
CAA 只在签发时被查询,已签发的证书不会因为 CAA 变更而失效;反过来,CAA 配错了也不会让现有证书报错,只会在下次续期时突然失败(典型报错:CAA record for example.com prevents issuance)。所以 caa记录配置 的验收必须包含一次 dry-run,而不能只看握手成功。
第六步:把验证变成监控。CAA 和证书到期是两类独立风险,监控要分开:
# 每日基线比对:哈希与上次不同即告警(可放进 cron)
$ dig +short CAA example.com | sort | sha256sum
9f2c... -
# 证书到期单独监控(两者互不替代)
$ certbot certificates | grep -E "Certificate Name|Expiry Date"
$ openssl x509 -enddate -noout -in /etc/letsencrypt/live/example.com/cert.pem
notAfter=Feb 11 08:12:00 2026 GMT
基线哈希建议在每次合规的 caa记录配置 变更后手动更新一次,避免把合法变更误报成事故。
延伸:CAA 与 DNSSEC、CT 日志、证书监控怎么配合
CAA 和 DNSSEC 是什么关系?为什么上线前要先看 ad 标志?
CAA 记录本身就是一条普通 DNS 记录,攻击者若能伪造它,白名单就形同虚设。DNSSEC(RFC 4033–4035)通过 RRSIG/DS 链为包括 CAA 在内的记录提供来源认证。据 RFC 8659 §4.1,CA 在查询 CAA 时如果解析器返回 DNSSEC 验证失败(SERVFAIL),必须视为”无法确定”并拒绝签发——这正是很多”明明配了 CAA 却签不下来”的根因。注意 dig +dnssec 只是请求 DO 位,ad 标志是否出现取决于递归解析器是否真的验签,所以要用公共解析器验证:
# 1) 看 CAA 记录本身,并确认解析器已验签(flags 行出现 ad)
dig +dnssec CAA example.com @1.1.1.1
# 期望:example.com. 300 IN CAA 0 issue "letsencrypt.org"
# flags: qr rd ra ad; <-- 有 ad 才算 DNSSEC 生效
# 2) 区分"DNSSEC 验证失败"还是"上游故障":加 +cd 关闭验签
dig +cd CAA example.com @8.8.8.8
# 若 +cd 能拿到记录、普通查询却返回 status: SERVFAIL,
# 说明 DS 与 DNSKEY 不匹配或 RRSIG 过期,必须先修 DNSSEC 再谈 CAA
# 3) 确认 DS 记录已上传到父区(没有 DS 就没有信任链)
dig +short DS example.com
典型故障输出长这样,看到它就该去查 DS 摘要是否与子区 KSK 一致:
;; ->>HEADER<<- opcode: QUERY, status: SERVFAIL, id: 51234
;; flags: qr rd ra; QUERY: 1, ANSWER: 0, AUTHORITY: 0, ADDITIONAL: 1
CAA 配好了,CT 日志是不是就不用管了?
不是,两者管的是不同阶段。据 RFC 6962,CT 要求 CA 把每张证书提交到公开日志并附带 SCT,浏览器(Chrome 自 2018 年起)校验 SCT 缺失即不信任;CAA 则是在签发之前拦截。CT 只能让你”事后发现”误签发,无法阻止它发生;反过来,公开 CT 日志也不能绕过 CAA——CA 不会因为证书会公开就无视 CAA。实操上可用 crt.sh 做旁路审计:
# 列出该域名在 CT 日志中出现过的所有证书主体名(发现未授权签发)
curl -s "https://crt.sh/?q=example.com&output=json"
| jq -r '.[].name_value' | sort -u
CAA 能防证书过期吗?为什么还要单独做到期监控?
不能。CAA 只约束签发者身份,对已签发证书的有效期毫无影响。Let’s Encrypt 证书有效期 90 天,官方建议在剩余 30 天内续期;Certbot 的 renew 默认 --days 30(配置项 renew_before_expiry = 30 days),只在剩余期不足 30 天时才会真正续签,因此定期跑 --dry-run 验证续期链路是必要的:
# 演练续期(不会消耗速率限制),确认 CAA/DNSSEC 改动没有破坏自动续期
certbot renew --dry-run
# 查看当前证书到期时间
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -enddate
CAA、DNSSEC、CT、到期监控该怎么分工?
| 机制 | 解决的问题 | 标准 | 由谁执行 | 失效时的表现 |
|---|---|---|---|---|
| CAA | 哪些 CA 有权签发 | RFC 8659 | CA 签发前查询 | 报错 urn:ietf:params:acme:error:caa,拒签 |
| DNSSEC | CAA 等记录是否被篡改 | RFC 4033–4035 | 递归解析器验签 | 查询 SERVFAIL,CA 放弃签发 |
| CT | 已签发证书是否公开可审计 | RFC 6962 | CA 提交,浏览器校验 | 缺 SCT 不被 Chrome 信任 |
| 到期监控 | 证书是否仍有效 | — | 运维侧 | 站点直接 TLS 握手失败 |
域名托管在 Cloudflare、或只是 CNAME 接入 CDN,CAA 该配在哪?
判断标准只有一个:谁是你的权威 DNS。如果 NS 已托管到 Cloudflare 等平台,就在该平台的 DNS 面板做 caa记录配置,不要再在旧服务商那里改。如果只是把 www 以 CNAME 指向 CDN,那么 CDN 侧返回的 CNAME 目标并不承载你的 CAA——CA 会沿 CNAME 链回溯到源域名的权威 DNS 取 CAA。稳妥做法是源域名与 CDN 自定义域名配成一致的策略,例如两边都写 0 issue "letsencrypt.org" 加 0 iodef "mailto:security@example.com",避免 CDN 侧换证时被源域名的旧 CAA 卡住。
CAA 的 iodef 能像 DMARC 的 rua 那样依赖吗?
可以类比但别当保险。CAA 是”签发白名单”,SPF 是”发件 IP 白名单”,DMARC 是”策略加报告”;CAA 的 iodef 对应 DMARC 的 rua,但 RFC 8659 只把它定义为”可选的通知地址”,并未强制 CA 发送,实际报告投递率很低。真正发现违规签发的主力仍是 CT 日志监控与证书透明度告警,iodef 只能算补充。
不是强制。按 RFC 8659,如果域名及其父域都没有 CAA 记录,CA 可以正常签发;不配置等于默认允许所有 CA。配置后只允许 issue/issuewild 中列出的 CA,能降低误签发风险。
先看实际返回:`dig CAA example.com @8.8.8.8 +short`。常见原因是值写成 `https://letsencrypt.org`、带路径或空格,或查询的是 `www` 子域而父域有更严格的 CAA;按 RFC 8659 修正为纯域名并等待 TTL 过期。
issue 控制普通证书,issuewild 控制 `*.example.com` 通配符证书。只配 issue 不配 issuewild 时,通配符签发可能被拒绝;要明确禁止通配符可写 `0 issuewild ";"`。
不会。CAA 只在 CA 签发或续期时检查,已签发证书在到期前继续有效。要停止使用某张证书需要吊销或等过期,CAA 不能替代吊销。
配在最终权威 DNS zone。域名 NS 已切到 Cloudflare 就在 Cloudflare DNS 配;只是 CNAME 接入 CDN 时,源域名 CAA 仍由原权威 DNS 返回,建议源域名和 CDN 自定义域名都配置一致,避免签发时查到不同记录。
两者解决不同问题:CAA 限制哪些 CA 能签发,DNSSEC 防止 DNS 回答被篡改。高安全场景建议都配,但 DNSSEC 配置错误会导致 CAA 查询 SERVFAIL;先验证 `dig +dnssec CAA example.com` 正常,再逐步上线。
可以,同一域名可有多条 issue,每条一个 CA,CA 发现自己在任一 issue 中即可签发。`Invalid property tag` 通常是 tag 写成 `issues`、`issue-wild` 等非标准值;只保留 `issue`、`issuewild`、`iodef` 并等待 TTL 过期。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。