5.2. 验证客户端

流程

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

   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

   实施类。

   足够

   标志指定 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. 若有必要，将安全域别名（ 在这个实例中）添加到该文件，如下所示：

   <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 (DNs)。

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

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

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

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

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

   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. 证书主题映射到证书登录模块的代理身份。然后，代理会基于其角色授权用户。

流程

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