5.3. 클라이언트 인증

절차

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < security- settings> 요소에 단일 <security-setting > 요소를 추가합니다. match 키의 경우 주소를 지정합니다. 예를 들면 다음과 같습니다.

   <security-settings>
       <security-setting match="my.destination">
           <permission type="send" roles="producer"/>
       </security-setting>
   </security-settings>

   앞의 구성에 따라 생산자 역할의 구성원은 my.destination 주소에 대한 권한을 보냅니다.

절차

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < security- settings> 요소에 단일 <security-setting > 요소를 추가합니다. match 키의 경우 주소를 지정합니다. 예를 들면 다음과 같습니다.

   <security-settings>
       <security-setting match="my.destination">
           <permission type="consume" roles="consumer"/>
       </security-setting>
   </security-settings>

   앞의 구성에 따라 consumer 역할의 멤버는 주소 my.destination 에 대한 사용 권한을 갖습니다.

절차

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < security- settings> 요소에 단일 <security-setting > 요소를 추가합니다. 일치 키의 경우 모든 주소에 대한 액세스를 구성하려면 숫자 기호(#) 와일드카드 문자를 지정합니다. 예를 들면 다음과 같습니다.

   <security-settings>
       <security-setting match="#">
           <permission type="createDurableQueue" roles="guest"/>
           <permission type="deleteDurableQueue" roles="guest"/>
           <permission type="createNonDurableQueue" roles="guest"/>
           <permission type="deleteNonDurableQueue" roles="guest"/>
           <permission type="createAddress" roles="guest"/>
           <permission type="deleteAddress" roles="guest"/>
           <permission type="send" roles="guest"/>
           <permission type="browse" roles="guest"/>
           <permission type="consume" roles="guest"/>
           <permission type="manage" roles="guest"/>
       </security-setting>
   </security-settings>

   이전 구성에 따라 모든 대기열에서 guest 역할의 멤버에게 모든 권한이 부여됩니다. 이는 익명 인증이 모든 사용자에게 게스트 역할을 할당하도록 구성된 개발 시나리오에서 유용할 수 있습니다.

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. < security- settings> 요소에 단일 <security-setting > 요소를 추가합니다. 일치 키의 경우 숫자 기호(#) 와일드카드 문자를 포함하여 일치하는 주소 집합에 설정을 적용합니다. 예를 들면 다음과 같습니다.

   <security-setting match="globalqueues.europe.#">
      <permission type="createDurableQueue" roles="admin"/>
      <permission type="deleteDurableQueue" roles="admin"/>
      <permission type="createNonDurableQueue" roles="admin, guest, europe-users"/>
      <permission type="deleteNonDurableQueue" roles="admin, guest, europe-users"/>
      <permission type="send" roles="admin, europe-users"/>
      <permission type="consume" roles="admin, europe-users"/>
   </security-setting>

   match=globalqueues.europe.#

   숫자 기호(#) 와일드카드 문자는 브로커에 의해 "모든 단어 순서"로 해석됩니다. 마침표(..)로 구분됩니다. 이 예에서 보안 설정은 globalqueues.europe 문자열로 시작하는 모든 주소에 적용됩니다.

   permission type="createDurableQueue"

   관리자 역할이 있는 사용자만 globalqueues.europe 문자열로 시작하는 주소에 바인딩된 내성 대기열을 생성하거나 삭제할 수 있습니다.

   permission type="createNonDurableQueue"

   admin,guest 또는 europe-users 역할이 있는 모든 사용자는 globalqueues.europe 문자열로 시작하는 주소에 바인딩된 임시 대기열을 만들거나 삭제할 수 있습니다.

   permission type="send"

   역할 admin 또는 europe-users 가 있는 모든 사용자는 globalqueues.europe 문자열로 시작하는 주소에 바인딩된 큐에 메시지를 보낼 수 있습니다.

   permission type="consume"

   역할 admin 또는 europe-users 가 있는 모든 사용자는 globalqueues.europe 문자열로 시작하는 주소에 바인딩된 큐에서 메시지를 사용할 수 있습니다.

3. (선택 사항) 더 좁은 주소 집합에 다른 보안 설정을 적용하려면 < security-setting> 요소를 추가합니다. match 키의 경우 더 구체적인 텍스트 문자열을 지정합니다. 예를 들면 다음과 같습니다.

   <security-setting match="globalqueues.europe.orders.#">
      <permission type="send" roles="europe-users"/>
      <permission type="consume" roles="europe-users"/>
   </security-setting>

   두 번째 security-setting 요소에서 globalqueues.europe.orders.# 일치는 첫 번째 security-setting 요소에 지정된 글로벌 큐 큐.europe.# 보다 더 구체적입니다. globalqueues.europe.orders.# 와 일치하는 주소의 경우 권한 createDurableQueue,deleteDurableQueue 만들기NonDurableQueue,deleteNonDurableQueue 는 파일의 첫 번째 security-setting 요소에서 상속 되지 않습니다. 예를 들어 주소 globalqueues.europe.orders.plastics 의 경우 존재하는 유일한 권한은 역할 europe-users 에 대해 전송 및 소비 됩니다.

   따라서 하나의 security-setting 블록에서 지정된 권한은 다른 security-setting 블록에서 상속되지 않으므로 해당 권한을 지정하지 않고 보다 구체적인 security-setting 블록에서 권한을 효과적으로 거부할 수 있습니다.

절차

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 지정된 큐의 경우 사용자 키를 추가합니다. 값을 할당합니다. 예를 들면 다음과 같습니다.

   <address name="ExampleQueue">
       <anycast>
          <queue name="ExampleQueue" user="admin"/>
       </anycast>
   </address>

   이전 구성을 기반으로 admin 사용자는 대기열 예Queue 에 할당됩니다.

절차

1. &lt ;broker_instance_dir> /etc/management.xml 구성 파일을 엽니다.

2. role-access 요소를 검색하고 구성을 편집합니다. 예를 들면 다음과 같습니다.

   <role-access>
       <match domain="org.apache.activemq.artemis">
          <access method="list*" roles="view,update,amq"/>
          <access method="get*" roles="view,update,amq"/>
          <access method="is*" roles="view,update,amq"/>
          <access method="set*" roles="update,amq"/>
          <access method="*" roles="amq"/>
       </match>
   </role-access>

   • 이 경우 도메인 이름 org.apache.activemq.apache 가 있는 모든 CloudEvent 속성에 일치가 적용됩니다.
   • 일치하는 10.0.0.1 속성에 대한 보기,업데이트 또는 amq 역할에 대한 액세스는 역할을 추가하는 list*, get*, is*, * 액세스 메서드로 제어됩니다. method="*"( 위드카드) 구문은 구성에 나열되지 않은 다른 모든 메서드를 지정하는 데 catch-all 방법으로 사용됩니다. 구성의 각 액세스 방법은 CloudEvent 메서드 호출로 변환됩니다.
   • 호출된 CloudEvent 메서드가 구성에 나열된 메서드와 일치합니다. 예를 들어 org.apache.activemq.artemis 도메인을 사용하여 listMessages 라는 메서드를 호출하면 브로커는 목록 메서드의 구성에 정의된 역할에 대한 액세스를 다시 찾습니다.

   • 전체 method name을 사용하여 액세스를 구성할 수도 있습니다. 예를 들면 다음과 같습니다.

     <access method="listMessages" roles="view,update,amq"/>

3. 브로커를 시작하거나 다시 시작합니다.

   • Linux: &lt ;broker_instance_dir> /bin/artemis 실행
   • Windows에서 &lt ;broker_instance_dir> \bin\artemis-service.exe 시작

절차

1. &lt ;broker_instance_dir> /etc/management.xml 구성 파일을 엽니다.

2. 허용 목록 요소를 검색하고 구성을 편집합니다.

   <whitelist>
      <entry domain="hawtio"/>
   </whitelist>

   이 예에서 도메인 hawtio 가 있는 모든 10.0.0.1은 인증 없이 액세스가 허용됩니다. < entry domain="hawtio" key="type=*"/ > 형식의 와일드카드 항목을 사용할 수도 있습니다.

3. 브로커를 시작하거나 다시 시작합니다.

   • Linux: &lt ;broker_instance_dir> /bin/artemis 실행
   • Windows에서 &lt ;broker_instance_dir> \bin\artemis-service.exe 시작

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. resource-limit-settings 요소를 추가합니다. max-connections 및 max-queues 의 값을 지정합니다. 예를 들면 다음과 같습니다.

   <resource-limit-settings>
      <resource-limit-setting match="myUser">
         <max-connections>5</max-connections>
         <max-queues>3</max-queues>
      </resource-limit-setting>
   </resource-limit-settings>

   Max-connections

   일치하는 사용자가 브로커에 수행할 수 있는 연결 수를 정의합니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.

   max-queues

   일치하는 사용자가 생성할 수 있는 대기열 수를 정의합니다. 기본값은 -1 이며 이는 제한이 없음을 의미합니다.