第 5 章 保护代理

sslEnabled

指定是否为连接启用 SSL。必须设为 true 才能启用 TLS。默认值为 false。

keyStorePath

在接受者中使用： 指向包含代理证书的代理上的 TLS 密钥存储的路径（无论是自签名还是由颁发机构签名）。

在连接器中使用： 指向包含客户端证书的客户端上的 TLS 密钥存储的路径。只有在使用双向 TLS 时，才会与连接器相关。虽然您可以在代理上配置这个值，但它由客户端下载和使用。如果客户端需要使用代理上设置的不同路径，它可以使用标准的 javax.net.ssl.keyStore 系统属性或特定于 AMQ 的 org.apache.activemq.ssl.keyStore 系统属性来覆盖代理设置。如果客户端上的另一个组件已经使用标准 Java 系统属性，则特定于 AMQ 的系统属性很有用。

keyStorePassword

当用于 acceptor: 代理上的密钥存储的密码时。

在连接器中使用时： 客户端上密钥存储的密码。只有在使用双向 TLS 时，才会与连接器相关。虽然您可以在代理上配置这个值，但它由客户端下载和使用。如果客户端需要使用代理上设置的不同密码，那么它可以使用标准的 javax.net.ssl.keyStorePassword 系统属性或特定于 AMQ 的 org.apache.activemq.ssl.keyStorePassword 系统属性来覆盖代理设置。如果客户端上的另一个组件已经使用标准 Java 系统属性，则特定于 AMQ 的系统属性很有用。

trustStorePath

在 acceptor 中使用： 到代理上 TLS 信任存储的路径，该代理包含代理信任的所有客户端的密钥。只有在您使用双向 TLS 时，这才与接受者相关。

在连接器中使用： 客户端信任的所有代理的公钥的客户端上 TLS 信任存储的路径。虽然您可以在代理上配置这个值，但它由客户端下载和使用。如果客户端需要使用与服务器上设置的不同路径不同，那么它可以使用标准的 javax.net.ssl.trustStore 系统属性或 AMQ-specific org.apache.activemq.ssl.trustStore 系统属性来覆盖服务器端设置。如果客户端上的另一个组件已经使用标准 Java 系统属性，则特定于 AMQ 的系统属性很有用。

trustStorePassword

在 acceptor 中使用时： 代理上信任存储的密码。只有在您使用双向 TLS 时，这才与接受者相关。

在连接器中使用时： 客户端上的信任存储的密码。虽然您可以在代理上配置这个值，但它由客户端下载和使用。如果客户端需要使用代理上设置的不同密码，那么它可以使用标准的 javax.net.ssl.trustStorePassword 系统属性或特定于 AMQ 的 org.apache.activemq.ssl.trustStorePassword 系统属性来覆盖代理设置。如果客户端上的另一个组件已经使用标准 Java 系统属性，则特定于 AMQ 的系统属性很有用。

enabledCipherSuites

用于接受者或连接器的 TLS 通信的、以逗号分隔的密码套件列表。

指定客户端应用程序支持的最安全密码套件。如果您指定了代理和客户端通用的、以逗号分隔的密码套件列表，或者您没有指定任何密码套件，则代理和客户端会相互协商要使用的密码套件。如果您不知道要指定的密码套件，您可以首先与以 debug 模式运行的客户端建立 broker-client 连接，以验证代理和客户端通用的密码套件。然后，在代理上配置 enabledCipherSuites。

可用的密码套件取决于代理和客户端使用的 TLS 协议版本。如果在升级代理后默认 TLS 协议版本有变化，您可能需要选择较早的 TLS 协议版本，以确保代理和客户端可以使用通用密码套件。如需更多信息，请参阅 enabledProtocols。

enabledProtocols

无论是在接收器或连接器上使用的，这是用于 TLS 通信的协议的逗号分隔列表。如果没有指定 TLS 协议版本，代理将使用 JVM 的默认版本。

如果代理为 JVM 使用默认 TLS 协议版本，且该版本在升级代理后发生了变化，则代理和客户端使用的 TLS 协议版本可能会不兼容。虽然建议您使用更新的 TLS 协议版本，但您可以在 enabledProtocols 中指定早期版本，以便与不支持较新的 TLS 协议版本的客户端进行交互。

needClientAuth

此属性仅适用于接收器。它指示客户端连接到需要双向 TLS 的接收器。有效值为 true 或者 false。默认值为 false。