Skip to main content

身份与凭证实践:SA token / CSR 证书 / PSA

覆盖考纲 Cluster Architecture(25%) 中 RBAC 的落地部分。 8A 讲"链路怎么走",8B 讲"在链路上造东西":造程序身份、造人身份、配准入策略。


核心认知:8B 做三件事​

做什么用什么对应 8A 链路哪步
造程序身份ServiceAccount token①② 凭证
造人身份CSR 签发客户端证书①② 凭证
配准入策略PodSecurity Admission⑤ 准入控制

两种身份的分界:

ServiceAccountUser
给谁程序(Pod 里的进程)人
凭证JWT token,Pod 自动挂载或 kubectl create token客户端证书(CN=用户名,O=组)
有效期1 小时自定义(默认 1 年)
有对象吗✅ kubectl create sa❌ 只能签证书

一、ServiceAccount token 演进​

旧方式(≤ 1.23)新方式(≥ 1.24)
建 SA 时自动生成 Secret 存 token不生成 Secret(实测 secrets: 字段为空)
有效期长期不过期1 小时
挂载方式Secret volume投影卷 + TokenRequest API
轮换无kubelet 自动轮换

投影卷的 YAML 结构​

volumes:
- name: token # volume 名,volumeMounts 引用
projected: # 投影卷,可合并多个数据源
defaultMode: 420 # 文件权限,420 = 八进制 0644
sources:
- serviceAccountToken: # 数据源类型
audience: ... # token 受众(默认 apiserver)
expirationSeconds: 3600 # 1 小时轮换
path: token # 容器里的文件名

对应的挂载:

containers:
- volumeMounts:
- mountPath: /var/run/secrets/kubernetes.io/serviceaccount
name: token
readOnly: true

容器里看到的结构​

..2026_11_10_14_43_11.1853067417    ← 时间戳目录(kubelet 每小时建新的)
..data -> ..2026_11_10_14_43_11... ← 符号链接指向最新
ca.crt -> ..data/ca.crt
namespace -> ..data/namespace
token -> ..data/token ← 容器读这个,永远是最新的

kubelet 每小时更新符号链接,容器不需要重启就能拿到新 token。

JWT 内容​

{
"exp": 1825857791, // 过期时间
"sub": "system:serviceaccount:default:my-gw-nginx", // 身份(8A 讲过的格式)
"kubernetes.io": {
"pod": {"name": "..."},
"serviceaccount": {"name": "my-gw-nginx"}
}
}

token 绑定了具体 Pod——Pod 删了 token 也失效。

automountServiceAccountToken​

spec:
automountServiceAccountToken: false # 不挂载 token

不需要访问 apiserver 的 Pod 应该关掉,减少攻击面。


二、用 SA token 造 kubeconfig(三步)​

# ① 拿 token
TOKEN=$(kubectl create token <sa> -n <ns>)

# ② 三段:cluster / credentials / context
kubectl config set-cluster lab \
--server=https://192.168.10.12:6443 \
--certificate-authority=/etc/kubernetes/pki/ca.crt \
--kubeconfig=/tmp/x.conf

kubectl config set-credentials <sa> \
--token="$TOKEN" \
--kubeconfig=/tmp/x.conf

kubectl config set-context <sa>@<ns> \
--cluster=lab --user=<sa> --namespace=<ns> \
--kubeconfig=/tmp/x.conf

# ③ 使用(不改默认 kubeconfig)
KUBECONFIG=/tmp/x.conf kubectl get pods -n <ns>

kubeconfig 的 users 段用 token 字段,不是 client-certificate-data。

⚠️ 官方没有端到端文档,考点只能靠练熟。三步缺一不可——少了 set-cluster 会报 localhost:8080 connection refused。

token 1 小时过期,超过就 Unauthorized(401)。重新 kubectl create token 后 set-credentials --token 更新即可。


三、用 CSR 签证书造 User kubeconfig(八步)​

