Skip to content

Connect to an Amazon S3 data source (CloudFormation Template method)

This guide explains how to connect your Koordinates site to an Amazon S3 bucket, so you can import data from it.

This method uses a CloudFormation template that Koordinates creates for you. We recommend it for most users, and especially if you’re new to AWS. If you’d rather create the access role yourself, see the AWS web console method.

To learn more about CloudFormation, see the AWS CloudFormation documentation.

Instead of giving Koordinates usernames, passwords or other credentials, you create an AWS role and let Koordinates use it. You control the role, so you control exactly what Koordinates can access through it. The template creates a role that can list and read the objects in the bucket you name, and nothing else.

  1. Open the Data Manager

    Select Manage in the navigation menu.

  2. Select New, then Amazon S3

    Select New. The tools menu opens at Data sources. Select Amazon S3 to open the Connect to Amazon S3 Source window.

  3. Enter your bucket name and select Download Template

    Under Create a CloudFormation Template, enter your Amazon S3 Bucket Name, then select Download Template and save the JSON file. You’ll use this file as the template for a CloudFormation stack.

    The window then changes to the form where you’ll paste your role’s ARN. Leave it open while you work in AWS.

  4. Create a stack in the AWS CloudFormation console

    In a new browser tab, open the AWS CloudFormation console and start creating a stack (see Creating a stack in the CloudFormation console). When you’re asked for a template, choose to upload a template file and select the JSON file from step 3.

  5. Name your stack and create it

    The name can be anything you like. You don’t need to change any of the other settings. Acknowledge that the stack creates an IAM resource, then create the stack.

  6. Copy the role ARN

    When the stack has been created, open it and select the Outputs tab. Copy the value of RoleARN.

    The Outputs tab of a CloudFormation stack, showing the RoleARN value

  7. Paste the role ARN into Koordinates

    Go back to the Connect to Amazon S3 Source window and paste the value into IAM Role ARN. Check that Amazon S3 Bucket Name is your bucket.

    If you only want Koordinates to scan part of the bucket, enter a Prefix. Koordinates will ignore everything outside it. Leave Prefix blank to scan the whole bucket.

    Select Next.

  8. Add a title and owning group, then select Connect

    Give the source a meaningful Title, and choose its Owning Group. Members of the owning group can configure the source, run scans and import data from it.

    Select Connect. Koordinates connects to the bucket and starts scanning it. After a few seconds you’re taken to the source, where you can import the data it finds.

To change the source’s details or connection later, open it on the Sources tab and select Settings.