Menu
Amazon MQ
Developer Guide

Setting Up Amazon MQ

Before you can use Amazon MQ, you must complete the following steps.

Step 1: Create an AWS Account and an IAM Administrator User

To access any AWS service, you must first create an AWS account. This is an Amazon account that can use AWS products. You can use your AWS account to view your activity and usage reports and to manage authentication and access.

  1. Navigate to the AWS home page, and then choose Create an AWS Account.

  2. Follow the instructions.

    Part of the sign-up procedure involves receiving a phone call and entering a PIN using the phone keypad.

  3. When you finish creating your AWS account, follow the instructions in the IAM User Guide to create your first IAM administrator user and group.

Step 2: Create an IAM User and Get Your AWS Credentials

To avoid using your IAM administrator user for Amazon MQ operations, it is a best practice to create an IAM user for each person who needs administrative access to Amazon MQ.

To use the Amazon MQ REST API, you need AWS credentials that are associated with your IAM user. These credentials are comprised of an access key ID and a secret access key. For more information, see What Is IAM? in the IAM User Guide and AWS Security Credentials in the AWS General Reference.

  1. Sign in to the AWS Identity and Access Management console.

  2. Choose Users, Add user.

  3. Type a User name, such as AmazonMQAdmin.

  4. Select Programmatic access and AWS Management Console access.

  5. Set a Console password and then choose Next: Permissions.

  6. On the Set permissions for AmazonMQAdmin page, choose Attach existing policies directly.

  7. Type AmazonMQ into the filter, choose AmazonMQFullAccess, and then choose Next: Review.

  8. On the Review page, choose Create user.

    The IAM user is created and the Access key ID is displayed, for example:

    AKIAIOSFODNN7EXAMPLE

  9. To display your Secret access key, choose Show, for example:

    wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

    Important

    You can view or download your secret access key only when you create your credentials (however, you can create new credentials at any time).

  10. To download your credentials, choose Download .csv. Keep this file in a secure location.

Step 3: Get Ready to Use the Example Code

The following tutorials show how you can work with Amazon MQ and ActiveMQ using the AWS Management Console and Java. To use the example code, you must install the Java Standard Edition Development Kit and make some changes to the code.

You can also create and manage brokers programmatically using Amazon MQ REST API and AWS SDKs.

Next Steps

Now that you're prepared to work with Amazon MQ, get started by creating a broker and then connecting a Java application to your broker.