TiDB Data Migration 生成自签名证书

TiDB Data Migration 生成自签名证书

本文档提供使用 openssl 为 TiDB Data Migration (DM) 生成自签名证书的一个示例，你也可以根据自己的需求生成符合要求的证书和密钥。

假设实例集群拓扑如下：

Name	Host IP	Services
node1	172.16.10.11	DM-master1
node2	172.16.10.12	DM-master2
node3	172.16.10.13	DM-master3
node4	172.16.10.14	DM-worker1
node5	172.16.10.15	DM-worker2
node6	172.16.10.16	DM-worker3

安装 OpenSSL

对于 Debian 或 Ubuntu 操作系统：

apt install openssl

对于 RedHat 或 CentOS 操作系统：

yum install openssl

也可以参考 OpenSSL 官方的下载文档进行安装。

生成 CA 证书

CA 的作用是签发证书。实际情况中，请联系你的管理员签发证书或者使用信任的 CA 机构。CA 会管理多个证书对，这里只需生成原始的一对证书，步骤如下：

生成 CA 密钥：
```
openssl genrsa -out ca-key.pem 4096
```

生成 CA 证书：

openssl req -new -x509 -days 1000 -key ca-key.pem -out ca.pem

验证 CA 证书：
```
openssl x509 -text -in ca.pem -noout
```

签发各个组件的证书

集群中可能使用到的证书

master certificate 由 DM-master 使用，为其他组件验证 DM-master 身份。
worker certificate 由 DM-worker 使用，为其他组件验证 DM-worker 身份。
client certificate 由 dmctl 使用，用于 DM-master、DM-worker 验证客户端。

为 DM-master 签发证书

给 DM-master 实例签发证书的步骤如下：

生成该证书对应的私钥：
```
openssl genrsa -out master-key.pem 2048
```
拷贝一份 OpenSSL 的配置模板文件。

模板文件可能存在多个位置，请以实际位置为准：
```
cp /usr/lib/ssl/openssl.cnf .
```
如果不知道实际位置，请在根目录下查找：
```
find / -name openssl.cnf
```
编辑 openssl.cnf，在 [ req ] 字段下加入 req_extensions = v3_req，然后在 [ v3_req ] 字段下加入 subjectAltName = @alt_names。最后新建一个字段，根据前述的集群拓扑编辑 Subject Alternative Name (SAN) 的信息：
```
[ alt_names ]
IP.1 = 127.0.0.1
IP.2 = 172.16.10.11
IP.3 = 172.16.10.12
IP.4 = 172.16.10.13
```
目前支持以下 SAN 检查项：
- IP
- DNS
- URI
注意

如果要使用 0.0.0.0 等特殊 IP 用于连接通讯，也需要将其加入到 alt_names 中。
保存 openssl.cnf 文件后，生成证书请求文件（在这一步中提供 Common Name (e.g. server FQDN or YOUR name) []: 输入时，可以为该证书指定 Common Name (CN)，如 dm。其作用是让服务端验证接入的客户端的身份，各个组件默认不会开启验证，需要在配置文件中启用该功能才生效）：
```
openssl req -new -key master-key.pem -out master-cert.pem -config openssl.cnf
```

签发生成证书：

openssl x509 -req -days 365 -CA ca.pem -CAkey ca-key.pem -CAcreateserial -in master-cert.pem -out master-cert.pem -extensions v3_req -extfile openssl.cnf

验证证书携带 SAN 字段信息（可选）：
```
openssl x509 -text -in master-cert.pem -noout
```
确认在当前目录下得到如下文件：
```
ca.pem
master-cert.pem
master-key.pem
```

注意

为 DM-worker 组件签发证书的过程类似，此文档不再赘述。

为 dmctl 签发证书

为客户端签发证书的步骤如下。

生成该证书对应的私钥：
```
openssl genrsa -out client-key.pem 2048
```
生成证书请求文件（在这一步也可以为该证书指定 Common Name，其作用是让服务端验证接入的客户端的身份，默认不会开启对各个组件的验证，需要在配置文件中启用该功能才生效）
```
openssl req -new -key client-key.pem -out client-cert.pem
```

签发生成证书：

openssl x509 -req -days 365 -CA ca.pem -CAkey ca-key.pem -CAcreateserial -in client-cert.pem -out client-cert.pem