Before you create a destination to start transferring data to your Amazon S3 Bucket, see these prerequisites.
Once you've made sure all prerequisites are met, see our guide for How to configure a data destination.
Prerequisites for creating a destination
1. You need an existing Amazon S3 Bucket and the Access key of your AWS user. If you don’t have the access key, please contact your AWS admins or create the access key yourself: in the AWS console go to My Security Credentials → Create access key.
- NOTE: Store the Access key ID and Secret Key in a secure location where you can access them – you will need them to create destinations at team.supermetrics.com.
2. Sufficient permissions
- You need to have at least the permission putObject for the S3 bucket, or subfolder within a bucket, that you want to use as the destination. Ideally, your AWS user should also have the deleteObject permission, so the empty file generated by clicking on “Test” in the Supermetrics destination setup is automatically removed from the bucket or subfolder. If you aren't sure about your permissions, please contact your AWS admins.
- See more information about S3 permissions in AWS documentation: Amazon S3 Actions.
3. IP whitelisting is needed if your IAM policy only allows requests coming from certain IP addresses.
- To modify the IAM settings, you need to have at least IAM permissions CreateAccessKey and ListAccessKeys.
- For detailed instructions for IP whitelisting, see AWS S3 documentation: Limiting Access to Specific IP Addresses.
- You or your AWS Admin can add the following Supermetrics IP addresses to the Source IP under Request Conditions in the IAM policy of your AWS user:
- NOTE: Do not forget to add your own IP address to avoid getting “locked out”.
Alternatively, your AWS Admin or you can use the following IAM policy template to grant the needed permissions for the Supermetrics integration.
- NOTE: You need to replace <BUCKET_NAME>, <SUBFOLDER_NAME> and <YOUR_OWN_IP_ADDRESS>.