Integrate a marketplace with an Amazon Web Services account

This section describes how Marketplace Managers link their Amazon Web Services account to their marketplace. They need to collaborate with AppDirect to do this.

You must complete the procedures below in the correct order, and then contact your AppDirect technical representative. We do a number of setups on our side to complete the integration process.

Collect the following information on the AWS portal:

Item	Value
Root AWS Account ID
Root AWS Account Email
IAM user Access key ID
IAM user Secret access key

Complete the following procedures in the order below:

Create an AWS account

1. Go to the AWS portal.
2. Create a Root user account.
3. Verify and activate your account. See How do I create and activate a new AWS account?

Create an IAM user

1. Go to the AWS Management console.
2. Sign in as a Root user.
3. Select IAM.
4. In Users click Add user.
   1. In section Set user details, add a User name: AppDirect-api-credentials
   2. In section Select AWS access type, select Programmatic access.
   3. Click Next: Permissions.
   4. In Set permissions for {User name}, click Attach existing policies directly.
   5. In section Policy type, select Administrator Access.
   6. The Complete page displays the {User name}, Access key ID and Secret access key. Click Show to view the Secret access key. Note that this is the only time the credentials are displayed unmasked.
   7. Click Close.

Check information on the AWS console

You need to check some settings on the AWS console. This will ensure we can complete the integration process for your marketplace and your Amazon Web Services account.

Check the following information on the AWS console:

• Your account does not belong to any organization from the Organization Management Console.
• You have access to the S3 Management Console and ensure that you can create S3 Buckets.
• You have access to S3 Management Console and no S3 bucket exists with the name daily-billing-report-<some_id>.
• You have access to Billing Reports Management Console, and there's no AWS Usage and Cost report listed.

Link an AWS account with the marketplace

1. Log in to the marketplace as a Marketplace Manager.
2. Go to Manage > Marketplace > Settings > Vendor Integration.
3. Click Configure in theAmazon Web Servicessection to open the configuration page.
4. Click Add Organization.

5. Add your organization details.

   1. Account ID - the unique ID from your AWS account. For more information, click here.
   2. Region - the region for your AWS account. For more information, click here.
   3. AWS API key - the API Key created in the Root Account setup during the 'Create an IAM user'procedure.
   4. AWS API Secret - the API secret created in the Root Account setup during the 'Create an IAM user' procedure.
   5. NEW ACCOUNT EMAIL PATTERN - when creating new accounts under the AWS Organization, a new email address is generated from a configured pattern. To achieve this, the configured pattern should be in the following format:

   <Suffix>+%s@<Domain>

   Example: Pattern: appdirect-account+%s@appdirect.comGenerated Member account emails:appdirect-account+1cc0c520-b@appdirect.com,appdirect-account+5fg67sda-3@appdirect.com

   6. Set as Default Organization - all member accounts are created under the default organization unless mentioned otherwise during checkout.

   

6. Verify that the organization is correctly listed on the Organizations page.

   

7. Use Edit functionality to update the following if any changes are required:

   • API Key
   • API Secret
   • Email Pattern
   • Default Organization