MySQL 5.7如何配置基于SSL的双向身份验证_生成证书并配置REQUIRE X509

老明君_6089

老明君_6089

2026-05-16

165人浏览

原创

mysql 5.7 支持双向 ssl,但默认关闭;需手动生成无密码私钥、含 subjectaltname 和 clientauth 的证书链,配置 require_secure_transport=on、ssl_ca/cert/key 四项参数,创建用户时用 create user ... require x509,并通过 mysql 命令显式传入 --ssl-mode=required 等参数才能生效。

mysql 5.7如何配置基于ssl的双向身份验证_生成证书并配置require x509

MySQL 5.7 支持双向 SSL,但默认完全关闭;必须手动生成兼容证书、修改 my.cnf、启用强制加密,并在创建用户时用 REQUIRE X509 绑定证书校验逻辑——漏掉任一环节都会导致连接失败或降级为单向验证。

生成 MySQL 5.7 兼容的双向证书链

MySQL 5.7 对证书格式敏感:私钥不能加密(即不能有 passphrase),证书必须含正确 extendedKeyUsage,且服务端证书需带 subjectAltName(否则客户端连接报 ERROR 2026 (HY000): SSL connection error: Certificate verification failed)。

  • CA 根证书必须用 openssl req -x509 生成,不能跳过 -nodes;生成后检查:openssl x509 -in ca.pem -text -noout | grep "CA:" 应显示 CA:TRUE
  • 服务端证书请求必须包含 subjectAltName,推荐用配置文件方式生成(避免命令行遗漏);最小可用配置:
    [req]
    distinguished_name = req_distinguished_name
    x509_extensions = v3_req
    [req_distinguished_name]
    [v3_req]
    subjectAltName = @alt_names
    [alt_names]
    DNS.1 = localhost
    IP.1 = 127.0.0.1
  • 客户端证书必须明确声明 clientAuth:执行 openssl x509 -req -in client-req.pem -CA ca.pem -CAkey ca-key.pem -set_serial 02 -out client-cert.pem -extfile
  • 所有 PEM 文件(ca.pem、server-cert.pem、client-cert.pem、server-key.pem、client-key.pem)属主必须是 mysql 用户,否则 mysqld 启动时静默失败,日志只显示 Failed to set up SSL

my.cnf 中必须设置的 4 个 SSL 配置项

require_secure_transport = ON 是双向验证的“总开关”——它让 MySQL 拒绝任何非 SSL 连接;而 ssl_mode = REQUIRED 只影响客户端行为,对服务端无约束力。两者不可互换。

SSL Certificate Monitor
SSL Certificate Monitor

检查一个或多个域名的 SSL/TLS 证书到期时间、颁发者、协议及 SAN 信息,用于应要求检查证书、监控到期或验证 HTTPS 等场景。

下载
  • require_secure_transport = ON:强制所有连接走 TLS,否则直接拒绝(错误码 ERROR 3159 (HY000))
  • ssl_ca = /etc/mysql/ssl/ca.pem:必须指向包含客户端 CA 的文件;若客户端证书由中间 CA 签发,此处需合并根 CA + 中间 CA
  • ssl_cert = /etc/mysql/ssl/server-cert.pem 和 ssl_key = /etc/mysql/ssl/server-key.pem:路径必须绝对,且私钥不能加密
  • 可选但强烈建议:ssl_crl = /etc/mysql/ssl/crl.pem;不配的话,后续吊销客户端证书将完全无效

CREATE USER 必须带 REQUIRE X509,GRANT 不生效

GRANT ... REQUIRE X509 是无效语法;MySQL 5.7 只认 CREATE USER 或 ALTER USER 语句中的 REQUIRE 子句。权限和证书验证是两套机制,混用会导致“看起来配了,实则没校验”。

  • 正确写法:CREATE USER 'app'@'%' REQUIRE X509; 或更严格地:CREATE USER 'app'@'%' REQUIRE SUBJECT '/CN=app-client/O=myorg';
  • SUBJECT 值必须与 openssl x509 -in client-cert.pem -subject -noout 输出**逐字匹配**,包括空格、大小写、字段顺序;常见坑:OU=dev vs OU=Dev
  • 对已有用户执行 ALTER USER 'app'@'%' REQUIRE X509 会覆盖之前所有 REQUIRE 条件,不是叠加
  • 验证是否生效:SELECT user, host, ssl_type, ssl_cipher FROM mysql.user WHERE user = 'app';,ssl_type 应为 X509

mysql 命令行连接必须显式传参,不读取系统配置

MySQL 客户端不会自动加载 /etc/my.cnf 或环境变量里的 SSL 设置;漏掉任意一个参数,错误信息往往误导人(比如报 Access denied for user,实际是证书未提供或校验失败)。

  • 最小可行命令:mysql --ssl-mode=REQUIRED --ssl-ca=/etc/mysql/ssl/ca.pem --ssl-cert=/etc/mysql/ssl/client-cert.pem --ssl-key=/etc/mysql/ssl/client-key.pem -u app -p
  • --ssl-mode=REQUIRED 不可省略或降级为 PREFERRED;设成 VERIFY_IDENTITY 则还会校验服务端证书 CN 是否匹配连接地址
  • --ssl-cert 和 --ssl-key 必须成对出现;私钥若有密码,mysql 客户端不支持交互输入,连接必然失败
  • 调试技巧:加 --debug-info 查看握手细节,或用 openssl s_client -connect localhost:3306 -cert client-cert.pem -key client-key.pem -CAfile ca.pem 单独测试 TLS 层

最易被忽略的是证书的 extendedKeyUsage 字段和 subjectAltName ——它们不体现在常见 OpenSSL 一键脚本里,但 MySQL 5.7 在握手阶段会严格检查;一旦缺失,错误日志里既不提示具体原因,也不输出证书内容,只能靠 openssl x509 -text 逐个比对。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

mysql ssl require函数

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2313

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1419

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

835

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

3252

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

5528

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1219

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

5791

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

5042

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

6734

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 189人学习