To enable Xplenty access to your S3 data, you need to perform the following steps:
- In AWS's IAM (Identity and Access Management) module, create a user account for working with Xplenty.
- In IAM, save the user account's security credentials for later use when defining a connection in Xplenty.
- In IAM, attach a user policy (provided by Xplenty) to the newly-created user account.
- In Xplenty, create a connection using the IAM security credentials you saved previously.
Each of these steps are detailed below.
Note: To enable Xplenty to operate with S3:
- never use an underscore in an S3 bucket name.
- never end an S3 bucket name with a dash.
Watch this short video tutorial or read below for textual instructions:
To create a user account in IAM
- Log into the AWS Management Console.
- Click Identity & Access Management (also known as IAM).
- On the left navigation bar, click Users.
- Click Add User.
- Enter a user name, such as Xplenty, and make sure the check box Programmatic access is selected. Click Next: Permissions to proceed.
- Click Create User. A user account with security credentials is created.
To save user security credentials
Click Download .csv and save the credentials.csv file for later when you will need to configure Xplenty to work with S3.
Click Close to close the window.
Creating new security credentials for a user
Note: Perform this step if in the procedure to save user security credentials above, any of the user account security credential keys contain a slash, or if you cannot find the credentials.csv file you saved.
- In the list of users, click the user you created for working with Xplenty, then scroll down to Security credentials , and then click Make inactive.
- Click Create access key
Continue from Step 1 in to download and save user security credentials above.
To attach an Xplenty user policy to the IAM user account
- In the list of users, click the user you created for working with Xplenty, then scroll down to Add permissions.
- Click Attach existing policies directly.
- In the search box, search 's3 ...'.
- For read-only buckets, check AmazonS3ReadOnlyAccess
For read-write buckets, Click create policy. Choose JSON, then Copy the following policy and replace "your-bucket" with your bucket name:
Then click Review policy. On the next page, click Create policy.
For more information, refer to AWS IAM documentation on the web
To create an Amazon S3 connection in Xplenty:
- Click the Connections icon (lightning bolt) on the top left menu.
- To create a connection, click New connection.
- Choose Amazon S3.
- Type a name for the connection, then from the credentials.csv file you previously saved in To save user security credentials above, copy the Access key id and Secret access key into the respective fields.
- If the S3 buckets reside in a region that requires AWS Signature v4, fill in the region for the connection. See region list here.
- Click Test connection. If the credentials are correct, a message that the connection test was successful appears.
- Click Create amazon s3 connection.
- The connection is created and appears in the list of connections.
- Now you can create a package and test it on your actual data stored in S3.