github-repo

Mondoo GitHub Repository Action

A GitHub Action for using Mondoo to scan GitHub repositories for security misconfigurations such as branch protection, CI tests, required code-review, and more. This Action can be used to audit individual GitHub repositories.

Permissions

Depending on the amount that should be covered, you need to provide the proper permissions to the token. Since Mondoo only reads values, only read only permissions are required.

Permission	Description
repo	Ability to read configuration, required since GitHub does not provide a repo:read permission
workflow	eg. allows the verification of workflow settings
read:packages	e.g. allows to verify that packages are not public

Properties

The GitHub repository Action has properties that are passed to the action using with.

Property	Required	Default	Description
repository	true		GitHub Repository eg. mondoohq/actions
token	true		GitHub token used for authentication
log-level	false	info	Sets the log level: error, warn, info, debug, trace (default "info")
output	false	compact	Set the output format for scan results: compact, yaml, json, junit, csv, summary, full, report (default "compact")
score-threshold	false	0	Sets the score threshold for scans. Scores that fall below the threshold will exit 1. (default "0" - job continues regardless of the score returned by a scan).
service-account-credentials	true		Base64 encoded service account credentials used to authenticate with Mondoo Platform
is-cicd	false	true	Flag to disable the auto-detection for CI/CD runs. If deactivated it reports into the Fleet view
service-account-credentials	false		Base64 encoded service account credentials used to authenticate with Mondoo Platform. You can also use the environment variable mentioned below.

Additionally, you need to specify the service account and GitHub credentials as an environment variable.

Environment	Required	Default	Description
MONDOO_CONFIG_BASE64	true		Base64 encoded service account credentials used to authenticate with Mondoo Platform
GITHUB_TOKEN	true		GitHub token used for authentication

Scan GitHub Repository

You can use the Action as follows:

name: Scan GitHub repository
on: push

jobs:
  scan-github-repo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: mondoohq/actions/[email protected]
        env:
          MONDOO_CONFIG_BASE64: ${{ secrets.MONDOO_SERVICE_ACCOUNT }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          repository: ${{ GITHUB_REPOSITORY }}