Skip to main content

AWS Config Page

In the AWS Credentials and Storage Settings page, workspace administrators can define the AWS credentials mode for the workspace and apply settings for the selected mode, including selecting the credential provider. From the left menu, select Settings > AWS Config.

AWS Mode:

Mode

Description

Workspace

In Workspace mode, the workspace administrator applies a single set of AWS credentials for all users in the workspace. These credentials are used by each member of the workspace to authenticate with AWS and to gain access to S3 buckets.

Tip

This mode requires more up-front setup but is easy to manage. However, all members of the workspace have the same set of access controls.

Per User

In Per User mode, individual members of the workspace must apply their AWS credentials to their accounts.

Tip

This mode is easy to set up but turns responsibility for access controls over to the individual members. If members encounter problems gaining access to S3 assets, the workspace administrator may not be able to troubleshoot them.

Credential Provider:

For workspace or per-user mode, the following provider methods can be used to manage authentication with AWS.

Credential Provider

Description

IAM Role

The Alteryx Analytics Cloud can use any IAM roles that have been defined for workspace members to access S3 data sources.

Tip

This credential provider method is recommended.

AWS Key and Secret

You can apply key and secret combinations to gate access to S3 data sources. These combinations can be applied in workspace mode or in per-user mode by individual members.

Workspace Mode

In workspace mode, you must select the credential provider and then specify the relevant settings.

IAM Role Settings

Pre-requisites:

  • The IAM roles must include a trust relationship for the the Alteryx Analytics Cloud. For more information, see Insert Trust Relationship in AWS IAM Role.

  • If you want workspace members to be able to use the on-boarding tour, they must have access to the Alteryx assets required for the tour.

Apply the following settings to define the IAM roles and related settings.

Setting

Description

Account ID

This value is pre-populated when the workspace is created.

Note

Do not modify.

External ID

This value is pre-populated when the workspace is created.

Note

Do not modify.

Available IAM Role ARNs

You can specify the set of IAM Role ARNs from which users can select for their access to AWS resources.

Select Default IAM Role ARN

From the available IAM Role ARNs, you can specify the default one.

AWS Key and Secret Settings

For key-secret authentication to AWS, please specify the following settings.

Note

The AWS key and secret must provide read/write access to the default S3 bucket at least.

Note

The account must have the ListAllMyBuckets ACL among its permissions.

Setting

Description

AWS Access Key

The AWS access key to use.

AWS Secret Key

The AWS secret associated with the access key.

Per-User Mode

For per-user mode:

  • The workspace administrator must specify the encryption settings only. See below.

  • Individual users configure all of the other AWS access settings through the Storage configuration page.

Common Settings

S3 Buckets

For key-secret authentication to AWS, please specify the following settings.

Setting

Description

Default S3 bucket

Specify the name of the default S3 bucket.

Note

Specify the top-level bucket name only. There should not be any backslashes in your entry.

Extra S3 buckets

You can specify any additional S3 buckets in a comma-separated list of names.

Server-side Encryption

The Alteryx Analytics Cloudsupports the use of server-side encryption when writing results.

Note

When encryption is enabled, all buckets to which you are writing must share the same encryption policy.

Setting

Description

Encryption Type

Supported encryption types:

Note

If None is selected here, AWS S3 still applies server-side encryption to the bucket without impact to cost or performance. For more information, see https://docs.aws.amazon.com/AmazonS3/latest/userguide/default-bucket-encryption.html.

  • None

  • SSE-S3

  • SSE-KMS

KMS Key ID

If SSE-KMS has been selected, you can paste the KMS Key ID value in this field.