CA 和客户端证书

你可以在 Apidog 中添加和管理证书，以便在向需要基于证书的安全机制的 API 发送请求时启用身份验证。这对于连接使用双向 TLS（mTLS）或自定义证书颁发机构的 API 至关重要。

理解证书身份验证

双向 TLS（mTLS） 是一种身份验证方法，要求客户端和服务器都使用证书确认其身份。一旦双方身份得到确认，就会建立加密连接。与传统的单向 TLS 相比，这提供了更强的安全性。

自定义 CA 证书 使你能够连接到使用内部证书注册机构注册的证书的端点。如果不添加 CA 证书，从 Apidog 发送的请求将失败，并显示 "SSL Error: Self signed certificate。"

管理证书

在 Apidog 设置中，你可以查看已安装的证书、添加新证书或移除证书。

选择右上角的设置图标。

选择 Certificates 选项卡。

添加 CA 证书

为了避免在向使用自定义证书颁发机构的 API 发送请求时出现 "self signed certificate" 错误，请将你的 CA 证书添加到 Apidog。

打开 CA Certificates 旁边的开关。

选择你的 CA 证书的 PEM 文件。

多个 CA 证书

PEM 文件可以包含多个 CA 证书。Apidog 将从该文件加载所有证书。

添加客户端证书

要向使用双向 TLS 身份验证的 API 发送请求，请将你的客户端证书添加到 Apidog。

选择 Add Certificate。

输入证书的 Host 域名（不要包含协议）。

模式匹配

Host 字段支持模式匹配。如果你输入 *.example.com，同一个客户端证书将用于所有 example.com 子域名。

（可选）输入要与该域名关联的自定义端口号。如果你未指定端口，Apidog 将使用默认 HTTPS 端口（443）。

选择证书文件：

选项 1：选择你的证书的 CRT file 和 Key file

选项 2：选择你的证书的 PFX file

如果你在生成客户端证书时使用了 Passphrase，请在框中输入它。否则，将该框留空。

选择 Add。

每个域名一个证书

每个客户端证书都特定于一个域名。不要为同一个域名添加多个证书。如果你为一个域名添加多个证书，Apidog 将使用最后添加的证书，这可能会导致意外行为。

编辑证书

添加证书后无法编辑该证书。要进行更改：

移除现有证书

使用所需设置生成新证书

将新证书添加到 Apidog

移除证书

如果你不再需要某个证书来从 Apidog 发送请求，请将其移除。

证书类型	如何移除
CA 证书	选择证书旁边的移除图标（Close 图标）
客户端证书	选择证书旁边的删除图标（Delete 图标）

使用证书

添加客户端证书后，你无需执行任何额外步骤即可在 Apidog 中使用该证书。

自动行为：

当你向已配置的域名发起 HTTPS 请求时，Apidog 会自动随请求发送客户端证书

证书使用 OpenSSL 处理机制发送

Apidog 不会以任何方式修改证书

HTTP 请求

如果你发起 HTTP 请求，Apidog 不会发送证书。证书只会通过 HTTPS 连接发送。

CA 和客户端证书

理解证书身份验证#

管理证书#

添加 CA 证书#

添加客户端证书#

编辑证书#

移除证书#

使用证书#

理解证书身份验证

管理证书

添加 CA 证书

添加客户端证书

编辑证书

移除证书

使用证书