C# IBMXMSDotnetClient SSL连接IBM MQ报2059错误解决方法

问题根因 #

原有非SSL连接代码可正常运行，启用SSL后返回CompCode: 2, Reason: 2059错误，核心原因是SSL相关参数配置位置错误：XMSC.IC_URL/XMSC.IC_PROVIDER_URL是InitialContext用来查找.bindings文件的参数，和MQ连接的SSL逻辑无关，将密钥库路径配置到该属性完全不生效。

所有SSL连接参数必须配置在从JNDI上下文查找得到的IConnectionFactory实例上，配置完成后再创建连接。

核心配置项 #

• 密钥库配置（客户端证书校验场景必填）
  • XMSC.WMQ_SSL_KEY_STORE：客户端密钥库文件的完整本地路径（直接填.p12/.jks文件全路径，不是目录）
  • XMSC.WMQ_SSL_KEY_STORE_PASSWORD：密钥库对应的访问密码
  • XMSC.WMQ_SSL_KEY_STORE_TYPE：密钥库类型，PKCS12格式（.p12/.pfx）填pkcs12，JKS格式填jks
• 信任库配置（服务端证书为自签证书、双向SSL场景必填）
  • XMSC.WMQ_SSL_TRUST_STORE：信任库文件完整本地路径
  • XMSC.WMQ_SSL_TRUST_STORE_PASSWORD：信任库访问密码
  • XMSC.WMQ_SSL_TRUST_STORE_TYPE：信任库类型，取值同密钥库类型
• SSL密码套件配置（必填）
  • XMSC.WMQ_SSL_CIPHER_SUITE：填写和MQ服务端SVRCONN通道配置完全匹配的密码套件名称，注意C#客户端套件命名和MQ服务端的CIPHERSPEC存在映射关系，必须保持一致，否则会直接握手失败
• 可选配置
  • XMSC.WMQ_SSL_PEER_NAME：如果服务端通道开启了SSLPEER证书DN校验，需要配置该参数为匹配规则
  • 确认连接模式为客户端模式：设置XMSC.WMQ_CONNECTION_MODE为XMSC.WMQ_CM_CLIENT

核心代码示例 #

在原有代码查找到confac对象之后、调用CreateConnection()之前，追加如下配置即可：

// 确认客户端连接模式
confac.SetIntProperty(XMSC.WMQ_CONNECTION_MODE, XMSC.WMQ_CM_CLIENT);
// 配置客户端密钥库
confac.SetStringProperty(XMSC.WMQ_SSL_KEY_STORE, @"C:\certs\client_cert.p12");
confac.SetStringProperty(XMSC.WMQ_SSL_KEY_STORE_PASSWORD, "your_keystore_pwd");
confac.SetStringProperty(XMSC.WMQ_SSL_KEY_STORE_TYPE, "pkcs12");
// 配置信任库（自签/双向SSL场景启用）
confac.SetStringProperty(XMSC.WMQ_SSL_TRUST_STORE, @"C:\certs\trust_store.p12");
confac.SetStringProperty(XMSC.WMQ_SSL_TRUST_STORE_PASSWORD, "your_truststore_pwd");
confac.SetStringProperty(XMSC.WMQ_SSL_TRUST_STORE_TYPE, "pkcs12");
// 配置与服务端一致的密码套件
confac.SetStringProperty(XMSC.WMQ_SSL_CIPHER_SUITE, "TLS_RSA_WITH_AES_128_CBC_SHA256");
// 所有SSL参数配置完成后再创建连接
conn = confac.CreateConnection();

排查提示 #

2059为MQ连接初始化失败通用错误，除SSL配置错误外，还需确认：客户端到MQ服务端SSL监听端口网络连通、服务端SVRCONN通道的SSL配置已生效、客户端使用的IBM XMS版本与MQ服务端版本兼容。

内容的提问来源于stack exchange，提问作者kzfid