密码学与证书 / 系统课时

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。下面的命令只创建目录和空凭据文件,不会把真实令牌写进命令历史。

bash
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

预期输出

text
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。

安全目标不是“把文件藏起来”,而是让令牌即使泄露也只能影响尽可能少的域名和操作,同时让自动续期进程拥有刚好足够的读取权限。

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

目录与阅读设置

阅读设置

17

记录一个想法

DNS API 密钥应该怎样保护

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

登录哪都通