RabbitMQ指南（七） SSL\TLS通信...

三十的狼 2021-04-02

展开全文

RabbitMQ指南（七） SSL\TLS通信

7.1 证书生成和配置

7.2 Java客户端

7.3 C#客户端

7.1 证书生成和配置
　RabbitMQ对外提供服务时，为保证通信的安全性，通常使用SSL/TLS加密通信。
　关于非对称加密、SSL\TLS协议、证书授权中心（Certificate Authority，CA）可参考其他资料，本文仅演示RabbitMQ SSL\TLS通信的具体操作。对于生成证书，本文使用RabbitMQ官网推荐的tls-gen工具，该工具可在MacOS和Linux系统中使用，要求系统中装有openssl和Python 3.5以上版本。
　使用tls-gen生成证书：
# 下载，也可手工从以下网址下载后上传至服务器
git clone https://github.com/michaelklishin/tls-gen tls-gen
cd tls-gen/basic
# 123456是自定义的私钥密码，客户端会用到
make PASSWORD=123456
make verify
make info
1234567
　证书生成完毕后，会在basic目录下生成result、testca、server和client四个文件夹。
　通常使用单向认证的方式进行SSL\TLS通信，所需的文件为：
　（1）CA的证书文件testca/cacert.cer，C#客户端需要信任签名的CA；
　（2）CA证书文件result/ca_certificate.pem，用于服务端配置；
　（3）服务端证书文件result/server_certificate.pem，用于服务端配置；
　（4）服务端私钥文件result/server_key.pem，用于服务端配置；
　（5）客户端证书文件result/client_key.p12，用于客户端。
　在RabbitMQ解压目录的etc/rabbitmq/路径下，加入文件rabbitmq.conf（本文使用新格式配置文件，旧格式相应配置可自行参照官网的示例文件）。该路径为RabbitMQ默认配置文件路径，也可以RABBITMQ_CONFIG_FILE环境变量指定配置文件的路径。
　rabbitmq.conf内容：
# 限定非SSL\TLS的通信仅可在服务端本地连接
listeners.tcp.default = 127.0.0.1:5672
# SSL\TLS通信的端口
listeners.ssl.default = 5671
# 服务端私钥和证书文件配置
ssl_options.cacertfile = /root/tls-gen/basic/result/ca_certificate.pem
ssl_options.certfile = /root/tls-gen/basic/result/server_certificate.pem
ssl_options.keyfile = /root/tls-gen/basic/result/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
123456789101112

7.2 Java客户端
　使用Java提供的keytool工具，将服务端证书server_certificate.pem转换为keystore证书文件：
keytool -import -alias rabbitmqserver -file F:/server_certificate.pem -keystore F:/server.keystore
　其中，“F:/server_certificate.pem”是服务端证书文件路径，“F:/server.keystore”是生成的keystore证书文件的路径。生成文件时要求设置一个密钥库口令，本文设置为“abcdef”。
　Java客户端如下：
import java.io.FileInputStream;
import java.security.KeyStore;

import javax.net.ssl.KeyManagerFactory;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManagerFactory;

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;

public class Sender {

   // RabbitMQ服务端地址、端口、用户名、密码
   private static final String ADDRESS = "10.176.64.227";
   private static final int PORT = 5671;
   private static final String USERNAME = "mqtester";
   private static final String PASSWORD = "mqtester";

   private static final String DEFAULT_EXCHANGE = "";
   private static final String QUEUE_NAME = "Queue_Java";

   // 使用tls-gen工具生成证书文件时设置的私钥密码
   private static final String CLIENT_KEYSTORE_PASSWORD = "123456";
   // 客户端证书文件client_key.p12路径
   private static final String CLIENT_KEYSTORE_PATH = System.getProperty("user.dir") + "\\client_key.p12";
   // 使用keytool生成证书文件时填写的密码
   private static final String SERVER_KEYSTORE_PASSWORD = "abcdef";
   // 使用keytool生成的服务端证书文件路径
   private static final String SERVER_KEYSTORE_PATH = System.getProperty("user.dir") + "\\server.keystore";

   public static void main(String[] args) throws Exception {

       ConnectionFactory factory = new ConnectionFactory();
       factory.setHost(ADDRESS);
       factory.setPort(PORT);
       factory.setUsername(USERNAME);
       factory.setPassword(PASSWORD);

       // 启用SSL\TLS
       KeyStore ks = KeyStore.getInstance("PKCS12");
       ks.load(new FileInputStream(CLIENT_KEYSTORE_PATH), CLIENT_KEYSTORE_PASSWORD.toCharArray());
       KeyManagerFactory kmf = KeyManagerFactory.getInstance("SunX509");
       kmf.init(ks, CLIENT_KEYSTORE_PASSWORD.toCharArray());

       KeyStore tks = KeyStore.getInstance("JKS");
   tks.load(new FileInputStream(SERVER_KEYSTORE_PATH), SERVER_KEYSTORE_PASSWORD.toCharArray());
   TrustManagerFactory tmf = TrustManagerFactory.getInstance("SunX509");
   tmf.init(tks);

       SSLContext ctx = SSLContext.getInstance("TLSv1.2");
       ctx.init(kmf.getKeyManagers(), tmf.getTrustManagers(), null);

       factory.useSslProtocol(ctx);

       // 发送消息，测试连接
       Connection connection = factory.newConnection();
       Channel channel = connection.createChannel();
       channel.queueDeclare(QUEUE_NAME, false, false, false, null);

       byte[] message = ("test message").getBytes();
       channel.basicPublish(DEFAULT_EXCHANGE, QUEUE_NAME, null, message);

       channel.close();
       connection.close();
   }
}
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869

7.3 C#客户端
　由于使用tls-gen生成证书时，是自己作为CA进行签名的，需将CA的证书导入受信任的根证书颁发机构。
　运行“certmgr.msc”：

　将testca/cacert.cer文件导入受信任的根证书颁发机构：

　证书导入后如下：

　C#客户端如下：
public class Sender
{
// RabbitMQ服务端地址、端口、用户名、密码
private const string ADDRESS = "10.176.64.227";
private const int PORT = 5671;
private const string USERNAME = "mqtester";
private const string PASSWORD = "mqtester";

private const string DEFAULT_EXCHANGE = "";
private const string QUEUE_NAME = "Queue_C#";

// 使用tls-gen生成证书的服务器的主机名，该值必须填写正确
private const string SERVER_NAME = "centos7";
// 客户端证书文件client_key.p12路径
private const string CLIENT_CERT_PATH = "F:\\client_key.p12";
// 使用tls-gen工具生成证书文件时设置的私钥密码
private const string CLIENT_CERT_PASSWORD = "123456";

public static void Main(string[] args)
{
var factory = new ConnectionFactory()
{
HostName = ADDRESS,
Port = PORT,
UserName = USERNAME,
Password = PASSWORD,
};
// 启用SSL\TLS
factory.Ssl.ServerName = SERVER_NAME;
factory.Ssl.CertPath = CLIENT_CERT_PATH;
factory.Ssl.CertPassphrase = CLIENT_CERT_PASSWORD;
factory.Ssl.Enabled = true;

// 发送消息，测试连接
using (var connection = factory.CreateConnection())
{
using (var channel = connection.CreateModel())
{
channel.QueueDeclare(QUEUE_NAME, false, false, false, null);
byte[] message = Encoding.UTF8.GetBytes("test message");
channel.BasicPublish(DEFAULT_EXCHANGE, QUEUE_NAME, null, message);
}
}
}
}