Skip to content

Commit 0147fa3

Browse files
authored
enable-tls-between-clients-and-servers: add TiProxy (#21076) (#21082)
1 parent 2bf3ec0 commit 0147fa3

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

enable-tls-between-clients-and-servers.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ TiDB 服务端支持启用基于 TLS(传输层安全)协议的安全连接
2020
另外,与 MySQL 相同,TiDB 也支持在同一 TCP 端口上开启 TLS 连接或非 TLS 连接。对于开启了 TLS 连接支持的 TiDB 服务端,客户端既可以选择通过加密连接安全地连接到该 TiDB 服务端,也可以选择使用普通的非加密连接。如需使用加密连接,你可以通过以下方式进行配置:
2121

2222
+ 通过配置系统变量 [`require_secure_transport`](/system-variables.md#require_secure_transport-从-v610-版本开始引入) 要求所有用户必须使用加密连接来连接到 TiDB。
23-
+ 通过在创建用户 (`create user`),或修改已有用户 (`alter user`) 时指定 `REQUIRE SSL` 要求指定用户必须使用 TLS 连接来连接 TiDB。以创建用户为例:
23+
+ 通过在创建用户 (`CREATE USER`),或修改已有用户 (`ALTER USER`) 时指定 `REQUIRE SSL` 要求指定用户必须使用 TLS 连接来连接 TiDB。以创建用户为例:
2424

2525
```sql
2626
CREATE USER 'u1'@'%' IDENTIFIED BY 'my_random_password' REQUIRE SSL;
@@ -46,6 +46,10 @@ TiDB 服务端支持启用基于 TLS(传输层安全)协议的安全连接
4646
- 参数指定的文件都为 PEM 格式。另外目前 TiDB 尚不支持加载有密码保护的私钥,因此必须提供一个没有密码的私钥文件。若提供的证书或私钥无效,则 TiDB 服务端将照常启动,但并不支持客户端 TLS 连接到 TiDB 服务端。
4747
- 若证书参数无误,则 TiDB 在启动时将会输出 `mysql protocol server secure connection is enabled``"INFO"` 级别日志中。
4848

49+
## 配置 TiProxy 使用 TLS 连接
50+
51+
如需启用 [TiProxy](/tiproxy/tiproxy-overview.md) 的 TLS 连接支持,可以在 TiProxy 配置文件中指定 [`sql-tls`](/tiproxy/tiproxy-configuration.md#sql-tls) 配置项。关于该配置项的详细说明,以及如何为后端连接启用 TLS,请参考 [TiProxy 安全性](/tiproxy/tiproxy-overview.md#安全)。
52+
4953
## 配置 MySQL Client 使用 TLS 连接
5054

5155
MySQL 5.7 及以上版本自带的客户端默认尝试使用 TLS 连接,若服务端不支持安全连接则自动退回到使用非安全连接;MySQL 5.7 以下版本自带的客户端默认采用非 TLS 连接。
@@ -76,7 +80,7 @@ MySQL 5.7 及以上版本自带的客户端默认尝试使用 TLS 连接,若
7680
默认情况,服务端对客户端的身份验证是可选的。若客户端在 TLS 握手时未出示自己的身份证书,也能正常建立 TLS 连接。但也可以通过在创建用户 (`CREATE USER`) 或修改已有用户 (`ALTER USER`) 时指定 `REQUIRE x509` 要求客户端需进行身份验证,以创建用户为例:
7781

7882
```sql
79-
CREATE USER 'u1'@'%' REQUIRE X509;
83+
CREATE USER 'u1'@'%' REQUIRE X509;
8084
```
8185

8286
> **注意:**

0 commit comments

Comments
 (0)