容器与云原生 / 系统课时

启用并验证双向 TLS

启用并验证双向 TLS

本课把一个命名空间从可同时接收明文与 mTLS 的过渡状态收紧到只接受 mTLS,并用网格内客户端与未注入代理的遗留客户端做正反验证。重点不是简单切换 STRICT,而是先确认调用方具备 mTLS 能力,再完成收紧并验证边界。

学习目标

  • 理解 PeerAuthentication 对服务端入站连接的控制范围,以及 PERMISSIVE 与 STRICT 的差异。
  • 为命名空间启用严格 mTLS,并用实际请求验证网格内与遗留客户端的行为。
  • 识别从宽松模式切到严格模式时的中断风险,并建立收紧前的检查顺序。

先确认迁移前提

本课以 Sidecar 数据面为例。已进入网格的客户端通常由代理通过 Istio 自动 mTLS 访问网格内工作负载;服务端处于 PERMISSIVE 时,同时接受 mTLS 与明文。这个状态适合迁移,却不能阻止未进入网格的客户端继续以明文访问服务。

先确认目标工作负载已经注入代理,并检查是否存在会改变认证或客户端 TLS 行为的策略。下面假设目标命名空间是 payments,服务端工作负载标签为 app=payments-api。

bash
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

预期输出

text
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> 表示环境相关值。

从 PERMISSIVE 迁移到 STRICT 的 mTLS 收紧路径

用 PeerAuthentication 收紧入站

PeerAuthentication 控制目标工作负载接受什么类型的入站连接,并不负责决定客户端代理向外发送哪种 TLS。要对整个 payments 命名空间收紧,可创建一个不带 selector 的命名空间级策略。

bash
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

预期输出

text
peerauthentication.security.istio.io/default <VALUE>
STRICT

第一行的 <VALUE> 通常是 created 或 configured,取决于资源是否已存在。如果只想先收紧某个工作负载,可以增加 selector.matchLabels。端口级策略还支持 portLevelMtls,但其中的端口号是工作负载端口,不是 Kubernetes Service 的端口;混淆两者会导致策略已创建却没有作用到预期端口。

验证允许与拒绝的边界

验证时保留两类调用方:一个已经注入 Sidecar 的网格内客户端,以及一个没有代理的遗留客户端。假设它们分别位于 mesh-client 与 legacy-client 命名空间,目标服务为 payments-api.payments:8080。两条命令应独立执行,分别验证允许和拒绝路径。

bash
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

预期输出

text
mesh=200
legacy=000

mesh=200 表示网格内客户端仍能通过代理完成请求;legacy=000 表示未注入代理的客户端没有取得 HTTP 响应。000 是 curl 在未收到 HTTP 状态码时输出的值,底层可能表现为连接重置、TLS 协议不匹配或连接提前关闭,因此不要依赖具体错误文字作为唯一判断依据。

如果业务请求成功但还需要确认连接确实使用了 mTLS,应进一步结合代理访问日志、遥测中的连接安全信息或对端工作负载身份进行确认,而不要只把 HTTP 200 当作 mTLS 已生效的唯一证据。

从宽松切到严格时避免中断

PERMISSIVE 适合增量接入,因为它允许同一服务在迁移期间同时接收 mTLS 与明文。但在切换到 STRICT 前,必须找出所有仍以明文访问的调用方,例如未注入 Sidecar 的 Pod、被排除于代理捕获范围的端口或进程、旧 VM 客户端,以及不经过网格代理的健康检查来源。

若切换后大量请求立即失败,应先判断故障是否来自未迁移调用方。需要快速恢复兼容时,可暂时将该 PeerAuthentication 调回 PERMISSIVE,再定位没有经过 Istio 代理的请求或显式覆盖自动 mTLS 的客户端策略。安全的迁移顺序始终是:先让调用方具备并验证 mTLS 能力,再收紧服务端接收策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

启用并验证双向 TLS

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

登录哪都通