AMQ Interconnect 사용

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

2. 라우터에 클라이언트 연결에 대한 개인 키와 인증서를 정의하는 sslProfile 이 포함되어 있지 않은 경우 이를 추가합니다.

   이 sslProfile 에는 개인 키의 위치와 라우터에서 클라이언트의 연결을 암호화하는 데 사용해야 하는 인증서가 포함되어 있습니다.

   sslProfile {
       name: service-tls
       certFile: /etc/pki/tls/certs/tls.crt
       caCertFile: /etc/pki/tls/certs/ca.crt
       privateKeyFile: /etc/pki/tls/private/tls.key
       password: file:/etc/pki/tls/private/password.txt
       ...
   }

   name

   이 sslProfile 을 참조하는 데 사용할 수 있는 고유한 이름입니다.

   certFile

   이 라우터의 공용 인증서가 포함된 파일의 절대 경로입니다.

   caCertFile

   라우터가 들어오는 클라이언트를 인증하는 데 사용하는 CA 인증서의 절대 경로입니다.

   privateKeyFile

   이 라우터의 공용 인증서에 대한 개인 키가 포함된 파일의 절대 경로입니다.

   참고

   qdrouterd 또는 root 사용자가 개인 키에 액세스할 수 있는지 확인합니다. 예를 들면 다음과 같습니다.

   chmod 0600 /etc/pki/tls/private/tls.key
   chown qdrouterd /etc/pki/tls/private/tls.key

   암호

   인증서 키의 잠금을 해제하는 암호입니다. 인증서 키에 암호가 없는 경우 이를 지정할 필요가 없습니다. 다른 접두사를 사용하여 보안 요구 사항에 따라 암호를 여러 가지 방법으로 지정할 수 있습니다.

   • 암호가 포함된 파일의 절대 경로를 지정합니다. 암호가 포함된 파일에 대한 권한을 설정할 수 있으므로 가장 안전한 옵션입니다. 예를 들면 다음과 같습니다.

     password: file:/etc/qpid-dispatch-certs/inter-router/password.txt

   • 암호를 저장하는 환경 변수를 지정합니다. 다른 프로세스의 환경이 특정 플랫폼에 표시되므로 이 옵션을 신중하게 사용합니다. 예를 들면 다음과 같습니다.

     password: env:CERT_PASSWORD

   • 암호를 일반 텍스트로 지정합니다. 이 옵션은 안전하지 않으므로 보안이 우려되지 않은 경우에만 사용해야 합니다. 예를 들면 다음과 같습니다.

     password: pass:mycertpassword

3. SSL/TLS를 사용하여 연결을 암호화하도록 이 연결에 대한 리스너 를 구성합니다.

   이 예제에서는 클라이언트의 연결을 암호화하도록 일반 리스너를 구성합니다.

   listener {
       host: 0.0.0.0
       port: 5672
       role: normal
       sslProfile: inter_router_tls
       requireSsl: yes
       ...
   }

   sslProfile

   클라이언트 연결에 대한 SSL/TLS 개인 키 및 인증서를 정의하는 sslProfile 의 이름입니다.

   requireSsl

   SSL/TLS를 통한 연결을 암호화하려면 true 를 지정합니다.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

2. SSL/TLS를 사용하여 클라이언트를 인증하도록 이 연결에 대한 리스너 를 구성합니다.

   이 예제에서는 일반 리스너에 SSL/TLS 인증을 추가하여 클라이언트에서 들어오는 연결을 인증합니다. 클라이언트는 고유 X.509 인증서를 라우터에 제공하면 라우터에만 연결할 수 있습니다. 이 인증서를 라우터에서 클라이언트의 ID를 확인하는 데 사용할 수 있습니다.

   listener {
       host: 0.0.0.0
       port: 5672
       role: normal
       sslProfile: service-tls
       requireSsl: yes
       authenticatePeer: yes
       saslMechanisms: EXTERNAL
       ...
   }

   authenticatePeer

   클라이언트 ID를 인증하려면 yes 를 지정합니다.

   saslMechanisms

   X.509 클라이언트 인증서 인증을 활성화하려면 EXTERNAL 을 지정합니다.

절차

1. 필요한 경우 사용자 이름과 암호를 SASL 데이터베이스에 추가합니다.

   이 예제에서는 SASL 데이터베이스(qdrouterd.sasldb)에 새 사용자(user1@example.com)를 추가합니다.

   $ sudo saslpasswd2 -c -f qdrouterd.sasldb -u example.com user1

   참고

   전체 사용자 이름은 입력한 사용자 이름과 도메인 이름(<user-name> @ <domain-name> )입니다. 데이터베이스에 사용자를 추가할 때는 도메인 이름을 제공할 필요는 없지만 제공하지 않으면 기본 도메인이 자동으로 추가됩니다(도움말 시스템의 호스트 이름).

