Screenshot walkthrough

Detailed AWS IAM setup

This page is screenshots and short captions only. For copy-ready IAM JSON and verify tools, use the Setup page.

  1. 1

    Open IAM

    In the AWS Console search bar, search for IAM, or open IAM from Recently visited.

    Step 1: Open IAM
  2. 2

    Policies

    In the IAM sidebar, choose Policies.

    Step 2: Policies
  3. 3

    Create policy

    Click Create policy.

    Step 3: Create policy
  4. 4

    JSON editor

    Open the JSON tab so you can paste the permission policy document.

    Step 4: JSON editor
  5. 5

    Copy from S3Pixels

    On the S3Pixels Setup page, Step 1, use Copy on the permission policy JSON.

    Step 5: Copy from S3Pixels
  6. 6

    Paste and continue

    In the policy editor, select any sample text, replace it with what you copied from Step 1, then scroll down and click Next.

    Step 6: Paste and continue
  7. 7

    Name the policy

    Enter a policy name (for example S3Pixels-S3Access). Use a name you will recognize when you attach it to the role. Click Next, then create the policy.

    Step 7: Name the policy
  8. 8

    Go to Roles

    After you see the policy created confirmation, open Roles in the IAM sidebar.

    Step 8: Go to Roles
  9. 9

    Create role

    Click Create role.

    Step 9: Create role
  10. 10

    Custom trust policy

    Choose Custom trust policy (not an AWS service shortcut).

    Step 10: Custom trust policy
  11. 11

    Trust policy from S3Pixels

    On S3Pixels Setup, Step 2, copy the trust policy JSON (it includes your External ID when you are signed in).

    Step 11: Trust policy from S3Pixels
  12. 12

    Paste trust policy

    Paste the JSON into the trust policy editor and click Next.

    Step 12: Paste trust policy
  13. 13

    Attach your policy

    Search for the policy name you created earlier, select it, then click Next.

    Step 13: Attach your policy
  14. 14

    Name the role

    Enter a role name you will remember, click Next if prompted, then Create role.

    Step 14: Name the role
  15. 15

    Open the role

    After creation you return to the roles list. Search for or click the role you just created to open its summary.

    Step 15: Open the role
  16. 16

    Copy the Role ARN

    On the role summary page, copy the full ARN (it looks like `arn:aws:iam::123456789012:role/YourRoleName`).

    Step 16: Copy the Role ARN
  17. 17

    Verify in S3Pixels

    On S3Pixels Setup, Step 3, paste the Role ARN and click Verify & Connect.

    Step 17: Verify in S3Pixels
  18. 18

    Connected

    You should see a success state when the role is verified and saved. Use Go to dashboard to continue.

    Step 18: Connected
  19. 19

    Use the workspace

    On the dashboard you will see your connection name and bucket count. Open Manage buckets to list buckets and work with objects.

    Step 19: Use the workspace