Setting up AWS Credentials

You’ll need access to your AWS credentials. Specifically the Access Key ID and Secret Key. You can generate these in the AWS Console.

These keys generally look like this:

1. Access Key ID: AKIAIOSFODNN7EXAMPLE
2. Secret Key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

You may also need to provide a Session Token if using SSO.

Your credentials should have all of the appropriate permissions to:

1. Query Amazon Athena
2. List S3 Buckets
3. Save data to the S3 Output Bucket location.

For full use with Amazon S3, you should also have permissions to:

1. List Bucket
2. Get Objects
3. Put Objects
4. Delete Objects

For a list of managed AWS policies you can apply to your user, please go here.

Note

We currently only support IAM user keys, and Session Tokens. We do not support other types of authentication at the moment.

Your credentials are only stored on your device.

1. Open the External Accounts Window

To provide your credentials to Coco Alemana, open the External Accounts... pane, under the top-level Coco Alemana menu.

2. Add a new External Account

Press the “Add Account…” button, or the plus button on the bottom-left hand side of the window.

Select the “Amazon Web Services” option.

3. Connect Credentials

Provide your credentials through one of the many options available.

4. Adjust Settings

You’re able to change several settings such as the AWS Regions you want to search for data, and customize the workgroup and S3 output bucket that Athena will use to store results.