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

   구현 클래스입니다.

   충분합니다.

   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. 이전에 기본 사용자 및 암호 인증을 위해 구성한 < 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. 이전에 브로커 키 저장소로 가져온 사용자 인증서에서 DN(Subject Distinguished Names )을 가져옵니다.

   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 구성 파일을 엽니다. 인증서 로그인 모듈을 추가하고 사용자 및 역할 속성 파일을 참조합니다. 예를 들면 다음과 같습니다.

      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 인증서를 읽고 인증서 제목에서 ID를 가져옵니다.
2. 인증서 주체는 인증서 로그인 모듈을 통해 브로커 ID에 매핑됩니다. 그런 다음 브로커는 해당 역할을 기반으로 사용자에게 권한을 부여합니다.

프로세스

1. 편집할 URI가 포함된 리소스를 엽니다.

   amqps://localhost:5500

2. 연결에 TSL/SSL을 활성화하려면 sslEnabled=true 매개변수를 추가합니다.

   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 인증서에 있는 ID를 사용하여 클라이언트를 인증하도록 요청합니다.

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