This library aims to collect resource-based policies from an AWS account.

yarn add aws-resource-based-policy-collector

or

npm install aws-resource-based-policy-collector

When removing an account from an AWS organisation special attention must be paid to resource-based policies. Specifically, the presence of the aws:PrincipalOrgID condition key will cause access issues once the account leaves it's parent organisation.

This library simply collects resources and their associated policies in an unopinionated manner. The actual analysis of the output is left to the consumers of this library.

Your environment must be configured with valid AWS credentials. See Setting credentials in Node.js. Your credentials must be authorised to perform read-only actions within your account. This can be achieved simply by creating a role in your account with the AWS managed ReadOnlyAccess policy. Naturally, your account must also not have read actions restricted by any service control policies in your organisation hierarchy.

import { collect } from 'aws-resource-based-policy-collector';

const main = async () => {
  const result = await collect();
  // ... Do something with result
};

main();

The AWS region defaults to that of your credentials however you may optionally set this explicitly.

const result = await collect({ region: 'us-east-1' });

The collect function returns an array of objects per-service where each service object contains an array of resource objects. The service object may also contain an optional error field if there was an issue listing resources. This typically ocurrs if your credentials do not have the required permissions to read the resources (or is blocked by an SCP).

Each resource object contains a type and id to uniquly identify the resource as well as a JSON encoded policy. The resource may also contain an optional error field if there was an issue querying the resource or it's policy.

[
  {
    serviceName: 's3',
    resources: [
      {
        type: 'AWS::S3::Bucket',
        id: 'my-bucket',
        policy: '', // Policy document
        error: '', // Only present if an error ocurred
      }
    ],
    error: '', // Only present if an error ocurred
  },
  ...
]

Only resources with policies or errors are included.

This library currently collects resource-based policies for AWS services listed below.

This list of services is taken from the tables found at AWS services that work with IAM, specifically those services with a Yes or Partial in the Resource-based policies column.

• Lambda
• Serverless Application Repository
• ECR
• AWS Backup
• EFS
• S3 Glacier
• S3
• S3 on AWS Outposts
• Cloud9
• CodeArtifact
• CodeBuild
• IAM
• SecretsManager
• ACM Private Certificate Authority
• KMS
• Lex v2
• CloudWatch Logs
• Systems Manager Incident Manager
• Systems Manager Incident Manager Contacts
• API Gateway
• VPC (endpoints)
• Elemental MediaStore
• OpenSearch
• Glue
• EventBridge
• EventBridge Schemas
• SNS
• SQS
• IoT
• SES v2

AWS RAM does not support resource-based policies however it is included as it is likely of interest as resources may be shared with the parent organisation.

Note the policy field for this resource type is NOT a JSON policy rather it is an arn of the principal the resource is shared with.

If you are getting AccessDenied errors on S3 bucket resources your bucket likely has a bucket policy preventing access. Remove the bucket policy or modify it to grant read access to your role.