RabbitMQ要对外提供服务,考虑到安全性,配置SSL进行访问,ssl端口5671,内部仍然使用5672进行访问,两者同时兼容。
安装环境
- CentOS 7.5
- Docker 1.13.1
- Git 1.8.3
- jdk 1.8
- RabbitMQ镜像,rabbitmq:management
证书
RabbitMQ也提供了获取证书的方案,但是使用过程中出现错误,未来得及进行解决,在github上查找到一个项目可以生成证书,遂使用之。
安装git
要从github上将项目克隆下来,需要有git环境,安装步骤如下
# yum安装git
$ yum -y install git
# 配置邮箱以及账号
$ git config --global user.name = 'xxx'
$ git config --global user.email = 'xxx'
# 查看git配置
$ git config --list
生成证书
1.从github上克隆项目
$ git clone https://github.com/Berico-Technologies/CMF-AMQP-Configuration.git
2.下载完成后,进入CMF-AMQP-Configuration/ssl/目录
$ cd CMF-AMQP-Configuration/ssl/
3.生成证书签发机构
$ sh setup_ca.sh xxx
xxx为自定义的证书签发机构名称,该脚本会在当前目录下生成一个ca目录,存储证书颁发机构的信息以及已经签发的一些证书
执行脚本后的ca目录如下所示
4.生成服务端公钥和私钥
$ sh make_server_cert.sh rabbit-server 123456
注释:
rabbit-server:生成的密钥前缀名,自定义
123456: 访问该密钥的密码,自定义
执行该脚本后,在当前目录生成server目录,存储服务端公钥和私钥,如下所示
5.生成客户端公钥和私钥
$ sh create_client_cert.sh rabbit-client 123456
注释:
rabbit-client:生成的密钥前缀名,自定义。
123456: 访问该密钥的密码,自定义。
执行该脚本后,在当前目录下生成client目录,存储客户端公钥和私钥,如下所示
6.生成客户端需要的证书
使用java的keytool工具生成客户端需要的证书,用以支持服务端和客户端进行通信,生成该证书需要提前安装配置java环境,此处默认已正确安装java环境,不会安装的可以参考本人博客
$ keytool -import -alias rabbit-server -file server/rabbit-server.cert.pem -keystore rabbitStore -storepass 123456
注释:
-import 将已签名数字证书导入密钥库
-alias xxx 指定导入条目的别名
-file server/rabbit-server.cert.pem 需要导入的证书
-keystore xxx 指定密钥库的名称
-storepass xxx 指定密钥库的密码(获取keystore信息所需的密码)
经过以上6个步骤,我们一共生成了3个文件夹以及1个文件,分别是server/,client/,ca/以及rabbitStore证书,只要以上几个文件都存在,那么就表示生成证书成。
安装RabbitMQ并配置SSL
1.拉取management版本的镜像
$ docker pull rabbitmq:management
2.先使用以下命令启动容器
$ docker run --restart=unless-stopped -d -p 5672:5672 -p 15672:15672 --name rabbitmq rabbitmq:management
3.创建文件夹
在宿主机上创建以下文件夹
$ mkdir -p /etc/rabbitmq/ssl
4.拷贝容器中的文件到/etc/rabbitmq/目录下
$ docker cp rabbitmq:/etc/rabbitmq/conf.d /etc/rabbitmq/
$ docker cp rabbitmq:/etc/rabbitmq/enabled_plugins /etc/rabbitmq/
$ docker cp rabbitmq:/etc/rabbitmq/rabbitmq.conf /etc/rabbitmq/
5.拷贝生成的证书到/etc/rabbitmq/ssl/目录下
在./CMF-AMQP-Configuration/ssl/目录下执行以下命令
$ cp -r ca server client rabbitStore /etc/rabbitmq/ssl
6.编辑/etc/rabbitmq/rabbitmq.conf文件,输入以下内容
# SSL\TLS通信的端口
listeners.ssl.default=5671
# 服务端私钥和证书文件配置
ssl_options.cacertfile=/etc/rabbitmq/ssl/ca/cacert.pem
ssl_options.certfile=/etc/rabbitmq/ssl/server/rabbit-server.cert.pem
ssl_options.keyfile=/etc/rabbitmq/ssl/server/rabbit-server.key.pem
# 有verify_none和verify_peer两个选项,verify_none表示完全忽略验证证书的结果,verify_peer表示要求验证对方证书
ssl_options.verify=verify_peer
# 若为true,服务端会向客户端索要证书,若客户端无证书则中止SSL握手;若为false,则客户端没有证书时依然可完成SSL握手
ssl_options.fail_if_no_peer_cert=true
ssl_options.versions.1=tlsv1.2
ssl_options.versions.2=tlsv1.1
ssl_options.ciphers.1 = ECDHE-ECDSA-AES256-GCM-SHA384
ssl_options.ciphers.2 = ECDHE-RSA-AES256-GCM-SHA384
ssl_options.ciphers.3 = ECDHE-ECDSA-AES256-SHA384
ssl_options.ciphers.4 = ECDHE-RSA-AES256-SHA384
ssl_options.ciphers.5 = ECDHE-ECDSA-DES-CBC3-SHA
ssl_options.ciphers.6 = ECDH-ECDSA-AES256-GCM-SHA384
ssl_options.ciphers.7 = ECDH-RSA-AES256-GCM-SHA384
ssl_options.ciphers.8 = ECDH-ECDSA-AES256-SHA384
ssl_options.ciphers.9 = ECDH-RSA-AES256-SHA384
ssl_options.ciphers.10 = DHE-DSS-AES256-GCM-SHA384
ssl_options.ciphers.11= DHE-DSS-AES256-SHA256
ssl_options.ciphers.12 = AES256-GCM-SHA384
ssl_options.ciphers.13 = AES256-SHA256
ssl_options.ciphers.14 = ECDHE-ECDSA-AES128-GCM-SHA256
ssl_options.ciphers.15 = ECDHE-RSA-AES128-GCM-SHA256
ssl_options.ciphers.16 = ECDHE-ECDSA-AES128-SHA256
ssl_options.ciphers.17 = ECDHE-RSA-AES128-SHA256
ssl_options.ciphers.18 = ECDH-ECDSA-AES128-GCM-SHA256
ssl_options.ciphers.19= ECDH-RSA-AES128-GCM-SHA256
ssl_options.ciphers.20 = ECDH-ECDSA-AES128-SHA256
ssl_options.ciphers.21 = ECDH-RSA-AES128-SHA256
ssl_options.ciphers.22 = DHE-DSS-AES128-GCM-SHA256
ssl_options.ciphers.23 = DHE-DSS-AES128-SHA256
ssl_options.ciphers.24 = AES128-GCM-SHA256
ssl_options.ciphers.25 = AES128-SHA256
ssl_options.ciphers.26 = ECDHE-ECDSA-AES256-SHA
ssl_options.ciphers.27 = ECDHE-RSA-AES256-SHA
ssl_options.ciphers.28 = DHE-DSS-AES256-SHA
ssl_options.ciphers.29 = ECDH-ECDSA-AES256-SHA
ssl_options.ciphers.30 = ECDH-RSA-AES256-SHA
ssl_options.ciphers.31= AES256-SHA
ssl_options.ciphers.32 = ECDHE-ECDSA-AES128-SHA
ssl_options.ciphers.33 = ECDHE-RSA-AES128-SHA
ssl_options.ciphers.34 = DHE-DSS-AES128-SHA
ssl_options.ciphers.35 = DHE-DSS-AES128-SHA256
ssl_options.ciphers.36 = ECDH-ECDSA-AES128-SHA
ssl_options.ciphers.37 = ECDH-RSA-AES128-SHA
ssl_options.ciphers.38 = AES128-SHA
注释:
rabbitmq.conf文件中原有的内容可以直接删除掉,也可以保留,不影响
也可以不使用上述的rabbitmq.conf文件,而使用rabbitmq.config文件,不过后者需要自己创建,且不可以和rabbitmq.conf共存,RabbitMQ3.7版本以后,推荐使用rabbitmq.conf,因此如果要使用rabbitmq.config,需要先创建,再写入内容
# 创建rabbitmq.config文件
$ vim rabbitmq.config
# 输入以下内容保存
%%Disable SSLv3.0 and TLSv1.0 support.
[
{ssl, [{versions, ['tlsv1.2', 'tlsv1.1']}]},
{rabbit, [
{tcp_listeners, [5672]},
{ssl_listeners, [5671]},
{ssl_options, [{cacertfile,"/etc/rabbitmq/ssl/ca/cacert.pem"},
{certfile,"/etc/rabbitmq/ssl/server/rabbit-server.cert.pem"},
{keyfile,"/etc/rabbitmq/ssl/server/rabbit-server.key.pem"},
{verify, verify_peer},
{ciphers, ["ECDHE-ECDSA-AES256-GCM-SHA384","ECDHE-RSA-AES256-GCM-SHA384",
"ECDHE-ECDSA-AES256-SHA384","ECDHE-RSA-AES256-SHA384", "ECDHE-ECDSA-DES-CBC3-SHA",
"ECDH-ECDSA-AES256-GCM-SHA384","ECDH-RSA-AES256-GCM-SHA384","ECDH-ECDSA-AES256-SHA384",
"ECDH-RSA-AES256-SHA384","DHE-DSS-AES256-GCM-SHA384","DHE-DSS-AES256-SHA256",
"AES256-GCM-SHA384","AES256-SHA256","ECDHE-ECDSA-AES128-GCM-SHA256",
"ECDHE-RSA-AES128-GCM-SHA256","ECDHE-ECDSA-AES128-SHA256","ECDHE-RSA-AES128-SHA256",
"ECDH-ECDSA-AES128-GCM-SHA256","ECDH-RSA-AES128-GCM-SHA256","ECDH-ECDSA-AES128-SHA256",
"ECDH-RSA-AES128-SHA256","DHE-DSS-AES128-GCM-SHA256","DHE-DSS-AES128-SHA256",
"AES128-GCM-SHA256","AES128-SHA256","ECDHE-ECDSA-AES256-SHA",
"ECDHE-RSA-AES256-SHA","DHE-DSS-AES256-SHA","ECDH-ECDSA-AES256-SHA",
"ECDH-RSA-AES256-SHA","AES256-SHA","ECDHE-ECDSA-AES128-SHA",
"ECDHE-RSA-AES128-SHA","DHE-DSS-AES128-SHA","ECDH-ECDSA-AES128-SHA",
"ECDH-RSA-AES128-SHA","AES128-SHA"]},
{honor_cipher_order, true},
{fail_if_no_peer_cert, true},
{versions, ['tlsv1.2', 'tlsv1.1']}
]},
{auth_mechanisms,['PLAIN', 'AMQPLAIN', 'EXTERNAL']}
]}
].
注释:
rabbitmq.conf和rabbitmq.config任选其一即可,个人认为前者可读性更好一些,但是编写的内容相对较多一些
7.删除前面创建的rabbitmq容器,重新创建
使用以下命令重新创建rabbitmq容器,添加5671端口映射以及/etc/rabbitmq/文件夹的挂载
$ docker run --restart=unless-stopped -d \
-p 5672:5672 -p 15672:15672 -p 5671:5671 \
-v /etc/rabbitmq/:/etc/rabbitmq/ \
--name rabbitmq \
rabbitmq:management
8.验证5671端口
使用以下命令查看rabbitmq容器启动时的日志
$ docker logs -f rabbitmq
看到日志中出现以下内容表示配置成功
9.创建可以远程访问的用户
由于guest用户只能本地访问,因此需要创建一个可以远程访问的用户
# 进入容器内部
$ docker exec -it rabbitmq bash
# 创建一个用户名为admin,密码为123456的用户
$ rabbitmqctl add_user admin 123456
# 设置用户权限为超级管理员
$ rabbitmqctl set_user_tags admin administrator
# 授权远程访问
$ rabbitmqctl set_permissions -p / admin "." "." ".*"
# 退出容器
$ exit
# 重启rabbitmq
$ docker restart rabbitmq
10.访问管理页面
此时可以使用上面创建的admin用户远程访问管理页面,地址为http://ip:15672
进入之后可以通过如下方式确认ssl是否配置成功
SpringBoot集成SSL
此处只给出配置ssl的部分,springboot集成rabbitmq的方法可以参考本人博客
spring:
rabbitmq:
addresses: 192.168.216.129:5671
username: admin
password: 123456
virtual-host: /
ssl:
enabled: true
key-store: classpath:keyStore/129/rabbit-client.keycert.p12
key-store-password: 123456
trust-store: classpath:keyStore/129/rabbitStore
trust-store-password: 123456
algorithm: TLSv1.2
trust-store-type: JKS
key-store-type: PKCS12
validate-server-certificate: true
verify-hostname: false
注释:
addresses: 192.168.216.129:5671 ssl使用的是5671的端口,如果不使用ssl还可以使用5672端口
ssl.enabled 是否启用ssl,默认false
key-store: 客户端证书的存储路径,前面已经生成,直接拷贝过来即可
key-store-password: 生成客户端证书的密码
trust-store: 信任证书的存储路径,前面已经生成,直接拷贝过来即可
trust-store-password:生成证书的密码
verify-hostname:是否验证hostname,默认是true,需要设置为false,否则启动报错(No subject alternative names present),原因是证书中定义的common name和程序运行的机器的domain不匹配,这个感觉没有必要纠结,直接设置为false即可。
参考文档
1.RabbitMQ 配置 SSL/TSL
2.RMQ的SSL配置最佳实践