GitHubSecurityLab / actions-permissions

GitHub token permissions Monitor and Advisor actions

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GitHub token permissions Monitor and Advisor actions (PUBLIC BETA)

Logo

demo.mp4

Applying the least privilege permissions to a GitHub Actions workflow is a best security practice, but can be challenging as it may break existing workflows.

The Monitor action, when added to a workflow, tracks the usage of the temporary GitHub repository token and gives recommendations on the minimum permissions required to run the workflow based on the actual detected workflow activity. Every workflow run generates a summary report with the recommendations. Since some steps or jobs may be skipped based on various conditions, the Advisor action can aggregate and summarize the recommendations from multiple workflow runs.

Workflow run summary with permissions recommendations for every job

The typical scenario is to include the Monitor action in every job of the workflow that doesn't specify permissions explicitly, collect the recommendations from several workflow runs, apply the recommended minimal permissions, and then remove the Monitor action.

Usage

See the Monitor action

See the Advisor action

About

GitHub token permissions Monitor and Advisor actions

License:MIT License


Languages

Language:Python 99.4%Language:JavaScript 0.4%Language:Shell 0.3%