Skip to content

Commit 8d433c6

Browse files
committed
document TLS SAN requirement
1 parent ba2b3dc commit 8d433c6

2 files changed

Lines changed: 4 additions & 0 deletions

File tree

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@ Enable TLS by calling `SetUseSsl(true)`. The C# client uses the .NET certificate
7474
| `client.truststore` | Java client truststore; the C# client uses `ca.crt` instead |
7575
| `server.truststore` | Server-side truststore for trusting client certificates; not a C# client option |
7676

77+
When `RootCertificatePath` is set, `Host` / `DataSource` must match the server certificate SAN. If you connect by IP address, the server certificate must include the corresponding IP SAN.
78+
7779
Only convert the keystore first if you are reusing an older JKS file, or if it was explicitly generated with `-storetype JKS`:
7880

7981
```bash

README_ZH.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,8 @@ dotnet add package Apache.IoTDB
7272
| `client.truststore` | Java 客户端的 truststore;C# 侧用 `ca.crt`,不需要这个文件 |
7373
| `server.truststore` | 服务端用于信任客户端证书,不是 C# 客户端参数 |
7474

75+
配置 `RootCertificatePath` 后,`Host` / `DataSource` 必须匹配服务端证书 SAN。如果使用 IP 地址连接,服务端证书需要包含对应的 IP SAN。
76+
7577
只有在复用旧版 JDK 生成的 JKS 文件,或显式使用 `-storetype JKS` 生成 keystore 时,才需要先转换为 PKCS#12
7678

7779
```bash

0 commit comments

Comments
 (0)