Skip to main content

Set Up AWS S3 as Private Data Storage in User Mode

This page guides you through how to set up your Alteryx Analytics Cloud (AAC) workspace with AWS S3 as the Private Data Storage in User mode.

What is User Mode?


Note that Workspace and User modes are specific to Private Data Storage only. Currently, AAConly offers these 2 modes for workspaces set up with AWS S3 as Private Data Storage.

In User mode, admins can declare multiple IAM Roles and assign the appropriate one for each user. Admins can use this feature to give different levels of access rights to different user groups.

Use User mode to govern each user's uploaded files and output results per the IAM policy assigned to each user. This means users can only view and work with their entitled files and folders.

In comparison, Workspace mode assigns the same IAM policy to all users of the workspace. Thereby giving the same access rights to files and folders to all users on the workspace.

These are the order of steps to set up a workspace in User mode:

  1. The admin must enable User mode in the workspace on the Workspace Settings page.

  2. The admin assigns IAM Roles for each existing and newly invited user, along with the default S3 buckets.

    1. Failing to do this locks a user in a state where they must configure storage for themselves to use the application.


Steps for Admin

Switch Workspace to User Mode

By default, all workspaces are in Workspace mode. To change the workspace to User mode, change these settings on the Workspace Settings page:

  1. Go to Profile Menu > Admin Console > Settings.

  2. Set Enable S3 Private Data Storage to Enabled.

  3. Set Default storage environment to S3 Private Data Storage.

  4. Set AWS Account Configuration Mode to User. The workspace immediately switches into User mode.

Configure Storage for Each User

Next, the admin must configure storage for each user on the workspace. This includes existing users on the workspace and new users when they join.

  1. Go to Profile menu > Admin Console > Users.

  2. Select the 3-dot menu next to each user and then select Configure Storage. A pop-up window appears with options to configure storage for the selected user.

  3. Select the Authentication Method and then enter the appropriate information.

    1. Use a cross-account role (IAM role) (Recommended Option)

      1. Available IAM Role ARNs: Enter at least 1 IAM Role ARN.

      2. Default IAM Role ARN: Select an appropriate role from the dropdown. The dropdown populates based on the roles entered in Available IAM Role ARNs. The system validates the Roles for syntax.

      3. Default S3 Bucket: Enter the S3 bucket ID. The system validates this against the Default Role once you select Save. If invalid, you must enter this value again.

    2. Use access keys


      We only recommend this option when the admin trusts that the selected user has access to a bespoke S3 bucket. The user must also have access to the Access Key ID and Secret Access Key for the specific bucket.

      1. AWS Access Key and AWS Secret Key: The user must generate these keys.

        1. From the AWS Services Console, go to Identity and Access Management (IAM).

        2. Go to the User section and then search for the user.

        3. Select the User ID. The following Summary section should allow you to generate an Access Key.

      2. Default S3 Bucket: Enter the S3 bucket ID. The system validates this against the Default Role once you select Save. If invalid, you must enter this value again.

  4. Select Save.


It is important for admins to configure the storage for each user. If admins skip this step, the user won't be able to select the Use a cross-account role (IAM role) option when configuring storage for themselves.


For admins who are also users, they must also configure storage for themselves. To do this, go to Profile menu > Preferences > AWS Credentials.

Use APIs to Configure Storage for Users

Use these APIs to handle bulk storage configurations:

  • createAwsConfig

    • Set credentialProvider to:

      • default: Sets the Authentication Method to Use access keys.

      • temporary: Sets the Authentication Method to Use a cross-account role (IAM role).

Steps for Non-Admin Users

When a user signs in for the first time after the workspace has changed to User mode, they might have additional storage configuration steps.

If the admin has already configured the storage, however, the user shouldn't have additional steps.


If the storage configuration is not as expected by the user, they should contact their admin.

Customize User Storage Configuration

When in User mode, you can edit the existing S3 Private Data Storage configuration.

  • Go to Profile menu > Preferences > AWS Credentials.

  • If the admin set Use a cross-account role (IAM role) as the Authentication Method, you can use the admin's configuration or switch to another appropriate role and S3 bucket.

  • If the admin set Use access keys as the Authentication Method, or didn't configure storage for you, you must set up storage with your own Access Keys.