RabbitMQ開啟SSL與SpringBoot連接測試的配置方法

更新時間：2022年01月08日 09:11:55 作者：東北小狐貍

本文基于 CentOS 7 + Git + OpenSSL + yum 安裝的 RabbitMQ，需要讀者提交安裝好。其他方式也可變通參考本文。對RabbitMQ開啟SSL與SpringBoot連接測試相關(guān)知識感興趣的朋友一起看看吧

楔子

近期公司程序被安全掃描出 遠(yuǎn)程主機允許明文身份驗證 中風(fēng)險漏洞，查了下修復(fù)方案，RabbitMQ官方提供了SSL連接方式，而且 SpringBoot AMQP 也支持 SSL 連接。以下將配置RabbitMQ開啟SSL 并使用 SpringBoot Demo 測試連接。

PS : 寫文章時此配置還未安全掃描復(fù)測，如果測試通過，本人將更新此文章狀態(tài)為驗證通過。

配置 RabbitMQ 開啟 SSL

本文基于 CentOS 7 + Git + OpenSSL + yum 安裝的 RabbitMQ，需要讀者提交安裝好。其他方式也可變通參考本文。

生成證書

#克隆生成證書的倉庫到當(dāng)前目錄
git clone --depth 1 https://github.com/Berico-Technologies/CMF-AMQP-Configuration.git
cd CMF-AMQP-Configuration/ssl
#生成ca證書，“MyRabbitMQCA”為自定義名稱，名稱任意。在當(dāng)前目錄下生成ca目錄
sh setup_ca.sh MyRabbitMQCA
#生成服務(wù)端證書，第一個參數(shù)是服務(wù)端證書前綴，第二個參數(shù)是密碼。密碼任意，在當(dāng)前目錄下生成server目錄
sh make_server_cert.sh rabbitmq-server 123456
#生成客戶端證書，第一個參數(shù)是客戶端證書前綴，第二個參數(shù)是密碼。密碼任意，在當(dāng)前目錄下生成client目錄
sh create_client_cert.sh rabbitmq-client 654321

配置 RabbitMQ 服務(wù)端的證書如下：

ca/cacert.pem #CA證書
server/rabbitmq-server.cert.pem #服務(wù)端公鑰
server/rabbitmq-server.key.pem  #服務(wù)端私鑰

使用 RabbitMQ 服務(wù)端公鑰證書生成 JKS 證書

# -alias后為別稱，-file后是服務(wù)端公鑰位置，-keystore后是輸出JSK證書位置，此處相對路徑
keytool -import -alias rabbitmq-server \
  -file server/rabbitmq-server.cert.pem \
  -keystore rabbitmqTrustStore -storepass changeit
#輸入y回車

配置 RabbitMQ 客戶端的證書如下：

client/rabbitmq-client.keycert.p12 #PKCS12證書，包含客戶端所需公私鑰及中間證書
rabbitmqTrustStore #服務(wù)端JKS格式公鑰

默認(rèn) RabbitMQ 配置目錄在 /etc/rabbitmq，我們創(chuàng)建個證書目錄存放服務(wù)端證書

mkdir -p /etc/rabbitmq/ssl
#復(fù)制服務(wù)端必要證書
cp ca/cacert.pem \
server/rabbitmq-server.cert.pem \
server/rabbitmq-server.key.pem /etc/rabbitmq/ssl/

修改 RabbitMQ 配置文件

修改 RabbitMQ 配置文件 /etc/rabbitmq/rabbitmq.config，此文件默認(rèn)不存在，需要手動創(chuàng)建

[{rabbit, [
{ssl_listeners, [5671]},
{ssl_options, [
{cacertfile, "/etc/rabbitmq/ssl/cacert.pem"},
{certfile, "/etc/rabbitmq/ssl/rabbitmq-server.cert.pem"},
{keyfile, "/etc/rabbitmq/ssl/rabbitmq-server.key.pem"},
{verify, verify_peer},
{fail_if_no_peer_cert, true},
{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"
]}
]}
]}].

主要配置項說明：

ssl_listeners 指定 SSL協(xié)議的端口號，官方文檔 5671
ssl_options SSL 認(rèn)證配置項
cacertfile CA 證書位置
certfile 公鑰證書位置
keyfile 密鑰證書位置
verify
verify_peer 客戶端與服務(wù)端互相發(fā)送證書
verify_none 禁用證書交換與校驗
fail_if_no_peer_cert
true 不接受沒證書的客戶端連接
false 接受沒證書的客戶端連接
ciphers 加密器（這個翻譯不知道算不算對？）

重啟 RabbitMQ

#關(guān)閉
rabbitmqctl stop
#啟動
rabbitmq-server -detached

驗證開啟 SSL 是否成功

使用 Rabbitmq 自帶的診斷工具查看端口監(jiān)聽狀態(tài)及使用協(xié)議

#查看監(jiān)聽
rabbitmq-diagnostics listeners
#查看支持的TLS版本
rabbitmq-diagnostics --silent tls_versions