2. qdrouterd 프로세스에서 SASL 데이터베이스를 읽을 수 있는지 확인합니다.

   qdrouterd 프로세스가 권한이 없는 사용자로 실행되는 경우 라우터에서 읽을 수 있도록 SASL 데이터베이스의 권한 또는 소유권을 조정해야 할 수 있습니다.

   이 예제에서는 qdrouterd 사용자를 SASL 데이터베이스의 소유자로 만듭니다.

   $ sudo chown qdrouterd /var/lib/qdrouterd/qdrouterd.sasldb

3. /etc/sasl2/qdrouterd.conf 구성 파일을 엽니다.

   이 예제에서는 /etc/sasl2/qdrouterd.conf 구성 파일을 보여줍니다.

   pwcheck_method: auxprop
   auxprop_plugin: sasldb
   sasldb_path: qdrouterd.sasldb
   mech_list: ANONYMOUS DIGEST-MD5 EXTERNAL PLAIN GSSAPI

4. mech_list 속성에 PLAIN 메커니즘이 포함되어 있는지 확인합니다.
5. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

6. router 섹션에서 SASL 구성 파일의 경로를 지정합니다.

   router {
       mode: interior
       id: Router.A
       saslConfigDir: /etc/sasl2/
   }

   saslConfigDir

   사용자 이름과 암호를 저장하는 SASL 데이터베이스의 경로가 포함된 SASL 구성 파일의 절대 경로입니다.

7. SASL PLAIN을 사용하여 클라이언트를 인증하도록 이 연결에 대한 리스너 를 구성합니다.

   이 예제에서는 리스너 에 대한 기본 사용자 이름 및 암호 인증을 구성합니다. 이 경우 SSL/TLS 암호화가 사용되지 않습니다.

   listener {
       host: 0.0.0.0
       port: 5672
       authenticatePeer: yes
       saslMechanisms: PLAIN
       }

절차

1. 라우터의 호스트 시스템에서 /etc/sasl2/qdrouterd.conf 구성 파일을 엽니다.

   이 예제에서는 /etc/sasl2/qdrouterd.conf 구성 파일을 보여줍니다.

   pwcheck_method: auxprop
   auxprop_plugin: sasldb
   sasldb_path: qdrouterd.sasldb
   keytab: /etc/krb5.keytab
   mech_list: ANONYMOUS DIGEST-MD5 EXTERNAL PLAIN GSSAPI

2. 다음을 확인합니다.

   • mech_list 속성에는 GSSAPI 메커니즘이 포함되어 있습니다.
   • keytab 속성은 keytab 파일의 위치를 가리킵니다.
3. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

4. router 섹션에서 SASL 구성 파일의 경로를 지정합니다.

   router {
       mode: interior
       id: Router.A
       saslConfigDir: /etc/sasl2/
   }

   saslConfigDir

   SASL 데이터베이스의 경로가 포함된 SASL 구성 파일의 절대 경로입니다.

5. 인증에 Kerberos를 사용하여 들어오는 각 연결에 대해 GSSAPI 메커니즘을 사용하도록 리스너 를 설정합니다.

   listener {
       host: 0.0.0.0
       port: 5672
       authenticatePeer: yes
       saslMechanisms: GSSAPI
       }

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

2. 라우터에 외부 AMQP 컨테이너의 ID를 확인하는 데 사용할 수 있는 인증서를 정의하는 sslProfile 이 포함되어 있지 않은 경우 이를 추가합니다.

   sslProfile {
       name: broker-tls
       caCertFile: /etc/qpid-dispatch-certs/ca.crt
       ...
   }

   name

   이 sslProfile 을 참조하는 데 사용할 수 있는 고유한 이름입니다.

   caCertFile

   외부 AMQP 컨테이너의 ID를 확인하는 데 사용되는 CA 인증서의 절대 경로입니다.

3. SSL/TLS를 사용하도록 이 연결에 대한 커넥터 를 구성하여 SSL 핸드셰이크 중에 브로커가 수신한 서버 인증서의 유효성을 검사합니다.

   이 예제에서는 브로커에 대한 커넥터 를 구성합니다. 라우터가 브로커에 연결하면 broker-tls sslProfile 에 정의된 CA 인증서를 사용하여 브로커에서 수신한 서버 인증서의 유효성을 검사합니다.

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       sslProfile: broker-tls
       ...
   }

   sslProfile

   외부 AMQP 컨테이너의 ID를 확인하는 데 사용할 인증서를 정의하는 sslProfile 의 이름입니다.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

