# 配置 APISIX 和 etcd 之间的 mTLS

*双向 TLS (mTLS)* 是一种双向 TLS，其中客户端和服务器相互验证身份。它通常用于防止未经授权的访问并加强安全性。

本文档将向你展示如何使用 Docker 化的 APISIX 和 etcd 配置 APISIX 和 etcd 之间的 mTLS。对于不同的部署方法，请相应调整步骤。

## 前置条件[​](#前置条件 "前置条件的直接链接")

* 安装 [Docker](https://docs.docker.com/get-docker)。
* 安装 [cURL](https://curl.se/) 以向服务发送请求进行验证。

## 生成证书和密钥[​](#生成证书和密钥 "生成证书和密钥的直接链接")

创建一个新目录并进入其中：

```
mkdir mtls-apisix-etcd && cd mtls-apisix-etcd
```

生成证书颁发机构 (CA) 密钥和证书：

```
openssl genrsa -out ca.key 2048

openssl req -new -x509 -days 36500 -sha256 \

  -key ca.key \

  -out ca.crt \

  -subj "/CN=ROOTCA" \

  -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")
```

为 etcd 生成密钥和证书签名请求（CSR）：

```
openssl genrsa -out etcd.key 2048

openssl req -new -sha256 \

  -key etcd.key \

  -out etcd.csr \

  -subj "/CN=ETCD" \

  -addext "subjectAltName=DNS:etcd-prod,DNS:localhost,IP:127.0.0.1"
```

使用 CA 证书签署服务器 CSR，生成服务器证书：

```
openssl x509 -req -days 36500 -sha256 \

  -in etcd.csr \

  -CA ca.crt -CAkey ca.key -CAcreateserial \

  -out etcd.crt \

  -extensions v3_req \

  -extfile <(printf "[v3_req]\nbasicConstraints=CA:FALSE\nkeyUsage=digitalSignature,keyEncipherment\nextendedKeyUsage=serverAuth,clientAuth\nsubjectAltName=DNS:etcd-prod,DNS:localhost,IP:127.0.0.1")
```

为客户端生成密钥和证书签名请求（CSR）：

```
openssl genrsa -out client.key 2048

openssl req -new -sha256 \

  -key client.key \

  -out client.csr \

  -subj "/CN=CLIENT"
```

使用 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")
```

CA 签名密钥和原始私钥应仅供所有者访问。创建运行时目录，使其所属组与固定版本 APISIX Ubuntu 镜像中的 `apisix` 用户一致（UID 和 GID 均为 `636`），然后仅复制运行时所需文件，并按运行身份设置权限：

```
chmod 600 ca.key etcd.key client.key

sudo install -d -o root -g 636 -m 750 /opt/mtls-apisix-etcd

sudo install -m 644 ca.crt etcd.crt client.crt /opt/mtls-apisix-etcd

sudo install -o root -g root -m 600 etcd.key /opt/mtls-apisix-etcd

sudo install -o 636 -g 636 -m 640 client.key /opt/mtls-apisix-etcd
```

如果使用其他 APISIX 镜像或运行用户，请将 UID 和 GID `636` 替换为对应身份。不要将 CA 签名密钥复制到运行时目录。

## 配置 mTLS[​](#配置-mtls "配置 mTLS的直接链接")

你将在 Docker 容器中启动 etcd 和 APISIX，并带有 TLS 证书和密钥，以启用两者之间的 mTLS 通信。

为容器创建 Docker 网络：

```
docker network create mtls-apisix-etcd-net
```

### 启动 etcd[​](#启动-etcd "启动 etcd的直接链接")

在 Docker 中启动 etcd 服务器：

```
docker run -d \

  --name etcd-prod \

  --network mtls-apisix-etcd-net \

  -p 2379:2379 \

  -v /opt/mtls-apisix-etcd:/certs:ro \

  gcr.io/etcd-development/etcd:v3.5.32 \

  /usr/local/bin/etcd \

  --client-cert-auth \

  --cert-file /certs/etcd.crt \

  --key-file /certs/etcd.key \

  --trusted-ca-file /certs/ca.crt \

  --name etcd-prod \

  --data-dir /etcd-data \

  --listen-client-urls https://0.0.0.0:2379 \

  --advertise-client-urls https://etcd-prod:2379 \

  --listen-peer-urls http://0.0.0.0:2380 \

  --initial-advertise-peer-urls http://etcd-prod:2380 \

  --initial-cluster etcd-prod=http://etcd-prod:2380
```

❶ 启用客户端证书身份认证。

❷ 设置 etcd TLS 证书的路径。

❸ 设置 etcd TLS 密钥的路径。

❹ 设置受信任 CA 证书的路径。

要验证 etcd 是否已启动且 mTLS 已正确配置，请使用客户端证书和密钥向 etcd 发送请求以获取 etcd 版本：

```
curl -iv --resolve "etcd-prod:2379:127.0.0.1" "https://etcd-prod:2379/version" \

  --cacert ca.crt \

  --cert client.crt --key client.key
```

如果一切正常，你应该看到带有 etcd 版本的 `HTTP/2 200` 响应：

```
{"etcdserver":"3.5.32","etcdcluster":"3.5.0"}
```

使用相同的客户端证书和密钥验证 etcd v3 API：

```
curl -iv --resolve "etcd-prod:2379:127.0.0.1" "https://etcd-prod:2379/v3/kv/put" \

  --cacert ca.crt \

  --cert client.crt \

  --key client.key \

  -H 'Content-Type: application/json' \

  -d '{"key":"a2V5","value":"dmFsdWU="}'
```

如果一切正常，你应该会看到类似以下的 `HTTP/2 200` 响应：

```
{"header":{"cluster_id":"...","member_id":"...","revision":"...","raft_term":"..."}}
```

### 启动 APISIX[​](#启动-apisix "启动 APISIX的直接链接")

以下配置允许能够访问容器的任意来源向 Admin API 发送请求，以便本地示例运行。\*\*仅用于本地验证。\*\*生产环境应将 `0.0.0.0/0` 替换为受信任运维网络的 CIDR 范围，并安全管理 Admin API 密钥。

在 `/opt`（或你选择的目录）中创建一个 APISIX 配置文件：

```
echo 'apisix:

  ssl:

    ssl_trusted_certificate: /usr/local/apisix/certs/ca.crt

deployment:

  role: traditional

  role_traditional:

    config_provider: etcd

  admin:

    admin_key_required: true

    allow_admin:

      - 0.0.0.0/0

    admin_key:

      -

        name: admin

        key: Sup3rs3cretWr1teK3y   # replace with your write key

        role: admin

  etcd:

    host:

      - "https://etcd-prod:2379"

    tls:

      cert: /usr/local/apisix/certs/client.crt

      key: /usr/local/apisix/certs/client.key

' > /opt/config.yaml
```

❶ 在 Docker 容器中设置受信任 CA 证书的路径。

❷ 在 Docker 容器中设置客户端 TLS 证书的路径。

❸ 在 Docker 容器中设置客户端 TLS 密钥的路径。

在 Docker 中启动一个 APISIX 实例：

```
docker run -d \

  --name apisix \

  --network mtls-apisix-etcd-net \

  -p 127.0.0.1:9180:9180 \

  -v /opt/mtls-apisix-etcd:/usr/local/apisix/certs:ro \

  -v /opt/config.yaml:/usr/local/apisix/conf/config.yaml:ro \

  apache/apisix:3.20.0-ubuntu
```

❶ 将主机上的 TLS 证书和密钥目录挂载到 Docker 容器。

❷ 将主机上的 APISIX 配置文件挂载到 Docker 容器。

此端口映射仅将发布的 Admin API 端口绑定到 Docker 宿主机的回环地址，供本地验证。

## 验证 mTLS[​](#验证-mtls "验证 mTLS的直接链接")

要验证 APISIX 是否已启动且 APISIX 和 etcd 之间的 mTLS 已正确配置，请向 APISIX 发送请求以获取所有路由：

```
curl -i "http://127.0.0.1:9180/apisix/admin/routes" -H "X-API-KEY: Sup3rs3cretWr1teK3y"
```

如果成功，你应该看到包含所有 APISIX 路由的 `HTTP/1.1 200 OK` 响应，例如：

```
{"list":[],"total":0}
```