# ① 私钥
openssl genrsa -out alice.key 2048

# ② CSR(CN=用户名,O=组名)
openssl req -new -key alice.key -out alice.csr -subj "/CN=alice/O=dev"

# ③ 提交给集群
cat <<EOF | kubectl apply -f -
apiVersion: certificates.k8s.io/v1
kind: CertificateSigningRequest
metadata:
name: alice-csr
spec:
request: $(base64 -w0 alice.csr)
signerName: kubernetes.io/kube-apiserver-client
expirationSeconds: 31536000 # 365 天(最小 600 秒)
usages: [client auth]
EOF

# ④ 审批(集群 CA 签发)
kubectl certificate approve alice-csr

# ⑤ 提取证书
kubectl get csr alice-csr -o jsonpath='{.status.certificate}' | base64 -d > alice.crt

# ⑥ 写 kubeconfig
kubectl config set-credentials alice \
--client-certificate=alice.crt \
--client-key=alice.key \
--embed-certs=true \
--kubeconfig=/tmp/alice.conf

# ⑦ 绑权限
kubectl create rolebinding alice-edit \
--clusterrole=edit --user=alice -n <ns>

# ⑧ 验证
KUBECONFIG=/tmp/alice.conf kubectl auth whoami

关键字段​

字段意义
spec.signerNamekubernetes.io/kube-apiserver-client = 签客户端证书
spec.expirationSeconds有效期,默认取 --cluster-signing-duration(1 年)与它的较小值
spec.usages必须是 client auth
--embed-certs=true证书嵌入 kubeconfig,不引用文件路径

实测输出​

whoami: Username=alice  Groups=[dev system:authenticated]
证书: subject=O=dev, CN=alice
issuer=CN=kubernetes ← 集群 CA 签的,不是自签

两种 kubeconfig 终极对比​

SA token证书
users 段字段tokenclient-certificate-data + client-key-data
身份system:serviceaccount:<ns>:<name>CN 的值
有效期1 小时1 年
给谁程序(CI/CD)人
签发方TokenRequest API集群 CA(CSR API)
维护成本高(定期刷新)低

CSR API 的核心价值:不需要 CA 私钥(/etc/kubernetes/pki/ca.key)就能签证书,权限可控。


四、PodSecurity Admission(PSA)​

替代已移除的 PSP(1.25),通过 namespace 标签控制,不需要装组件。

三档模式​

模式禁什么适合谁
privileged几乎不禁系统组件
baselinehostNetwork/hostPID/privileged: true/危险 capabilities一般应用
restrictedbaseline + 禁止 root + drop ALL capabilities + seccompProfile高安全要求

三个标签维度​

标签不合规时
enforce拒绝创建(报 is forbidden)
audit创建成功,写审计日志
warn创建成功,返回 would violate 警告
kubectl label ns <ns> \
pod-security.kubernetes.io/enforce=restricted \
pod-security.kubernetes.io/warn=restricted

restricted 的四条检查​

violates PodSecurity "restricted:latest":
① allowPrivilegeEscalation != false ← 必须设为 false
② unrestricted capabilities ← 必须 drop: ["ALL"]
③ runAsNonRoot != true ← 必须声明非 root
④ seccompProfile ← 必须设 RuntimeDefault

四条缺一不可,报错会逐条告诉你该怎么改。

通过 restricted 的最小 securityContext:

spec:
securityContext:
runAsNonRoot: true
seccompProfile:
type: RuntimeDefault
containers:
- name: app
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop: ["ALL"]

打标签时会检查已有 Pod​

Warning: existing pods in namespace "psa-lab" violate the new PodSecurity enforce level "baseline:latest"
Warning: privileged-pod: host namespaces

只提示不删——已有 Pod 不会因为改标签被清理。


踩坑实录​

① 1.24+ 建 SA 不生成 Secret

kubectl get sa X -o yaml 的 secrets: 字段为空。旧认知("SA 自动生成 Secret 存 token")已过时。