使用 OpenSSL CLI 工具驗證證書是否有效

cd 生成證書的ssl目錄
#使用客戶端證書+CA證書連接RabbitMQ驗證。本處MQ與生成證書是同一主機，其他情況請自行考慮。
openssl s_client -connect localhost:5671 \
  -cert client/rabbitmq-client.cert.pem \
  -key client/rabbitmq-client.key.pem \
  -CAfile ca/cacert.pem

除了命令行查看外，還可以通過管理界面查看，不過只能確定開啟了 SSL 監(jiān)聽，無法確認(rèn)證書是否通過驗證。

編寫 SpringBoot 代碼連接測試

代碼結(jié)構(gòu)

只是使用 start.spring.io 生成的 Maven 工程，依賴了 WEB 和 AMQP

代碼及配置

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.5.8</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.example</groupId>
	<artifactId>demo</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>demo</name>
	<description>Demo project for Spring Boot</description>
	<properties>
		<java.version>1.8</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-amqp</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.amqp</groupId>
			<artifactId>spring-rabbit-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

啟動類 DemoApplication.java

package com.hellxz.rabbitmq.ssl;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

RabbitMQ客戶端配置類 RabbitFanoutExchangeConfig.java

package com.hellxz.rabbitmq.ssl;
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.FanoutExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class RabbitFanoutExchangeConfig {
    public static final String FANOUT_EXCHANGE = "fanout.exchange";
    public static final String FANOUT_QUEUE1 = "fanout.queue1";
    @Bean(name = FANOUT_EXCHANGE)
    public FanoutExchange fanoutExchange() {
        return new FanoutExchange(FANOUT_EXCHANGE, true, false);
    }
    @Bean(name = FANOUT_QUEUE1)
    public Queue fanoutQueue1() {
        return new Queue(FANOUT_QUEUE1, true, false, false);
    }
    
    @Bean
    public Binding bindingSimpleQueue1(@Qualifier(FANOUT_QUEUE1) Queue fanoutQueue1,
                                       @Qualifier(FANOUT_EXCHANGE) FanoutExchange fanoutExchange) {
        return BindingBuilder.bind(fanoutQueue1).to(fanoutExchange);
    }
}

發(fā)消息測試類 TestController.java

package com.hellxz.rabbitmq.ssl;
import org.springframework.amqp.core.Message;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class TestController {
    @Autowired
    RabbitMQSenderService rabbitMQSenderService;
    
    @GetMapping("/test")
    public void sendMsg() {
        Message msg = new Message("hello world".getBytes());
        try {
            rabbitMQSenderService.send(RabbitFanoutExchangeConfig.FANOUT_EXCHANGE,
                    RabbitFanoutExchangeConfig.FANOUT_QUEUE1, msg);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

發(fā)消息服務(wù) RabbitMQSenderService.java

package com.hellxz.rabbitmq.ssl;
import java.util.UUID;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
@Component
public class RabbitMQSenderService {
    @Autowired
    private RabbitTemplate rabbitTemplate;
    public void send(String exchange, String routingkey, Message message) {
        CorrelationData correlationId = new CorrelationData(UUID.randomUUID().toString());
        System.out.println("start send msg : " + message);
        rabbitTemplate.convertAndSend(exchange, routingkey, message, correlationId);
        System.out.println("end send msg : " + message);
    }
}

消息接收者 RabbitMQReciver.java

package com.hellxz.rabbitmq.ssl;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
@Component
class RabbitMQReciver {
    @RabbitListener(queues = RabbitFanoutExchangeConfig.FANOUT_QUEUE1)
    public void reciveLogAll(String msg) throws Exception {
        System.out.println("received msg:" + msg);
    }
}

配置文件 application.properties

server.port=8085
#基礎(chǔ)配置請根據(jù)實際配置
spring.rabbitmq.host=192.168.56.104
#ssl協(xié)議端口
spring.rabbitmq.port=5671
spring.rabbitmq.username=admin
spring.rabbitmq.password=123456
spring.rabbitmq.virtual-host=/
#啟用rabbitmq客戶端SSL連接
spring.rabbitmq.ssl.enabled=true
#客戶端PKCS12證書及密碼
spring.rabbitmq.ssl.key-store=classpath:ssl/rabbitmq-client.keycert.p12
spring.rabbitmq.ssl.key-store-password=654321
#公鑰證書及類型
spring.rabbitmq.ssl.trust-store=classpath:ssl/rabbitmqTrustStore
spring.rabbitmq.ssl.trust-store-type=JKS
#不校驗主機名，默認(rèn)開啟會導(dǎo)致連接失敗
spring.rabbitmq.ssl.verify-hostname=false

src/main/resources 下創(chuàng)建 ssl 目錄，將客戶端證書和服務(wù)端JKS公鑰復(fù)制到 ssl 目錄中。

執(zhí)行代碼驗證

運行 DemoApplication.java，查看控制臺是否有報錯：