Amazon S3

Connect to a bucket in Amazon S3 to browse and visualize your raster data in Felt.

  1. Click on the Library () in the toolbar

  2. Click + New Source

  3. Select Amazon S3

  4. Fill in the Connection Details

    1. Source Name: name of the source in Felt

    2. GS URI: a URL to a bucket in Amazon S3, such as s3://my-storage-bucket/my_prefix. If the URL contains a prefix (in this example, my_prefix, Felt will only search for objects that start with it.

    3. Credentials: see the following Authentication section.

  5. Who can see this source?: control access to this source within Felt

  6. Click Connect

  7. Once connected you will see a catalog of your data with previews for your new source

  8. From here you can add any of these layers to your spatial dashboards!

Authentication

For private S3 buckets, you will need to allow Felt to assume an IAM role on your account:

  • Create a policy that allows listing and reading objects in the S3 buckets where your assets are located. It should be able to perform the following actions:

    • s3:GetObject

    • s3:GetObjectVersion

    • s3:ListBucket

    • s3:GetBucketLocation

  • Create an IAM role and attach the aforementioned policy to it.

  • Create a Trust Relationship for said role that allows Felt to access your assets. Make sure to include all the principals listed below:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::949302143999:root",
                    "arn:aws:iam::452667257775:root",
                    "arn:aws:iam::375127086520:root",
                    "arn:aws:iam::033636008376:root"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Metadata extraction

Felt can extract metadata properties from the filepaths to objects in your bucket. Learn more in Organizing your raster data.

Last updated

Was this helpful?