https://github.com/xen0l/iam-lint

Github action for linting AWS IAM policy documents
https://github.com/xen0l/iam-lint

aws iam security

Last synced: 2 months ago
JSON representation

Github action for linting AWS IAM policy documents

• Host: GitHub
• URL: https://github.com/xen0l/iam-lint
• Owner: xen0l
• License: mit
• Created: 2020-01-17T22:55:18.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-20T03:48:13.000Z (almost 2 years ago)
• Last Synced: 2024-10-11T15:47:04.204Z (3 months ago)
• Topics: aws, iam, security
• Language: Shell
• Size: 24.4 KB
• Stars: 35
• Watchers: 2
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-actions - Linting your AWS IAM policy documents for correctness and security issues
• fucking-awesome-actions - Linting your AWS IAM policy documents for correctness and security issues
• awesome-workflows - Linting your AWS IAM policy documents for correctness and security issues

README

        
# iam-lint

Github action for linting AWS IAM policy documents

## Inputs

### `path`

Path to folder with IAM policy document files that is passed to 'find' command.  This should be a shell glob expression.

**Required:** False

**Default:** '.'

### `file_suffix`

IAM policy document file suffix

**Required"** False

**Default:** 'json'

### `minimum_severity`

Minimum severity of findings to display (passed to [parliament](https://github.com/duo-labs/parliament)).

**Required:** False

**Default:** ''

### `config`

Custom config file (passed to [parliament](https://github.com/duo-labs/parliament)).

**Required:** False

**Default:** ''

### `private_auditors`

Private auditors path (passed to [parliament](https://github.com/duo-labs/parliament)).

**Required:** False

**Default:** ''

## Example usage

### Without specifying a path

```

- uses: actions/checkout@v2

- uses: xen0l/iam-lint@v1

```

### With specifying a path

```

- uses: actions/checkout@v2

- uses: xen0l/iam-lint@v1

  with:

    path: 'policies'

```

## Credits

This action would not be possible without [parliament](https://github.com/duo-labs/parliament). Special thanks goes to [Scott piper](https://github.com/0xdabbad00) and other contributors.