大网数据广告活动
数据库部署与 SQL 参考

SSL 认证

· 52CE 我爱测

自 v3.4.1 起,StarRocks 支持由 SSL 加密的安全连接。与传统的 DBMS 明文连接不同,SSL 连接提供端点验证和数据加密,确保客户端与 StarRocks 集群之间传输的数据不会被未经授权的用户读取。

SSL 认证

自 v3.4.1 起,StarRocks 支持由 SSL 加密的安全连接。与传统的 DBMS 明文连接不同,SSL 连接提供端点验证和数据加密,确保客户端与 StarRocks 集群之间传输的数据不会被未经授权的用户读取。

启用 SSL 认证

配置 FE 节点

要在 StarRocks 中启用 SSL 认证,需要在 FE 配置文件 fe.conf 中配置以下参数:

  • ssl_keystore_location:指定存储 SSL 证书和密钥的 keystore 文件路径。
  • ssl_keystore_type:keystore 类型。默认值为空,表示 StarRocks 自动识别 JKS 和 PKCS12。如需使用 BCFKS 等格式,需要显式配置该参数。
  • ssl_keystore_provider:用于加载 keystore 的安全 provider。该参数为可选项。
  • ssl_keystore_password:keystore 文件的访问密码,StarRocks 读取 keystore 文件时需要提供该密码。
  • ssl_key_password:密钥的访问密码,StarRocks 读取 keystore 文件中的密钥时需要提供该密码。
  • ssl_truststore_location:指定 truststore 文件路径。该参数为可选项。
  • ssl_truststore_type:MySQL SSL 使用的 truststore 类型。默认值为空,表示 StarRocks 自动识别 JKS 和 PKCS12。如需使用 BCFKS 等格式,需要显式配置该参数。
  • ssl_truststore_provider:用于加载 MySQL SSL truststore 的安全 provider。该参数为可选项。
  • ssl_truststore_password:truststore 文件的访问密码。配置 ssl_truststore_location 时需要配置该参数。
  • ssl_security_provider_class:加载 keystore 或 truststore 前需要注册的安全 provider 类。该参数为可选项。
  • ssl_security_provider_name:期望的 provider 名称。该参数为可选项。
  • ssl_security_provider_path:provider JAR 路径。该参数为可选项。如果 provider JAR 已添加到 FE classpath 中,则无需配置该参数。
  • ssl_force_secure_transport: 是否强制启用 SSL 认证,默认为 FALSE。如设置为 TRUE,则系统会拒绝未通过 SSL 加密的连接。

示例:

ssl_keystore_location = // keystore 文件的路径
ssl_keystore_type =
ssl_keystore_password = // keystore 文件的密码
ssl_key_password = // 密钥的密码

如果需要使用 Bouncy Castle FIPS provider 加载 BCFKS 格式的 keystore 和 truststore,可以将 provider JAR 放入 FE classpath,例如 $STARROCKS_HOME/lib,或配置 ssl_security_provider_path,然后添加如下配置。这些参数只用于配置 keystore 和 truststore 的加载方式,本身不保证 TLS engine 使用经过 FIPS 验证的 JSSE provider。

ssl_keystore_location = /path/to/starrocks-keystore.bcfks
ssl_keystore_type = BCFKS
ssl_keystore_provider = BCFIPS
ssl_keystore_password = // keystore 文件的密码
ssl_key_password = // 密钥的密码

ssl_truststore_location = /path/to/starrocks-truststore.bcfks
ssl_truststore_type = BCFKS
ssl_truststore_provider = BCFIPS
ssl_truststore_password = // truststore 文件的密码

ssl_security_provider_class = org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider
ssl_security_provider_name = BCFIPS
ssl_security_provider_path = /path/to/bc-fips.jar

生成 SSL 证书

在生产环境中,建议使用认证机构颁发的证书。

在开发环境中,可以使用自定义的 SSL 证书。您可以使用以下命令生成自定义 SSL 证书:

keytool -genkeypair -alias starrocks \
    -keypass <ssl_key_password> \
    -keyalg RSA -keysize 1024 -validity 365 \
    -keystore <ssl_keystore_location> \
    -storepass <ssl_keystore_password>

参数说明:

  • -keypass:密钥密码,对应 fe.conf 中的 ssl_key_password。
  • -keystore:指定 keystore 文件的存储路径,对应 fe.conf 中的 ssl_keystore_location。示例:/path/to/starrocks.jks。
  • -storepass:keystore 文件的访问密码,对应 fe.conf 中的 ssl_keystore_password。

客户端开启 SSL 认证

StarRocks 兼容 MySQL 协议。对于 MySQL 客户端,SSL 认证默认启用。

对于 JDBC 连接,需要添加以下选项:

useSSL=true
verifyServerCertificate=false

关闭 SSL 认证

如需关闭 SSL 认证,需执行以下操作:

  • MySQL 客户端:需添加选项 --ssl-mode=DISABLED。
  • JDBC 客户端:需移除 useSSL=true 和 verifyServerCertificate=false。

LDAP 认证

LDAP 认证的配置方法已在官方文档 设置用户认证 中介绍。

对于 JDBC 连接,由于 StarRocks 已支持 SSL 认证,无需自定义 AuthPlugin,可直接使用 JDBC 提供的 MysqlClearPasswordPlugin。

  • 基于 JDBC 5 版本使用 LDAP 认证时,需要添加以下配置:

    authenticationPlugins: com.mysql.jdbc.authentication.MysqlClearPasswordPlugin
    defaultAuthenticationPlugin: com.mysql.jdbc.authentication.MysqlClearPasswordPlugin
    disabledAuthenticationPlugins: com.mysql.jdbc.authentication.MysqlNativePasswordPlugin
    
  • 基于 JDBC 8 版本使用 LDAP 认证时,需要添加以下配置:

    authenticationPlugins: com.mysql.cj.protocol.a.authentication.MysqlClearPasswordPlugin
    defaultAuthenticationPlugin: com.mysql.cj.protocol.a.authentication.MysqlClearPasswordPlugin
    disabledAuthenticationPlugins: com.mysql.cj.protocol.a.authentication.MysqlNativePasswordPlugin
    

FAQ

Q1: 使用 DBeaver 连接 StarRocks 时返回错误 “Unable to load authentication plugin 'mysql_native_password'”

A: 需要将 JDBC 5 升级至 5.1.46 及以上版本。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。