2. 라우터에 외부 AMQP 컨테이너에 연결할 개인 키와 인증서를 정의하는 sslProfile 이 포함되어 있지 않은 경우 하나를 추가합니다.

   이 sslProfile 에는 개인 키의 위치와 라우터에서 피어로 인증하는 데 사용해야 하는 인증서가 포함되어 있습니다.

   sslProfile {
       name: broker-tls
       certFile: /etc/pki/tls/certs/tls.crt
       caCertFile: /etc/pki/tls/certs/ca.crt
       privateKeyFile: /etc/pki/tls/private/tls.key
       password: file:/etc/pki/tls/private/password.txt
       ...
   }

   name

   이 sslProfile 을 참조하는 데 사용할 수 있는 고유한 이름입니다.

   certFile

   이 라우터의 공용 인증서가 포함된 파일의 절대 경로입니다.

   caCertFile

   라우터가 들어오는 클라이언트를 인증하는 데 사용하는 CA 인증서의 절대 경로입니다.

   privateKeyFile

   이 라우터의 공용 인증서에 대한 개인 키가 포함된 파일의 절대 경로입니다.

   참고

   qdrouterd 또는 root 사용자가 개인 키에 액세스할 수 있는지 확인합니다. 예를 들면 다음과 같습니다.

   chmod 0600 /etc/pki/tls/private/tls.key
   chown qdrouterd /etc/pki/tls/private/tls.key

   암호

   인증서 키의 잠금을 해제하는 암호입니다. 인증서 키에 암호가 없는 경우 이를 지정할 필요가 없습니다. 다른 접두사를 사용하여 보안 요구 사항에 따라 암호를 여러 가지 방법으로 지정할 수 있습니다.

   • 암호가 포함된 파일의 절대 경로를 지정합니다. 암호가 포함된 파일에 대한 권한을 설정할 수 있으므로 가장 안전한 옵션입니다. 예를 들면 다음과 같습니다.

     password: file:/etc/qpid-dispatch-certs/inter-router/password.txt

   • 암호를 저장하는 환경 변수를 지정합니다. 다른 프로세스의 환경이 특정 플랫폼에 표시되므로 이 옵션을 신중하게 사용합니다. 예를 들면 다음과 같습니다.

     password: env:CERT_PASSWORD

   • 암호를 일반 텍스트로 지정합니다. 이 옵션은 안전하지 않으므로 보안이 우려되지 않은 경우에만 사용해야 합니다. 예를 들면 다음과 같습니다.

     password: pass:mycertpassword

3. 생성한 sslProfile 을 사용하도록 이 연결에 대한 커넥터 를 구성합니다.

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       sslProfile: broker-tls
       saslMechanisms: EXTERNAL
       ...
   }

   sslProfile

   라우터 간 네트워크의 SSL/TLS 개인 키 및 인증서를 정의하는 sslProfile 의 이름입니다.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일을 엽니다.

2. 외부 AMQP 컨테이너에 사용자 이름 및 암호 자격 증명을 제공하도록 이 연결에 대한 커넥터 를 구성합니다.

   connector {
       host: 192.0.2.1
       port: 5672
       role: route-container
       saslMechanisms: PLAIN
       saslUsername: user
       saslPassword: file:/path/to/file/password.txt
       }

   saslPassword

   피어에 연결할 암호입니다. 다른 접두사를 사용하여 보안 요구 사항에 따라 암호를 여러 가지 방법으로 지정할 수 있습니다.

   • 암호가 포함된 파일의 절대 경로를 지정합니다. 암호가 포함된 파일에 대한 권한을 설정할 수 있으므로 가장 안전한 옵션입니다. 예를 들면 다음과 같습니다.

     password: file:/path/to/file/password.txt

   • 암호를 저장하는 환경 변수를 지정합니다. 다른 프로세스의 환경이 특정 플랫폼에 표시되므로 이 옵션을 신중하게 사용합니다. 예를 들면 다음과 같습니다.

     password: env:PASSWORD

   • 암호를 일반 텍스트로 지정합니다. 이 옵션은 안전하지 않으므로 보안이 우려되지 않은 경우에만 사용해야 합니다. 예를 들면 다음과 같습니다.

     password: pass:mypassword

