5.2.3. 配置基于证书的身份验证
Java 身份验证和授权服务(JAAS)证书登录模块处理使用传输层安全(TLS)的客户端的身份验证和授权。模块需要使用双向 传输层安全 (TLS),并且客户端使用自己的证书。身份验证在 TLS 握手期间执行,不直接由 JAAS 证书登录模块执行。
证书登录模块的角色是:
- 限制可接受的用户的集合。只有可识别 名称 (DN)在相关属性文件中明确列出的用户才有资格被验证。
- 将组列表与接收的用户身份关联。这促进了授权。
- 需要存在传入客户端证书(默认情况下,TLS 层配置为将是否存在客户端证书视为可选)。
证书登录模块将证书 DN 的集合存储在一对平面文本文件中。文件将用户名和组群 ID 列表与每个 DN 关联。
证书登录模块由 org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule
类实施。
5.2.3.1. 将代理配置为使用基于证书的验证
以下流程演示了如何将代理配置为使用基于证书的验证。
先决条件
- 您必须将代理配置为使用双向传输层安全(TLS)。如需更多信息,请参阅 第 5.1.2 节 “配置双向 TLS”。
步骤
从之前导入到代理密钥存储的用户证书获取 Subjectuish ed Names (DN)。
将密钥存储文件中的证书导出到临时文件。例如:
keytool -export -file <file-name> -alias broker-localhost -keystore broker.ks -storepass <password>
输出导出的证书的内容:
keytool -printcert -file <file-name>
输出结果类似如下:
Owner: CN=localhost, OU=broker, O=Unknown, L=Unknown, ST=Unknown, C=Unknown Issuer: CN=localhost, OU=broker, O=Unknown, L=Unknown, ST=Unknown, C=Unknown Serial number: 4537c82e Valid from: Thu Oct 19 19:47:10 BST 2006 until: Wed Jan 17 18:47:10 GMT 2007 Certificate fingerprints: MD5: 3F:6C:0C:89:A8:80:29:CC:F5:2D:DA:5C:D7:3F:AB:37 SHA1: F0:79:0D:04:38:5A:46:CE:86:E1:8A:20:1F:7B:AB:3A:46:E4:34:5C
Owner
条目是 Subject DN。输入对象 DN 的格式取决于您的平台。以上字符串也可以表示为:Owner: `CN=localhost,\ OU=broker,\ O=Unknown,\ L=Unknown,\ ST=Unknown,\ C=Unknown`
配置基于证书的身份验证。
打开
<broker-instance-dir>/etc/login.config
配置文件。添加证书登录模块并引用用户和角色属性文件。例如:activemq { org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule debug=true org.apache.activemq.jaas.textfiledn.user="artemis-users.properties" org.apache.activemq.jaas.textfiledn.role="artemis-roles.properties"; };
org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule
- 实施类。
org.apache.activemq.jaas.textfiledn.user
- 指定为登录模块实施定义一组用户和密码的属性文件。
org.apache.activemq.jaas.textfiledn.role
- 指定将用户映射到已定义登录模块实施的角色的属性文件。
打开
<broker-instance-dir>/etc/artemis-users.properties
配置文件。此文件中定义了用户及其对应的 DN。例如:system=CN=system,O=Progress,C=US user=CN=humble user,O=Progress,C=US guest=CN=anon,O=Progress,C=DE
例如,根据前面的配置,名为
system
的用户映射到CN=system,O=Progress,C=US
Subject DN。打开
<broker-instance-dir>/etc/artemis-roles.properties
配置文件。此文件中定义了可用的角色和存放这些角色的用户。例如:admins=system users=system,user guests=guest
在前面的配置中,对于用户角色,您要以逗号分隔列表的形式列出多个用户。
确保您的安全域别名(在这个实例中,activemq)在
bootstrap.xml
中被引用,如下所示:<jaas-security domain="activemq"/>