https://github.com/aquasecurity/tfsec-pr-commenter-action
Add comments to pull requests where tfsec checks have failed
https://github.com/aquasecurity/tfsec-pr-commenter-action
hacktoberfest pr pr-comment tfsec tfsec-checks
Last synced: 9 months ago
JSON representation
Add comments to pull requests where tfsec checks have failed
- Host: GitHub
- URL: https://github.com/aquasecurity/tfsec-pr-commenter-action
- Owner: aquasecurity
- License: mit
- Created: 2020-10-29T09:56:56.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-09-20T07:49:40.000Z (almost 3 years ago)
- Last Synced: 2025-05-19T21:39:49.873Z (about 1 year ago)
- Topics: hacktoberfest, pr, pr-comment, tfsec, tfsec-checks
- Language: Go
- Homepage:
- Size: 580 KB
- Stars: 167
- Watchers: 6
- Forks: 65
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tfsec-pr-commenter-action
Add comments to pull requests where tfsec checks have failed
To add the action, add `tfsec_pr_commenter.yml` into the `.github/workflows` directory in the root of your Github project.
The contents of `tfsec_pr_commenter.yml` should be;
> **Note**: The GITHUB_TOKEN injected to the workflow will need permissions to write on pull requests.
>
> This can be achieved by adding a permissions block in your workflow definition.
>
> See: [docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs](https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs)
> for more details.
```yaml
name: tfsec-pr-commenter
on:
pull_request:
jobs:
tfsec:
name: tfsec PR commenter
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: write
steps:
- name: Clone repo
uses: actions/checkout@master
- name: tfsec
uses: aquasecurity/tfsec-pr-commenter-action@v1.2.0
with:
github_token: ${{ github.token }}
```
On each pull request and subsequent commit, tfsec will run and add comments to the PR where tfsec has failed.
The comment will only be added once per transgression.
## Optional inputs
There are a number of optional inputs that can be used in the `with:` block.
**working_directory** - the directory to scan in, defaults to `.`, ie current working directory
**tfsec_version** - the version of tfsec to use, defaults to `latest`
**tfsec_args** - the args for tfsec to use (space-separated)
**tfsec_formats** - the formats for tfsec to output (comma-separated)
**commenter_version** - the version of the commenter to use, defaults to `latest`
**soft_fail_commenter** - set to `true` to comment silently without breaking the build
### tfsec_args
`tfsec` provides an [extensive number of arguments](https://aquasecurity.github.io/tfsec/latest/guides/usage/), which can be passed through as in the example below:
```yaml
name: tfsec-pr-commenter
on:
pull_request:
jobs:
tfsec:
name: tfsec PR commenter
runs-on: ubuntu-latest
steps:
- name: Clone repo
uses: actions/checkout@master
- name: tfsec
uses: aquasecurity/tfsec-pr-commenter-action@v1.2.0
with:
tfsec_args: --soft-fail
github_token: ${{ github.token }}
```
### tfsec_formats
`tfsec` provides multiple possible formats for the output:
* default
* json
* csv
* checkstyle
* junit
* sarif
* gif
The `json` format is required and included by default. To add additional formats, set the `tfsec_formats` option to comma-separated values:
```yaml
tfsec_formats: sarif,csv
```
## Example PR Comment
The screenshot below demonstrates the comments that can be expected when using the action
