5.2. 验证客户端

流程

1. 打开 & lt;broker_instance_dir> /etc/login.config 配置文件。默认情况下，新 AMQ Broker 7.12 实例中的此文件包括以下行：

   activemq {
      org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
          debug=false
          reload=true
          org.apache.activemq.jaas.properties.user="artemis-users.properties"
          org.apache.activemq.jaas.properties.role="artemis-roles.properties";
            };

   ActiveMQ

   配置的别名。

   org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule

   实施类。

   sufficient

   指定 PropertiesLoginModule 所需的成功级别的标志。您可以设置的值有：

   • 必需 ：需要登录模块才能成功。身份验证将继续关闭给定别名下配置的登录模块列表，而不考虑成功或失败。
   • 先决条件 ：成功需要登录模块。故障会立即向应用程序返回控制。身份验证不会执行在给定别名下配置的登录模块列表。
   • sufficient: 登录模块不需要成功。如果成功，则控制会返回到应用程序，并且身份验证不会进一步操作。如果失败，身份验证会尝试关闭在给定别名下配置的登录模块列表。
   • 可选 登录模块不是必需的。身份验证将继续关闭给定别名下配置的登录模块列表，而不考虑成功或失败。

   org.apache.activemq.jaas.properties.user

   指定为登录模块实施定义一组用户和密码的属性文件。

   org.apache.activemq.jaas.properties.role

   指定属性文件，将用户映射到登录模块实施的定义的角色。

2. 打开 & lt;broker_instance_dir> /etc/artemis-users.properties 配置文件。

3. 添加用户并为用户分配密码。例如：

   user1=secret
   user2=access
   user3=myPassword

4. 打开 & lt;broker_instance_dir> /etc/artemis-roles.properties 配置文件。

5. 将角色名称分配给您之前添加到 artemis-users.properties 文件中的用户。例如：

   admin=user1,user2
   developer=user3

6. 打开 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。

7. 如有必要，将您的安全域别名（在这个实例中，activemq）添加到该文件中，如下所示：

   <jaas-security domain="activemq"/>

流程

1. 打开之前为基本用户和密码身份验证配置的 & lt;broker_instance_dir> /etc/login.config 配置文件。

2. 在您之前添加的属性登录模块配置后，添加客户机登录模块配置。例如：

   activemq {
     org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
         debug=true
         org.apache.activemq.jaas.properties.user="artemis-users.properties"
         org.apache.activemq.jaas.properties.role="artemis-roles.properties";
   
     org.apache.activemq.artemis.spi.core.security.jaas.GuestLoginModule sufficient
         debug=true
         org.apache.activemq.jaas.guest.user="guest"
         org.apache.activemq.jaas.guest.role="restricted";
   };

   org.apache.activemq.artemis.spi.core.security.jaas.GuestLoginModule

   实施类。

   org.apache.activemq.jaas.guest.user

   分配给匿名用户的用户名。

   org.apache.activemq.jaas.guest.role

   分配给匿名用户的角色。

流程

1. 从之前导入到代理密钥存储的用户证书获取 Subject Distinguished Names (DN)。

   1. 将密钥存储文件的证书导出到临时文件中。例如：

      keytool -export -file <file_name> -alias broker-localhost -keystore broker.ks -storepass <password>

   2. 输出导出的证书的内容：

      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 条目是主题 DN。用于输入主题 DN 的格式取决于您的平台。以上字符串也可以表示为;

      Owner: `CN=localhost,\ OU=broker,\ O=Unknown,\ L=Unknown,\ ST=Unknown,\ C=Unknown`

2. 配置基于证书的身份验证。

   1. 打开 & lt;broker_instance_dir> /etc/login.config 配置文件。添加 certificate 登录模块并引用用户和角色属性文件。例如：

      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

      指定属性文件，将用户映射到登录模块实施的定义的角色。

   2. 打开 & lt;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。

   3. 打开 & lt;broker_instance_dir> /etc/artemis-roles.properties 配置文件。此文件中定义包含这些角色的可用角色和用户。例如：

      admins=system
      users=system,user
      guests=guest

      在前面的配置中，对于 users 角色，您将以逗号分隔列表列出多个用户。

   4. 请确保您的安全域别名（在本例中是 activemq）在 bootstrap.xml 中引用，如下所示：

      <jaas-security domain="activemq"/>

1. 代理读取客户端的 TLS/SSL 证书，以从证书主体获取身份。
2. 证书主题通过 certificate 登录模块映射到代理身份。然后，代理会根据用户的角色授权用户。

流程

1. 打开包含用于编辑的 URI 的资源：

   amqps://localhost:5500

2. 添加参数 sslEnabled=true 来为连接启用 TSL/SSL ：

   amqps://localhost:5500?sslEnabled=true

3. 添加与客户端信任存储和密钥存储相关的参数，以启用代理与 TSL/SSL 证书交换：

   amqps://localhost:5500?sslEnabled=true&trustStorePath=<trust_store_path>&trustStorePassword=<trust_store_password>&keyStorePath=<key_store_path>&keyStorePassword=<key_store_password>

4. 添加参数 saslMechanisms=EXTERNAL，以使用其 TSL/SSL 证书中找到的身份来请求代理验证客户端：

   amqps://localhost:5500?sslEnabled=true&trustStorePath=<trust_store_path>&trustStorePassword=<trust_store_password>&keyStorePath=<key_store_path>&keyStorePassword=<key_store_password>&saslMechanisms=EXTERNAL