适用范围与准备

适用于管理员明确要求双向 TLS(mTLS)的自有 HTTPS 接口:已经确认服务器身份,但服务器仍要求客户端提供证书。本文以支持 PEM 证书与私钥的 curl TLS 后端为例;普通订阅 URL 或网页登录不能自行改成 mTLS。

先区分原因

--cacert 用来校验服务器信任链;--cert 与 --key 提供客户端自己的证书及对应私钥,让服务器认证调用方。下载服务器证书当客户端证书,或只补一个 CA 文件,都不能满足客户端身份认证。

按顺序操作

  1. 运行 curl --version,核对使用的 TLS 后端与文件格式。先从接口管理员的可信渠道确认是否启用 mTLS、客户端证书颁发方式以及接口权限;不要因一次 403 就推定缺少证书。
  2. 准备管理员签发给本客户端的证书及其配对私钥,保存于只允许本人或任务账户读取的位置。PEM、P12/PFX 与 Windows 证书存储区的使用方式不同;Schannel 等后端按自己的文档选择,不能只改扩展名。
  3. 替换下面的 URL 与三个本地文件路径。private-ca.pem 只在目标采用需单独提供的私有 CA 时使用;公开受信任服务通常沿用系统或 curl 信任库。不得使用 -k,也不要把私钥口令写进命令历史。
  4. 在获准的小型只读接口测试。加密私钥需要按当前后端支持的交互方式解锁;自动任务应使用已有的秘密管理方案。出现本地证书读取错误时先修正格式或权限,不反复换节点。
  5. 证书完成 TLS 认证后,接口仍可检查账号映射、权限和业务参数。记录失败处于握手还是 HTTP 响应阶段,不能将 TLS 成功当成拥有接口全部权限。
macOS/Linux,curl 使用支持 PEM 的 TLS 后端;仅 GET。文件由管理员提供,示例不包含实际证书。
curl --disable --connect-timeout 10 --max-time 30 --fail --cacert ./private-ca.pem --cert ./client.pem --key ./client.key https://api.example.com/health
材料或选项角色
--cacert客户端用来信任服务端的 CA
--cert服务端用来识别客户端的证书
--key对应客户端私钥,不能公开
HTTP 401/403还可能涉及独立的接口授权

怎样确认有效

受控接口确认预期客户端身份并返回正确结果。测试环境中“无客户端证书被拒绝、正确证书通过”的对照才能证明认证要求生效;不能把任意证书都能连接当作成功。

无效时恢复与下一步

移除本次测试参数并恢复原任务配置;测试证书按管理员规则回收。若私钥曾暴露,应撤销对应证书并重新签发,删除日志中的那一行不能撤回身份凭据。