절차

1. vhost 섹션을 추가하고 메시징 끝점에 대한 연결 및 메시지 크기 제한을 정의합니다.

   연결 제한은 vhost에 연결된 모든 사용자에게 적용됩니다. 이러한 제한은 vhost에 동시에 연결할 수 있는 사용자 수를 제어합니다.

   vhost {
       hostname: "example.com"
       aliases: "example.org, example.net"
       maxConnections: 10000
       maxMessageSize: 500000
       maxConnectionsPerUser: 100
       maxConnectionsPerHost: 100
       allowUnknownUser: true
       ...
   }

   hostname

   vhost( messaging 끝점)의 리터럴 호스트 이름 또는 vhost 호스트 이름과 일치하는 패턴입니다. 이 vhost 정책은 사용자가 지정하는 호스트 이름으로 전달되는 모든 클라이언트 연결에 적용됩니다. 이 이름은 고유해야 합니다. 호스트 이름당 하나의 vhost 정책만 사용할 수 있습니다.

   enableVhostNamePatterns 가 true 로 설정된 경우 와일드카드를 사용하여 호스트 이름의 범위와 일치하는 패턴을 지정할 수 있습니다. 자세한 내용은 10.4.6절. “vhost 정책 호스트 이름 패턴 일치 규칙”의 내용을 참조하십시오.

   별칭

   라우터에서 이 vhost의 설정을 사용하도록 지시하는 대체 리터럴 호스트 이름 또는 패턴입니다. 들어오는 연결과 일치하는 별칭 호스트 이름은 vhost 섹션에 정의된 설정을 사용합니다. 다중 테넌트 구성에서 vhost 별칭에 대한 연결은 테넌트 네임스페이스의 기본 vhost 호스트 이름을 사용합니다. 이 예에서 연결이 vhost example.org 로 이동되면 기본 vhost 호스트 이름 example.com 의 설정이 적용되고 example.com 은 테넌트 네임스페이스가 됩니다. 모든 vhosts의 vhost 호스트 이름 및 별칭 설정은 고유해야 합니다.

   enableVhostNamePatterns 가 true 로 설정된 경우 와일드카드를 사용하여 호스트 이름 별칭 범위와 일치하는 패턴을 지정할 수 있습니다. 자세한 내용은 10.4.6절. “vhost 정책 호스트 이름 패턴 일치 규칙”의 내용을 참조하십시오.

   maxConnections

   이 vhost에 허용되는 최대 동시 클라이언트 연결의 최대 수입니다. 기본값은 65535입니다.

   maxMessageSize

   이 vhost에 연결할 수 있는 AMQP 메시지 전송의 최대 크기(바이트)입니다. 이 제한은 정책 maxMessageSize 값을 재정의하고 vhost 사용자 그룹 설정으로 덮어쓸 수 있습니다. 값이 0 이면 이 제한이 비활성화됩니다.

   maxConnectionsPerUser

   모든 사용자에 대해 허용되는 최대 동시 클라이언트 연결 수입니다. 기본값은 65535입니다.

   maxConnectionsPerHost

   모든 원격 호스트(클라이언트가 연결되는 호스트)에 대해 허용되는 최대 동시 클라이언트 연결 수입니다. 기본값은 65535입니다.

   allowUnknownUser

   알 수 없는 사용자(정의된 사용자 그룹의 멤버가 아닌 사용자)가 vhost에 연결할 수 있는지 여부입니다. 알 수 없는 사용자는 $default 사용자 그룹에 할당되며 $default 설정을 받습니다. 기본값은 false 입니다. 즉, 알 수 없는 사용자가 허용되지 않습니다.

