@cloud-copilot/iam-convert v0.1.22

iam-convert: Convert JSON Policy Documents to Infrastructure as Code

CLI and Node Library to convert JSON IAM Policy Documents to other formats for Infrastructure as Code.

Available Formats

• Terraform (tf) - an aws_iam_policy_document data source
• CloudFormation (cf) - a PolicyDocument resource in yaml
• Typescript CDK (cdk-ts) - an iam.PolicyDocument from AWS CDK V2 aws-cdk-lib/aws-iam
• Python CDK (cdk-py) - a PolicyDocument using AWS CDK V2 aws_cdk.aws_iam

Use in Browser

https://iam.cloudcopilot.io/tools/iam-convert

Installation

# Install the CLI
npm install -g @cloud-copilot/iam-convert

## Install the Node Library
npm install @cloud-copilot/iam-convert

CLI Usage

# Convert a JSON policy document to terraform and send to stdout
iam-convert --file path/to/policy.json

# Download a policy and convert it to terraform
curl "https://government-secrets.s3.amazonaws.com/secret-policy.json" | iam-convert > secret-policy.tf

# View all options
iam-convert --help

Typescript/Javascript Usage

import { convert } from '@cloud-copilot/iam-convert'
import { loadPolicy } from '@cloud-copilot/iam-policy'

const policy = {
  Version: '2012-10-17',
  Statement: [
    {
      Effect: 'Allow',
      Action: 's3:GetObject',
      Resource: 'arn:aws:s3:::my-bucket/*'
    }
  ]
}

const terraformDataSource = convert(policy, 'tf')

console.log(terraformDataSource)