② SA token kubeconfig 少了 set-cluster 会连 localhost:8080

couldn't get current server API group list: Get "http://localhost:8080/api": connection refused

kubectl 找不到 cluster 配置就回退到默认的 localhost:8080。四步缺一不可。

③ token 1 小时过期,跨天必失效

昨天造的 kubeconfig 今天用 → Unauthorized(401)。重新 kubectl create token + set-credentials 即可。

④ --embed-certs=true 不能省

不写的话 kubeconfig 里存的是证书文件路径。换台机器就失效。写 true 才是自包含的。

⑤ PSA 的 warn 只提示不阻止

would violate 的 Pod 照样创建。要真正拦住必须用 enforce。


复习自测题(答案)​

Q1:1.36 集群新建 SA,会自动生成 Secret 吗? 不会。1.24 起移除该行为,secrets: 字段为空。token 由 TokenRequest API 动态签发。

Q2:Pod 里的 token 会过期吗?怎么更新? 会,1 小时。kubelet 自动轮换:每小时创建新的时间戳目录,更新 ..data 符号链接。容器通过符号链接读到的永远是最新 token,无需重启。

Q3:SA token kubeconfig 和证书 kubeconfig 的核心区别? users 段字段不同(token vs client-certificate-data);有效期不同(1 小时 vs 1 年);用途不同(程序 vs 人)。

Q4:spec.expirationSeconds 设 100 天,但 --cluster-signing-duration 是 365 天,最终有效期? 取较小值 = 100 天。反过来设 500 天则签发 365 天。

Q5:PSA 的 restricted 为什么不通过以 root 跑的 nginx Pod? restricted 要求 runAsNonRoot=true 或非 0 的 runAsUser。nginx:alpine 这两个都没设,默认可能以 root 跑。

Q6:warn 和 enforce 的区别? enforce 拒绝创建(is forbidden);warn 创建成功但返回 would violate 警告。


速记卡片​

# ── SA token kubeconfig(三步,考点必背)────────
TOKEN=$(kubectl create token <sa> -n <ns>)
kubectl config set-cluster lab --server=https://<ip>:6443 \
--certificate-authority=/etc/kubernetes/pki/ca.crt --kubeconfig=/tmp/x.conf
kubectl config set-credentials <sa> --token="$TOKEN" --kubeconfig=/tmp/x.conf
kubectl config set-context <sa>@<ns> --cluster=lab --user=<sa> \
--namespace=<ns> --kubeconfig=/tmp/x.conf
KUBECONFIG=/tmp/x.conf kubectl get pods -n <ns>

# ── CSR 签证书(八步)───────────────────────────
openssl genrsa -out u.key 2048
openssl req -new -key u.key -out u.csr -subj "/CN=<user>/O=<group>"
# 创建 CSR 对象(signerName: kubernetes.io/kube-apiserver-client)
kubectl certificate approve <csr-name>
kubectl get csr <csr-name> -o jsonpath='{.status.certificate}' | base64 -d > u.crt
kubectl config set-credentials <user> --client-certificate=u.crt \
--client-key=u.key --embed-certs=true --kubeconfig=/tmp/u.conf
kubectl create rolebinding <rb> --clusterrole=edit --user=<user> -n <ns>

# ── PSA ────────────────────────────────────────
kubectl label ns <ns> pod-security.kubernetes.io/enforce=restricted
kubectl label ns <ns> pod-security.kubernetes.io/warn=restricted

# ── 判定口径 ────────────────────────────────────
# SA token: 1h 过期,secrets 字段为空(1.24+)
# 证书: CN=用户, O=组, issuer=CN=kubernetes
# restricted 四条: allowPrivilegeEscalation=false / drop ALL / runAsNonRoot / seccompProfile
# enforce 拒绝(is forbidden) vs warn 提示(would violate)
# expirationSeconds 取与 cluster-signing-duration 的较小值