2. 추가한 연결 설정 아래에 있는 vhost 섹션에서 groups 엔터티를 추가하여 리소스 제한을 정의합니다.

   사용자 그룹별로 리소스 제한을 정의합니다. 사용자 그룹은 그룹 멤버가 액세스할 수 있는 메시징 리소스를 지정합니다.

   이 예제에서는 admin, developers, $default의 세 가지 사용자 그룹을 보여줍니다.

   vhost {
       ...
       groups: {
           admin: {
               users: "admin1, admin2"
               remoteHosts: "127.0.0.1, ::1"
               sources: "*"
               targets: "*"
           }
           developers: {
               users: "dev1, dev2, dev3"
               remoteHosts: "*"
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
           $default: {
               remoteHosts: "*"
               allowDynamicSource: true,
               allowAdminStatusUpdate: true,
               sources: "myqueue1, myqueue2"
               targets: "myqueue1, myqueue2"
           }
       }
   }

   참고

   따옴표를 사용하여 문자열 값을 정의합니다.

   사용자

   이 사용자 그룹에 대해 인증된 사용자 목록입니다. 여러 사용자를 분리하려면 쉼표를 사용합니다. 사용자는 하나의 가상호스트 사용자 그룹에만 속할 수 있습니다.

   remoteHosts

   사용자가 연결할 수 있는 원격 호스트 목록입니다. 호스트는 호스트 이름, IP 주소 또는 IP 주소 범위일 수 있습니다. 쉼표를 사용하여 여러 호스트를 구분합니다. 모든 원격 호스트에서 액세스를 허용하려면 와일드카드 * 를 지정합니다. 모든 원격 호스트에서 액세스를 거부하려면 이 속성을 비워 둡니다.

   maxConnectionsPerUser

   이 사용자 그룹의 사용자가 생성할 수 있는 최대 연결 수입니다. 이 값을 지정하면 vhost maxConnectionsPerUser 값을 덮어씁니다.

   maxConnectionsPerHost

   허용된 원격 호스트에서 이 사용자 그룹의 사용자가 생성할 수 있는 최대 동시 연결 수입니다. 이 값을 지정하면 vhost maxConnectionsPerUser 값을 덮어씁니다.

   maxMessageSize

   이 그룹의 사용자가 생성한 연결에 허용되는 AMQP 메시지 전송의 최대 크기(바이트)입니다. 이 제한은 policy 및 vhost maxMessageSize 값을 덮어씁니다. 값이 0 이면 이 제한이 비활성화됩니다.

   allowDynamicSource

   true 인 경우 이 그룹의 사용자 연결은 수신자를 동적 소스에 연결할 수 있습니다. 이를 통해 임시 주소 또는 임시 큐에 리스너를 생성할 수 있습니다. false 인 경우 동적 소스를 사용할 수 없습니다.

   allowAdminStatusUpdate

   true 인 경우 이 그룹의 사용자 연결은 연결의 adminStatus 를 수정할 수 있습니다. 이는 발신자 또는 수신자 연결의 종료를 허용합니다. false 인 경우 이 그룹의 사용자는 연결을 종료하지 못하도록 합니다. 라우터 간 연결은 사용자가 종료할 수 없습니다. 정책이 구성되지 않은 경우에도 기본값은 true 입니다.

   allowWaypointLinks

   true 인 경우 이 그룹의 사용자의 연결은 waypoint 기능을 사용하여 링크를 연결할 수 있습니다. 이를 통해 끝점은 자동 링크를 구성할 필요 없이 끝점(즉, 브로커)으로 작동할 수 있습니다. false 인 경우 waypoint 기능을 사용할 수 없습니다.

   allowDynamicLinkRoutes

   true 인 경우 이 그룹의 사용자의 연결은 연결 범위 링크 경로 대상을 동적으로 생성할 수 있습니다. 이를 통해 끝점이 링크 경로를 구성할 필요 없이 링크 경로 대상(즉, 브로커)으로 작동할 수 있습니다. false 인 경우 동적 링크 경로 대상 생성이 허용되지 않습니다.

   allowFallbackLinks

   true 인 경우 이 그룹의 사용자의 연결은 폴백 링크 기능을 사용하여 링크를 연결할 수 있습니다. 이를 통해 폴백이 활성화된 주소에 대한 엔드포인트가 대체 대상(및 소스)으로 작동할 수 있습니다. false 인 경우 대체 링크 기능을 사용할 수 없습니다.

   sources | sourcePattern

   이 그룹의 사용자가 메시지를 수신할 수 있는 AMQP 소스 주소 목록입니다.

   소스를 사용하여 하나 이상의 리터럴 주소를 지정합니다. 여러 주소를 지정하려면 쉼표로 구분된 목록을 사용합니다. 이 그룹의 사용자가 모든 주소에서 메시지를 수신하지 못하도록 하려면 이 속성을 비워 둡니다. 특정 사용자와 관련된 주소에 대한 액세스를 허용하려면 ${user} 토큰을 지정합니다. 자세한 내용은 10.4.5절. “vhost 정책 소스 및 대상 주소를 지정하는 방법”의 내용을 참조하십시오.

   또는 sourcePattern 을 사용하여 패턴에 해당하는 하나 이상의 주소를 일치시킬 수 있습니다. 패턴은 . 또는 / 문자로 구분된 일련의 단어입니다. 와일드카드 문자를 사용하여 단어를 나타낼 수 있습니다. * 문자는 정확히 하나의 단어와 일치하며 # 문자는 0개 이상의 단어와 일치합니다.

   여러 주소 범위를 지정하려면 쉼표로 구분된 주소 패턴 목록을 사용합니다. 자세한 내용은 ]을 참조하십시오. 특정 사용자와 관련된 주소 범위에 대한 액세스를 허용하려면 ${user} 토큰을 지정합니다. 자세한 내용은 xref:methods-specifying-vhost-policy-source-target-addresses-router-rhel[ 를 참조하십시오.

   targets | targetPattern

   이 그룹의 사용자가 메시지를 보낼 수 있는 AMQP 대상 주소 목록입니다. 여러 AMQP 주소를 지정하고 소스 주소와 동일한 방식으로 사용자 이름 대체 및 주소 패턴을 사용할 수 있습니다.

3. 필요한 경우 고급 사용자 그룹 설정을 vhost 사용자 그룹에 추가합니다.

   고급 사용자 그룹 설정을 사용하면 연결의 열린 AMQP 연결, 세션 시작 및 링크 연결 단계에 따라 리소스 제한을 정의할 수 있습니다. 자세한 내용은 qdrouterd.conf 매뉴얼 페이지의 vhost 를 참조하십시오.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일에서 vhost 정책 정의 JSON 파일을 저장할 디렉터리를 지정합니다.

   policy {
       ...
       policyDir: /etc/qpid-dispatch-policies
   }

   policyDir

   JSON 형식의 vhost 정책 정의 파일이 있는 디렉터리의 절대 경로입니다. 라우터는 이 디렉터리에 있는 각 JSON 파일에서 모든 vhost 정책을 처리합니다.

2. vhost 정책 정의 디렉터리에서 각 vhost 정책에 대해 JSON 파일을 생성합니다.

   예 10.1. vhost 정책 정의 JSON 파일

   [
       ["vhost", {
           "hostname": "example.com",
           "maxConnections": 10000,
           "maxConnectionsPerUser": 100,
           "maxConnectionsPerHost": 100,
           "allowUnknownUser": true,
           "groups": {
               "admin": {
                   "users": ["admin1", "admin2"],
                   "remoteHosts": ["127.0.0.1", "::1"],
                   "sources": "*",
                   "targets": "*"
               },
               "developers": {
                   "users": ["dev1", "dev2", "dev3"],
                   "remoteHosts": "*",
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               },
               "$default": {
                   "remoteHosts": "*",
                   "allowDynamicSource": true,
                   "sources": ["myqueue1", "myqueue2"],
                   "targets": ["myqueue1", "myqueue2"]
               }
           }
       }]
   ]

   이러한 속성에 대한 자세한 내용은 10.4.2절. “가상 호스트 정책 생성” 을 참조하십시오.

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일에서 $connector 사용자 그룹이 있는 vhost 섹션을 추가합니다.

   vhost {
       hostname: "my-connector-policy"
       groups: {
           $connector: {
               sources: "*"
               targets: "*"
               maxSenders: 5
               maxReceivers: 10
               allowAnonymousSender: true
               allowWaypointLinks: true
           }
       }
   }

   hostname

   커넥터 vhost 정책을 식별하는 고유한 이름입니다. 이 이름은 실제 호스트 이름을 나타내지 않으므로 실제 vhost 호스트 이름과 충돌하지 않는 이름을 선택합니다.

   $Connector

   이 vhost 정책을 커넥터 vhost 정책으로 식별합니다. 적용할 수 있는 리소스 제한에 대한 자세한 내용은 10.4.2절. “가상 호스트 정책 생성” 을 참조하십시오.

2. 외부 AMQP 컨테이너에 대한 연결을 설정하는 커넥터에 커넥터 vhost 정책을 적용합니다.

   다음 예제에서는 이전 단계에서 구성한 커넥터 vhost 정책을 적용합니다.

   connector {
       host: 192.0.2.10
       port: 5672
       role: normal
       policyVhost: my-connector-policy
   }

절차

1. /etc/qpid-dispatch/qdrouterd.conf 구성 파일에서 address 섹션을 추가합니다.

   address {
       prefix: my_address
       distribution: multicast
       ...
   }

   접두사 | 패턴

   주소 설정을 적용해야 하는 주소 또는 주소 그룹입니다. 주소의 정확한 주소 또는 시작 세그먼트와 일치하도록 접두사를 지정할 수 있습니다. 또는 와일드카드를 사용하여 주소와 일치하는 패턴을 지정할 수 있습니다.

   접두사 는 정확한 주소 또는 . 또는 / 문자로 구분된 주소 내의 시작 세그먼트와 일치합니다. 예를 들어 my_address 접두사는 my_address.1 주소뿐만 아니라 my_address.1 과 my_address/1 과 일치합니다. 그러나 my_address1 과 일치하지 않습니다.

   패턴은 패턴에 해당하는 주소와 일치합니다. 패턴은 . 또는 / 문자로 구분된 일련의 단어입니다. 와일드카드 문자를 사용하여 단어를 나타낼 수 있습니다. * 문자는 정확히 하나의 단어와 일치하며 # 문자는 0개 이상의 단어와 일치합니다.

   * 및 # 문자는 와일드카드로 예약되어 있습니다. 따라서 메시지 주소에 사용해서는 안 됩니다.

   주소 패턴 생성에 대한 자세한 내용은 12.1.5절. “주소 패턴 일치” 을 참조하십시오.

   참고

   /# 을 추가하여 접두사 값을 패턴으로 변환할 수 있습니다. 예를 들어 a/b/c 접두사는 a/b/c/# 패턴과 동일합니다.

   distribution

   메시지 배포 패턴입니다. 기본값은 밸런싱 이지만 다음 옵션 중 하나를 지정할 수 있습니다.

   • 균형 - 주소로 전송된 메시지는 수신자 중 하나로 라우팅되며 라우팅 네트워크는 결제 속도를 기반으로 트래픽 부하를 분산합니다.
   • 가장 가까운 - 주소로 전송된 메시지는 대상에 도달할 수 있는 짧은 경로에 전송됩니다. 즉, 동일한 주소에 대해 여러 수신자가 있는 경우 가장 가까운 수신자만 메시지를 수신하게 됩니다.

   • 멀티 캐스트 - 메시지는 게시/서브스크립션 모델의 주소에 연결된 모든 수신자에게 전송됩니다.

     메시지 배포 패턴에 대한 자세한 내용은 12.1.1.3절. “라우팅 패턴” 을 참조하십시오.

   추가 속성에 대한 자세한 내용은 qdrouterd.conf 매뉴얼 페이지의 address 를 참조하십시오.

2. 주소를 사용해야 하는 다른 라우터에 동일한 주소 섹션을 추가합니다.

   이 라우터 구성 파일에 추가한 주소는 이 라우터가 주소로 전송된 메시지를 배포하는 방법만 제어합니다. 이 주소에 대한 메시지를 배포해야 하는 라우터를 라우터 네트워크에 있는 경우 각 구성 파일에 동일한 주소 섹션을 추가해야 합니다.

절차

1. 해당 연결이 없는 경우 브로커에 발신 연결을 추가합니다.

   대기열이 여러 브로커에 걸쳐 분할되는 경우 각 브로커에 대한 연결을 추가해야 합니다. 자세한 내용은 8.3절. “외부 AMQP 컨테이너에 연결”의 내용을 참조하십시오.

2. 클라이언트가 로컬 트랜잭션을 브로커로 보내려면 트랜잭션 조정자를 위한 링크 경로를 생성합니다.

   linkRoute {
       prefix: $coordinator  

   1

   
       connection: my_broker
       direction: in
   }

   1

   $coordinator 접두사는 이 링크 경로를 트랜잭션 조정자로 설정합니다. 클라이언트가 트랜잭션 세션을 열 때 트랜잭션을 시작하고 종료하라는 요청은 이 링크 경로를 따라 브로커로 전파됩니다.

   AMQ Interconnect는 여러 브로커에 대한 트랜잭션을 라우팅하지 않습니다. 환경에 여러 브로커가 있는 경우 단일 브로커를 선택하고 모든 트랜잭션을 라우팅하십시오.

3. 클라이언트가 이 링크 경로에서 메시지를 보내려면 수신 링크 경로를 생성합니다.

   linkRoute {
       prefix: my_queue
       connection: my_broker
       direction: in
       ...
   }

   접두사 | 패턴

   라우팅된 link-attaches의 대상이어야 하는 브로커 큐와 일치하는 주소 접두사 또는 패턴입니다. 이 접두사 또는 패턴과 일치하는 모든 메시지는 링크 경로를 따라 배포됩니다. 주소의 정확한 주소 또는 시작 세그먼트와 일치하도록 접두사를 지정할 수 있습니다. 또는 와일드카드를 사용하여 주소와 일치하는 패턴을 지정할 수 있습니다.

   접두사 는 정확한 주소 또는 . 또는 / 문자로 구분된 주소 내의 시작 세그먼트와 일치합니다. 예를 들어 my_address 접두사는 my_address.1 주소뿐만 아니라 my_address.1 과 my_address/1 과 일치합니다. 그러나 my_address1 과 일치하지 않습니다.

   패턴은 패턴에 해당하는 주소와 일치합니다. 패턴은 . 또는 / 문자로 구분된 일련의 단어입니다. 와일드카드 문자를 사용하여 단어를 나타낼 수 있습니다. * 문자는 정확히 하나의 단어와 일치하며 # 문자는 0개 이상의 단어와 일치합니다.

   * 및 # 문자는 와일드카드로 예약되어 있습니다. 따라서 메시지 주소에 사용해서는 안 됩니다.

   주소 패턴 생성에 대한 자세한 내용은 12.1.5절. “주소 패턴 일치” 을 참조하십시오.

   참고

   /# 을 추가하여 접두사 값을 패턴으로 변환할 수 있습니다. 예를 들어 a/b/c 접두사는 a/b/c/# 패턴과 동일합니다.

   connection | containerID

   라우터가 브로커에 연결하는 방법 발신 연결(연결) 또는 브로커의 컨테이너 ID(containerID)를 지정할 수 있습니다.

   이 연결을 통해 여러 브로커가 라우터에 연결된 경우 링크 경로의 접두사 또는 패턴과 일치하는 주소에 대한 요청이 브로커 전체에 분산됩니다. 또는 특정 브로커를 지정하려면 containerID 를 사용하고 브로커의 컨테이너 ID를 추가합니다.

   direction

   클라이언트가 이 링크 경로의 라우터 네트워크로 메시지를 보낼 수 있도록 이 속성을 in 으로 설정합니다.

   추가 속성에 대한 자세한 내용은 qdrouterd.conf 매뉴얼 페이지의 linkRoute 를 참조하십시오.

4. 클라이언트가 이 링크 경로에서 메시지를 수신하도록 하려면 발신 링크 경로를 생성합니다.

   linkRoute {
       prefix: my_queue
       connection: my_broker
       direction: out
       ...
   }

   접두사 | 패턴

   라우팅된 링크 연결을 수신하려는 브로커 큐와 일치하는 주소 접두사 또는 패턴입니다. 이 접두사 또는 패턴과 일치하는 모든 메시지는 링크 경로를 따라 배포됩니다. 주소의 정확한 주소 또는 시작 세그먼트와 일치하도록 접두사를 지정할 수 있습니다. 또는 와일드카드를 사용하여 주소와 일치하는 패턴을 지정할 수 있습니다.

   접두사 는 정확한 주소 또는 . 또는 / 문자로 구분된 주소 내의 시작 세그먼트와 일치합니다. 예를 들어 my_address 접두사는 my_address.1 주소뿐만 아니라 my_address.1 과 my_address/1 과 일치합니다. 그러나 my_address1 과 일치하지 않습니다.

   패턴은 패턴에 해당하는 주소와 일치합니다. 패턴은 . 또는 / 문자로 구분된 일련의 단어입니다. 와일드카드 문자를 사용하여 단어를 나타낼 수 있습니다. * 문자는 정확히 하나의 단어와 일치하며 # 문자는 0개 이상의 단어와 일치합니다.

   * 및 # 문자는 와일드카드로 예약되어 있습니다. 따라서 메시지 주소에 사용해서는 안 됩니다.

   주소 패턴 생성에 대한 자세한 내용은 12.1.5절. “주소 패턴 일치” 을 참조하십시오.

   참고

   /# 을 추가하여 접두사 값을 패턴으로 변환할 수 있습니다. 예를 들어 a/b/c 접두사는 a/b/c/# 패턴과 동일합니다.

   connection | containerID

   라우터가 브로커에 연결하는 방법 발신 연결(연결) 또는 브로커의 컨테이너 ID(containerID)를 지정할 수 있습니다.

   이 연결을 통해 여러 브로커가 라우터에 연결된 경우 링크 경로의 접두사 또는 패턴과 일치하는 주소에 대한 요청이 브로커 전체에 분산됩니다. 또는 특정 브로커를 지정하려면 containerID 를 사용하고 브로커의 컨테이너 ID를 추가합니다.

   direction

   이 링크 경로가 수신자임을 지정하려면 이 속성을 out 으로 설정합니다.

   추가 속성에 대한 자세한 내용은 qdrouterd.conf 매뉴얼 페이지의 linkRoute 를 참조하십시오.