密码学与证书 / 系统课时
DNS API 密钥应该怎样保护
DNS API 密钥应该怎样保护
DNS-01 自动续期依赖 DNS 服务商的 API 凭据。只要这份凭据还能修改目标区域的 DNS 记录,它就属于生产级秘密;本篇给出文件权限、最小授权和泄露后的处理方法,在不破坏自动续期的前提下降低密钥暴露范围。
学习目标
- 用文件权限限制 Certbot DNS 凭据的读取范围
- 为 DNS API 令牌设计尽可能小的区域和操作权限
- 知道自动续期需要什么访问条件,以及密钥泄露后如何处置
把 DNS 凭据视为生产级秘密
DNS-01 插件需要通过 API 创建和删除 _acme-challenge TXT 记录。能够执行这类操作的令牌一旦泄露,攻击者可能利用其权限修改 DNS;实际影响取决于令牌被授权的区域和操作范围。
因此不要把凭据写进 Git 仓库、Web 根目录、镜像层、聊天记录或可被普通用户读取的脚本。也不要为了方便让 Nginx 用户读取它:Web 服务器读取 TLS 私钥与 Certbot 调用 DNS API 是两条不同的权限链。
用文件权限限制谁能读取
在常见的 Linux 部署中,可以把 DNS 插件凭据放进仅供 root 使用的目录,并将文件权限设为 0600。下面的命令只创建目录和空凭据文件,不会把真实令牌写进命令历史。
sudo install -d -m 700 /root/.secrets/certbot
sudo touch /root/.secrets/certbot/dns-provider.ini
sudo chown root:root /root/.secrets/certbot/dns-provider.ini
sudo chmod 600 /root/.secrets/certbot/dns-provider.ini
sudo stat -c '%a %U %G %n' /root/.secrets/certbot/dns-provider.ini预期输出
600 root root /root/.secrets/certbot/dns-provider.ini实际凭据文件中的字段名由 DNS 插件决定,应按对应插件文档填写,不要自行猜测参数名。文件创建后再用只对管理员开放的编辑方式写入令牌,避免把秘密直接放在命令行参数中。
最小权限要同时限制范围和能力
优先使用可限定权限的 API Token,而不是覆盖整个账户的全局密钥。授权时至少检查两个维度:资源范围只包含确实需要签发证书的 DNS Zone;操作能力只开放插件完成 DNS-01 所需的 DNS 记录读写能力。
如果服务商还要求读取 Zone 元数据,可以按插件文档补充必要的只读权限,但不应顺手授予账户管理、用户管理、计费或其他无关权限。不同 DNS 服务商的权限模型不同,最终以所用插件和服务商的官方说明为准。
自动续期也必须能读取同一份凭据
首次签发成功并不代表续期一定成功。Certbot 会在续期配置中保存所用认证器及相关配置路径,因此定时续期执行时,运行 Certbot 的账户仍要能够读取凭据文件。若你后来移动文件、改变所有者或改用专用运行账户,需要同步确认续期任务的读取权限。
不要为了消除权限问题直接改成 0644。更合适的做法是让续期进程以正确的账户运行,或在确有需要时使用受控组权限,并把读取者限制到最小集合。
密钥泄露后先撤销再验证
一旦怀疑令牌出现在日志、仓库、终端历史或第三方系统中,应先在 DNS 服务商侧撤销旧令牌并签发新令牌,然后更新 Certbot 使用的凭据文件。之后检查近期 DNS 变更记录,确认没有异常记录或未授权修改,并通过 Certbot 的续期演练验证新凭据仍能完成 DNS-01。
安全目标不是“把文件藏起来”,而是让令牌即使泄露也只能影响尽可能少的域名和操作,同时让自动续期进程拥有刚好足够的读取权限。