服务注册与分布式协调 / 系统课时
签发包含 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 使用文档网段,不会指向真实生产主机。
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预期输出
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 校验。
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预期输出
server.crt: OK
server.crt: OK
server.crt: OK若第一条失败,优先检查 CA 链、签名和证书有效期;若只有后两条失败,问题通常在 SAN 类型或取值。DNS 名必须放在 DNS SAN,IP 地址必须放在 IP SAN,不能把字符串形式的 IP 填进 DNS SAN 后期待通过 IP 校验。
放到 ZooKeeper 前检查用途
服务端证书还应包含 serverAuth 扩展用途。可在部署前做一次只读检查,避免证书格式正确但用途不合适。
cd ./tls-demo
openssl x509 -in server.crt -noout -text | grep -A1 "Extended Key Usage"预期输出
X509v3 Extended Key Usage:
TLS Web Server Authentication生产环境应由受控 CA 签发,并把私钥权限收紧到 ZooKeeper 运行账号。真正决定 SAN 内容的不是节点资产清单,而是客户端可能使用的 DNS 名和 IP;只要连接入口发生变化,就应重新核对证书是否仍覆盖这些名称。