AWS permissions required for Amazon S3 external content connector permission modes

reference australia Updated Oct 29, 2026 1 min read amazon-s3-required-permissions-external-content-connector.md
Raw file servicenow.com

The Identity and Access Management (IAM) user for an Amazon S3 external content connector requires Amazon S3 and IAM permissions that depend on the permission mode.

Permissions by mode

Grant the permissions in the following table to the Identity and Access Management (IAM) user whose access key the connector uses. To learn how to create this user and its policy, see Configure Amazon S3 for external content indexing. To learn about the modes, see Amazon S3 external content connector permission modes.

Permission mode

Required permissions

All modes

  • s3:GetBucketLocation
  • s3:GetObject
  • s3:ListBucket

Standard user permission crawl

The permissions for all modes, plus the following permissions:- iam:GetGroup

  • iam:GetGroupPolicy
  • iam:GetPolicy
  • iam:GetPolicyVersion
  • iam:ListAttachedGroupPolicies
  • iam:ListGroupPolicies
  • iam:ListGroups
  • iam:ListRoles
  • iam:ListUsers
  • s3:GetBucketPolicy

User permission crawl with a connector-created group of all retrieved users

The permissions for all modes, plus iam:ListUsers.

No user permission crawl with an existing group

The permissions for all modes. This mode requires no IAM permissions.

**Important:** In the standard user permission crawl, if the connector can't list IAM users and roles, it can't resolve the principals in a bucket policy. In that case, the connector indexes no content from the affected buckets. If the connector can't read the policy for a bucket, for example because `s3:GetBucketPolicy` is denied, no user can see content items indexed from that bucket.

Parent Topic:Amazon S3 external content connector

Related topics

Amazon S3 external content connector permission modes

Configure Amazon S3 for external content indexing

Keywords ServiceNow OttoAI Agentsgenerative AIagentic AI
Search documentation
Search document titles and file paths on the australia branch