容器与云原生 / 系统课时
启用并验证双向 TLS
启用并验证双向 TLS
本课把一个命名空间从可同时接收明文与 mTLS 的过渡状态收紧到只接受 mTLS,并用网格内客户端与未注入代理的遗留客户端做正反验证。重点不是简单切换 STRICT,而是先确认调用方具备 mTLS 能力,再完成收紧并验证边界。
学习目标
- 理解
PeerAuthentication对服务端入站连接的控制范围,以及PERMISSIVE与STRICT的差异。 - 为命名空间启用严格 mTLS,并用实际请求验证网格内与遗留客户端的行为。
- 识别从宽松模式切到严格模式时的中断风险,并建立收紧前的检查顺序。
先确认迁移前提
本课以 Sidecar 数据面为例。已进入网格的客户端通常由代理通过 Istio 自动 mTLS 访问网格内工作负载;服务端处于 PERMISSIVE 时,同时接受 mTLS 与明文。这个状态适合迁移,却不能阻止未进入网格的客户端继续以明文访问服务。
先确认目标工作负载已经注入代理,并检查是否存在会改变认证或客户端 TLS 行为的策略。下面假设目标命名空间是 payments,服务端工作负载标签为 app=payments-api。
kubectl get pods -n payments -l app=payments-api -o custom-columns=NAME:.metadata.name,CONTAINERS:.spec.containers[*].name
kubectl get peerauthentication -A -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,MTLS:.spec.mtls.mode
kubectl get destinationrule -A -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,HOST:.spec.host,TLS:.spec.trafficPolicy.tls.mode预期输出
NAME CONTAINERS
payments-api-<ID> payments-api,istio-proxy
NAMESPACE NAME MTLS
<namespace> <name> <VALUE>
NAMESPACE NAME HOST TLS
<namespace> <name> <VALUE> <VALUE>实际资源名称会不同;关键是目标 Pod 中存在 istio-proxy。策略列表可能为空,也可能包含已有资源。如果存在更具体的 PeerAuthentication,或 DestinationRule 显式设置了客户端 TLS 模式,应先确认其作用范围,避免把策略覆盖或 DISABLE 等显式设置误判为 mTLS 本身故障。输出中的 <VALUE> 表示环境相关值。

用 PeerAuthentication 收紧入站
PeerAuthentication 控制目标工作负载接受什么类型的入站连接,并不负责决定客户端代理向外发送哪种 TLS。要对整个 payments 命名空间收紧,可创建一个不带 selector 的命名空间级策略。
cat <<'EOF' | kubectl apply -f -
apiVersion: security.istio.io/v1
kind: PeerAuthentication
metadata:
name: default
namespace: payments
spec:
mtls:
mode: STRICT
EOF
kubectl get peerauthentication default -n payments -o jsonpath='{.spec.mtls.mode}' && echo预期输出
peerauthentication.security.istio.io/default <VALUE>
STRICT第一行的 <VALUE> 通常是 created 或 configured,取决于资源是否已存在。如果只想先收紧某个工作负载,可以增加 selector.matchLabels。端口级策略还支持 portLevelMtls,但其中的端口号是工作负载端口,不是 Kubernetes Service 的端口;混淆两者会导致策略已创建却没有作用到预期端口。
验证允许与拒绝的边界
验证时保留两类调用方:一个已经注入 Sidecar 的网格内客户端,以及一个没有代理的遗留客户端。假设它们分别位于 mesh-client 与 legacy-client 命名空间,目标服务为 payments-api.payments:8080。两条命令应独立执行,分别验证允许和拒绝路径。
kubectl exec -n mesh-client deploy/curl -c curl -- curl -sS -o /dev/null -w 'mesh=%{http_code}\n' http://payments-api.payments:8080/health
kubectl exec -n legacy-client deploy/curl -- curl -sS -o /dev/null -w 'legacy=%{http_code}\n' --connect-timeout 3 http://payments-api.payments:8080/health 2>/dev/null || true预期输出
mesh=200
legacy=000mesh=200 表示网格内客户端仍能通过代理完成请求;legacy=000 表示未注入代理的客户端没有取得 HTTP 响应。000 是 curl 在未收到 HTTP 状态码时输出的值,底层可能表现为连接重置、TLS 协议不匹配或连接提前关闭,因此不要依赖具体错误文字作为唯一判断依据。
如果业务请求成功但还需要确认连接确实使用了 mTLS,应进一步结合代理访问日志、遥测中的连接安全信息或对端工作负载身份进行确认,而不要只把 HTTP 200 当作 mTLS 已生效的唯一证据。
从宽松切到严格时避免中断
PERMISSIVE 适合增量接入,因为它允许同一服务在迁移期间同时接收 mTLS 与明文。但在切换到 STRICT 前,必须找出所有仍以明文访问的调用方,例如未注入 Sidecar 的 Pod、被排除于代理捕获范围的端口或进程、旧 VM 客户端,以及不经过网格代理的健康检查来源。
若切换后大量请求立即失败,应先判断故障是否来自未迁移调用方。需要快速恢复兼容时,可暂时将该 PeerAuthentication 调回 PERMISSIVE,再定位没有经过 Istio 代理的请求或显式覆盖自动 mTLS 的客户端策略。安全的迁移顺序始终是:先让调用方具备并验证 mTLS 能力,再收紧服务端接收策略。