我是给域名申请了pfx格式的证书,现在需要吧部署在openshift上的访问域名配置成https格式,需要做几步调整变更,请详细列出操作步骤
- User
我是给域名申请了pfx格式的证书,现在需要吧部署在openshift上的访问域名配置成https格式,需要做几步调整变更,请详细列出操作步骤
Assistant
在 OpenShift 中为域名配置 HTTPS 访问(使用 PFX 格式证书),需将 PFX 证书转换为 PEM 格式并配置到 Route 中。以下是详细步骤:
步骤 1:将 PFX 证书转换为 PEM 格式
PFX 证书通常包含证书、私钥和 CA 链,需提取为 OpenShift 可用的 PEM 文件:
# 提取证书(PEM 格式) openssl pkcs12 -in your-cert.pfx -clcerts -nokeys -out tls.crt -password pass:your-pfx-password # 提取私钥(PEM 格式) openssl pkcs12 -in your-cert.pfx -nocerts -nodes -out tls.key -password pass:your-pfx-password # 提取 CA 证书链(可选,如果 PFX 包含中间 CA) openssl pkcs12 -in your-cert.pfx -cacerts -nokeys -out ca.crt -password pass:your-pfx-password
步骤 2:创建 OpenShift TLS Secret
将转换后的
tls.crt和tls.key存入 Secret:oc create secret tls my-https-secret \ --cert=tls.crt \ --key=tls.key \ -n your-namespace如果存在中间 CA 证书,需将 CA 证书合并到
tls.crt中:cat tls.crt ca.crt > combined.crt oc create secret tls my-https-secret \ --cert=combined.crt \ --key=tls.key \ -n your-namespace
步骤 3:配置 Route 使用 HTTPS
创建或修改 Route,指定 TLS 终止方式(如
edge或reencrypt)并引用 Secret:apiVersion: route.openshift.io/v1 kind: Route metadata: name: my-https-route namespace: your-namespace spec: host: your-domain.com # 替换为你的域名 to: kind: Service name: your-service # 替换为后端服务名 tls: termination: edge # 或 reencrypt(如需加密到后端) key: tls.key # 私钥字段(自动从 Secret 读取) certificate: tls.crt # 证书字段(自动从 Secret 读取) insecureEdgeTerminationPolicy: Redirect # 强制 HTTP 跳转到 HTTPS wildcardPolicy: None关键参数说明:
termination: edge:TLS 在路由器终止(明文传输到后端)。termination: reencrypt:TLS 全程加密(需后端服务支持 HTTPS)。insecureEdgeTerminationPolicy: Redirect:自动将 HTTP 请求重定向到 HTTPS。
步骤 4(可选):验证证书链
如果证书链不完整,可能导致浏览器警告。可通过以下命令验证:
openssl verify -CAfile ca.crt tls.crt若提示
unable to get local issuer certificate,需将中间 CA 合并到tls.crt中(如步骤 2 所示)。
步骤 5:应用并测试
- 应用 Route 配置:
oc apply -f route.yaml - 测试 HTTPS 访问:
检查输出中的证书信息:curl -vI https://your-domain.com* Server certificate: * subject: CN=your-domain.com * start date: Jul 1 00:00:00 2023 GMT * expire date: Jul 1 23:59:59 2024 GMT * issuer: C=US; O=Let's Encrypt; CN=R3 * SSL certificate verify ok.
常见问题处理
-
证书不信任:
- 确保 CA 证书链完整(合并中间 CA 到
tls.crt)。 - 使用公共 CA(如 Let's Encrypt)或导入私有 CA 到客户端。
- 确保 CA 证书链完整(合并中间 CA 到
-
私钥不匹配:
- 检查 PFX 转换时是否输出了正确的私钥:
openssl rsa -in tls.key -check
- 检查 PFX 转换时是否输出了正确的私钥:
-
路由未生效:
- 检查 Route 状态:
oc get route my-https-route -o yaml - 查看路由器日志:
oc logs -f deployment/router -n openshift-ingress
- 检查 Route 状态:
总结
- 转换 PFX 为 PEM(证书 + 私钥 + 可选 CA 链)。
- 创建 TLS Secret 存储证书和私钥。
- 配置 Route 指定 TLS 终止方式并引用 Secret。
- 测试 HTTPS 确保证书链完整。
完成后,你的域名将通过 HTTPS 安全访问 OpenShift 服务。