跳到主要内容
版本:3.8.x

在客户端与 API7 网关之间配置 mTLS

双向 TLS(mTLS)是传输层安全性(TLS)的增强形式,用于客户端和服务器之间的双向身份认证。它通过握手过程实现,双方交换并验证证书,以确认彼此的身份。

本指南介绍如何在客户端与 API7 网关之间配置 mTLS,以防止未经授权的访问并增强安全性。

前提条件​

生成证书和密钥​

  1. 生成证书颁发机构(CA)的密钥和证书:

    openssl genrsa -out ca.key 2048
    openssl req -new -x509 -days 36500 -sha256 \
    -key ca.key \
    -out ca.crt \
    -subj "/CN=MyTestCA" \
    -extensions v3_ca \
    -config <(printf "[req]\ndistinguished_name=req\n[ v3_ca ]\nbasicConstraints=critical,CA:TRUE\nkeyUsage=critical,keyCertSign,cRLSign\nsubjectKeyIdentifier=hash\nauthorityKeyIdentifier=keyid:always,issuer")
  2. 生成密钥和证书签名请求(CSR):

    openssl genrsa -out server.key 2048
    openssl req -new -sha256 \
    -key server.key \
    -out server.csr \
    -subj "/CN=test.com"
  3. 使用 CA 证书签署服务器 CSR,生成服务器证书:

    openssl x509 -req -days 36500 -sha256 \
    -in server.csr \
    -CA ca.crt -CAkey ca.key -CAcreateserial \
    -out server.crt \
    -extensions v3_req \
    -extfile <(printf "[v3_req]\nbasicConstraints=CA:FALSE\nkeyUsage=digitalSignature,keyEncipherment\nextendedKeyUsage=serverAuth")
  4. 为客户端生成密钥和证书签名请求(CSR):

    openssl genrsa -out client.key 2048
    openssl req -new -sha256 \
    -key client.key \
    -out client.csr \
    -subj "/CN=CLIENT"
  5. 使用 CA 证书签署客户端 CSR,生成客户端证书:

    openssl x509 -req -days 36500 -sha256 \
    -in client.csr \
    -CA ca.crt -CAkey ca.key -CAcreateserial \
    -out client.crt \
    -extensions v3_req \
    -extfile <(printf "[v3_req]\nbasicConstraints=CA:FALSE\nkeyUsage=digitalSignature,keyEncipherment\nextendedKeyUsage=clientAuth")

上传证书​

如果你希望从 Secret 提供商引用 SSL 证书,请参阅引用 HashiCorp Vault 中的密钥、引用 AWS Secrets Manager 中的密钥或引用 Kubernetes Secret 中的密钥。

创建证书

  1. 从侧边栏选择网关组的证书,进入 SSL 证书选项卡。
  2. 点击新增 SSL 证书。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 Test SSL Certificate。
  • 在证书字段中上传 server.crt 文件。
  • 在私钥字段中上传 server.key 文件。
  • 点击新增。
  1. 从侧边栏选择网关组的证书,然后点击 CA 证书选项卡。
  2. 点击新增 CA 证书。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 Test CA Certificate。
  • 在证书字段中上传 ca.crt 文件。
  • 点击新增。

创建 SNI

  1. 从侧边栏选择网关组的 SNI。
  2. 点击新增 SNI。
  3. 在对话框中,执行以下操作:
  • 在名称字段中输入 Test SNI。
  • 在域名字段中输入 test.com。
  • 在 SSL 协议字段中选择 TLS 1.2 和 TLS 1.3。
  • 在 SSL 证书字段中选择此前创建的 Test SSL Certificate。
  • 打开 mTLS 开关。
  • 在 CA 证书字段中选择此前创建的 Test CA Certificate。
  • 点击新增。
  1. 在使用情况字段中,你应该会看到主机名为 test.com 的匹配的已发布服务。然后即可进行验证。

验证客户端与 API7 网关之间的 mTLS​

使用客户端证书​

使用客户端证书向 https://test.com:9443/ip 发送请求,并将 test.com 解析为 127.0.0.1。

curl -ikv --resolve "test.com:9443:127.0.0.1" "https://test.com:9443/ip" \
--cert client.crt --key client.key

类似以下内容的 mTLS 握手表明,客户端与 API7 网关之间的 mTLS 连接已成功建立:

* Added test.com:9443:127.0.0.1 to DNS cache
* Hostname test.com was found in DNS cache
* Trying 127.0.0.1:9443...
* Connected to test.com (127.0.0.1) port 9443
* ALPN: curl offers h2,http/1.1
Handling connection for 9443
* (304) (OUT), TLS handshake, Client hello (1):
* (304) (IN), TLS handshake, Server hello (2):
* (304) (IN), TLS handshake, Unknown (8):
* (304) (IN), TLS handshake, Request CERT (13):
* (304) (IN), TLS handshake, Certificate (11):
* (304) (IN), TLS handshake, CERT verify (15):
* (304) (IN), TLS handshake, Finished (20):
* (304) (OUT), TLS handshake, Certificate (11):
* (304) (OUT), TLS handshake, CERT verify (15):
* (304) (OUT), TLS handshake, Finished (20):
* SSL connection using TLSv1.3 / AEAD-AES256-GCM-SHA384 / [blank] / UNDEF
* ALPN: server accepted h2
* Server certificate:
* subject: CN=test.com
* start date: Jul 30 07:40:58 2025 GMT
* expire date: Jul 6 07:40:58 2125 GMT
* issuer: CN=MyTestCA
* SSL certificate verify result: unable to get local issuer certificate (20), continuing anyway.
* using HTTP/2
* [HTTP/2] [1] OPENED stream for https://test.com:9443/ip
* [HTTP/2] [1] [:method: GET]
* [HTTP/2] [1] [:scheme: https]
* [HTTP/2] [1] [:authority: test.com:9443]
* [HTTP/2] [1] [:path: /ip]
* [HTTP/2] [1] [user-agent: curl/8.6.0]
* [HTTP/2] [1] [accept: */*]
> GET /ip HTTP/2
> Host: test.com:9443
> User-Agent: curl/8.6.0
> Accept: */*
>
< HTTP/2 200
HTTP/2 200
...
{
"origin": "127.0.0.1, 101.44.80.31"
}

注意,API7 网关和客户端在握手过程中成功验证了彼此的证书并建立了连接。

不使用客户端证书​

向 https://test.com:9443/ip 发送请求,但不使用客户端证书。

curl -ikv --resolve "test.com:9443:127.0.0.1" "https://test.com:9443/ip"

由于缺少客户端证书,mTLS 握手应该会失败。

相关阅读​