Skip to main content
Forge assumes a customer-owned cross-account IAM role to discover AI resources and workload metadata across selected AWS accounts and regions. Runtime and enforcement coverage depend on which AWS control points you configure in addition to the inventory connection.

Coverage

Workload collection reads metadata and environment-variable names, not secret values.

Connection

The generated setup artifact grants the current read paths used by Forge. Equivalent custom policies need:
Workload attribution additionally uses ecs:ListClusters, eks:ListClusters, lambda:ListFunctions, iam:GetRole, and iam:ListAttachedRolePolicies. Cloud artifact discovery and image acquisition use ecr:DescribeRepositories, ecr:ListImages, ecr:BatchGetImage, ecr:GetDownloadUrlForLayer, and ecr:GetAuthorizationToken. S3 data labels are optional and require s3:GetBucketTagging, s3:GetObjectTagging, s3:GetBucketLocation, and s3:ListAllMyBuckets. Restrict object-tag access to approved buckets when using a custom policy.

Setup

  1. Open Settings → Integrations → Amazon Web Services, enter the regions, Role ARN, and generated External ID, then open Guided setup.
  2. Deploy the role in every account in scope, then save its ARN, external ID, and region list in Forge.
  3. Select Test. Forge validates role assumption and the enabled service reads independently.
  4. Select Sync and confirm account- and region-specific counts in Inventory.
  5. Enable Bedrock model invocation logging separately if direct model-call telemetry is required.
Guided setup offers AWS CLI, Terraform, and CloudFormation. Review the trust policy principal, External ID, account, regions, and optional S3 resources before applying it. Enabling the optional runtime-logging checkbox creates a separate Bedrock invocation-logging role and log group; it does not change the Forge cross-account role into a write role.

Operator access and artifact scanning

Native NHI containment, identity rightsizing, and Agent access use a separate operator or broker connection. The inventory role remains read-only. Guided setup generates the bounded trust, permission policy, validation, and offboarding artifacts for the selected purpose. ECR image scanning uses the registry permissions above. Filesystem snapshot scanning is opt-in and additionally requires an exact scanner AMI for every selected region plus the generated, tag-constrained EC2, EBS snapshot, instance-profile, network-interface, and cleanup permissions. See Cloud artifact scanning.

Runtime

Forge provides validation and integration artifacts for signed Bedrock Agent invocation, RETURN_CONTROL, and AgentCore Gateway policy handoff.

Verification

If inventory is partial, inspect the per-service permission result rather than expanding the role globally. A successful Bedrock read does not prove AgentCore, workload, log, or S3-tag access.