服务注册与分布式协调 / 系统课时

签发包含 SAN 的服务端证书

签发包含 SAN 的服务端证书

本节把客户端真实访问入口转换成证书 SAN,并用一套可复现的 OpenSSL 流程签发和校验证书。完成后,你能同时验证证书链、DNS 主机名和 IP 地址,避免只依赖 CN 或反向 DNS 带来的握手失败。

学习目标

  • 根据客户端实际连接方式规划 DNS 与 IP 类型的 SAN
  • 使用 CA 签发带 SAN 和 serverAuth 用途的服务端证书
  • 用 OpenSSL 分别验证证书链、DNS 名和 IP 地址

先按连接入口规划 SAN

主机名校验比对的是客户端“实际拿来连接的名字”,而不是你希望服务器叫什么。若客户端连接 zk-1.example.test:2281,证书至少应包含 DNS:zk-1.example.test;若还会通过服务别名连接,就把该别名也加入 DNS SAN。只有客户端确实使用 IP 直连时,才加入对应的 IP SAN。

下面是一组演示规划:

客户端连接方式 SAN 条目
zk-1.example.test:2281 DNS:zk-1.example.test
zookeeper.example.test:2281 DNS:zookeeper.example.test
192.0.2.21:2281 IP:192.0.2.21

签发带 SAN 的证书

下面的主示例使用 OpenSSL 1.1.1 或更高版本,先创建演示根 CA,再为 ZooKeeper 服务端签发叶子证书。示例域名使用保留的 .test 后缀,IP 使用文档网段,不会指向真实生产主机。

bash
set -euo pipefail
rm -rf ./tls-demo
mkdir ./tls-demo
cd ./tls-demo

# 创建仅用于演示的根 CA。
openssl genrsa -out ca.key 3072
openssl req -x509 -new -key ca.key -sha256 -days 3650 \
  -subj "/CN=Anystack Demo Root CA" \
  -addext "basicConstraints=critical,CA:TRUE" \
  -addext "keyUsage=critical,keyCertSign,cRLSign" \
  -out ca.crt

openssl genrsa -out server.key 3072
openssl req -new -key server.key \
  -subj "/CN=zk-1.example.test" \
  -out server.csr

cat > server.ext <<'EOF'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:zk-1.example.test,DNS:zookeeper.example.test,IP:192.0.2.21
EOF

openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -days 365 -sha256 -extfile server.ext -out server.crt

openssl x509 -in server.crt -noout -subject -issuer -ext subjectAltName

预期输出

text
subject=CN = zk-1.example.test
issuer=CN = Anystack Demo Root CA
X509v3 Subject Alternative Name:
    DNS:zk-1.example.test, DNS:zookeeper.example.test, IP Address:192.0.2.21

实际空格格式可能随 OpenSSL 版本略有不同,但 SAN 中应同时出现两个 DNS 名和一个 IP 地址。

分别验证链与主机名

证书“能被 CA 信任”与“名称匹配”是两件事,必须分开验证。先验证签发链,再按客户端的连接形式做 DNS 或 IP 校验。

bash
cd ./tls-demo
openssl verify -CAfile ca.crt server.crt
openssl verify -CAfile ca.crt -verify_hostname zk-1.example.test server.crt
openssl verify -CAfile ca.crt -verify_ip 192.0.2.21 server.crt

预期输出

text
server.crt: OK
server.crt: OK
server.crt: OK

若第一条失败,优先检查 CA 链、签名和证书有效期;若只有后两条失败,问题通常在 SAN 类型或取值。DNS 名必须放在 DNS SAN,IP 地址必须放在 IP SAN,不能把字符串形式的 IP 填进 DNS SAN 后期待通过 IP 校验。

放到 ZooKeeper 前检查用途

服务端证书还应包含 serverAuth 扩展用途。可在部署前做一次只读检查,避免证书格式正确但用途不合适。

bash
cd ./tls-demo
openssl x509 -in server.crt -noout -text | grep -A1 "Extended Key Usage"

预期输出

text
X509v3 Extended Key Usage:
    TLS Web Server Authentication

生产环境应由受控 CA 签发,并把私钥权限收紧到 ZooKeeper 运行账号。真正决定 SAN 内容的不是节点资产清单,而是客户端可能使用的 DNS 名和 IP;只要连接入口发生变化,就应重新核对证书是否仍覆盖这些名称。

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

目录与阅读设置

阅读设置

17

记录一个想法

签发包含 SAN 的服务端证书

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

登录哪都通