website/reference/integration/activemq_security.md

   1 ---
   2 layout: default
   3 title: ActiveMQ Security
   4 toc: false
   5 ---
   6
   7 [Security]: http://activemq.apache.org/security.html
   8 [Wildcard]: http://activemq.apache.org/wildcards.html
   9 [activemq_config]: /mcollective/deploy/middleware/activemq.html
  10 [mcollective_username]: /mcollective/reference/plugins/connector_activemq.html#configuring-mcollective
  11 [mcollective_tls]: ./activemq_ssl.html#configuring-mcollective-servers
  12
  13 As part of rolling out MCollective you need to think about security. The various examples in the quick start guide and on this blog has allowed all agents to talk to all nodes all agents. The problem with this approach is that should you have untrusted users on a node they can install the client applications and read the username/password from the server config file and thus control your entire architecture.
  14
  15 The default format for message topics is compatible with [ActiveMQ wildcard patterns][Wildcard] and so we can now do fine grained controls over who can speak to what.
  16
  17 General information about [ActiveMQ Security can be found on their wiki][Security].
  18
  19 ## Configuring Security in activemq.xml
  20
  21 [The ActiveMQ config reference][activemq_config] contains all relevant info for configuring security is activemq.xml. The most relevant sections are:
  22
  23 * [Topic and Queue Names](/mcollective/deploy/middleware/activemq.html#topic-and-queue-names) --- Info about the destinations that MCollective uses.
  24 * [Transport Connectors](/mcollective/deploy/middleware/activemq.html#transport-connectors) --- URL structure for insecure and TLS transports.
  25 * [TLS Credentials](/mcollective/deploy/middleware/activemq.html#tls-credentials) --- For use with TLS transports.
  26 * [Authentication](/mcollective/deploy/middleware/activemq.html#authentication-users-and-groups) --- Establishing user accounts and groups.
  27 * [Authorization](/mcollective/deploy/middleware/activemq.html#authorization-group-permissions) --- Limiting access to destinations based on group membership.
  28 * [Destination Filtering](/mcollective/deploy/middleware/activemq.html#destination-filtering) --- Preventing certain messages from crossing between datacenters.
  29
  30
  31
  32 ## Configuring Security in MCollective
  33
  34 MCollective clients and servers need security credentials that line up with ActiveMQ's expectations. Specifically:
  35
  36 * [An ActiveMQ username and password][mcollective_username]
  37 * [TLS credentials, if necessary][mcollective_tls]
  38