The Checks CLI brings the functionality of Checks into your development workflow. You can run the CLI locally, in your CI/CD pipeline, or through other types of scripts and automation.
Setting up and using the Checks CLI requires the following steps:
- Install the Checks CLI
- Authenticate your machine
- Integrate and use the Checks CLI by running commands from the command line or integrating the Checks CLI into your CI/CD environment.
Set up the Checks CLI
You can install or update the Checks CLI by using the standalone executables in the tables for either Linux or macOS.
After you install the Checks CLI, you must authenticate. Then you can get started testing and fixing your vulnerabilities, beginning with testing your installation.
Install with standalone executables
Checks provides standalone executable download links for the latest release and for specific versions. The following links, for example, are for macOS and Linux:
- https://dl.google.com/checks/cli/latest/checks-macos
- https://dl.google.com/checks/cli/v0.1.0/checks-linux
For example, to download and run the latest Checks CLI on macOS, run:
curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/
- Make sure you've installed your package manager and any required third-party tools.
- Download the Checks CLI binary for your platform:
Linux
Platform |
Package |
Size |
SHA256 Checksum |
Linux |
25.1 MB |
8d6a8fed12c04bf1f42a44201d031f4a3143cc3ea153fceeecaf2847bfe8e1f0 |
Make the binary executable by running chmod +x ./checks
. (Optional) Move
the binary to a location where you can execute it globally: mv ./checks
/usr/local/bin/
macOS
Platform |
Package |
Size |
SHA256 Checksum |
macOS |
20.3 MB |
4d51caa010fd05629350f8cc634a1565132aaf2743c40067bdabd6114d629251 |
Make the binary executable by running chmod +x ./checks
(Optional) Move
the binary to a location where you can execute it globally: mv ./checks
/usr/local/bin/
Windows
Platform |
Package |
Size |
SHA256 Checksum |
Windows 8.1 and later and Windows Server 2012 and later |
20.3 MB |
9ff5a9c78b592135a6ef355359fa6d0025e19068161626604554094d8c50ed00 |
(Optional) Rename the file to checks.exe
so you can run checks commands
as documented, for example, checks help
.
Update to the latest CLI version
To make sure you're getting the newest features and bug fixes, we recommend you frequently check for updates to the CLI.
You can download the new version from the preceding tables, and then replace the previous version on your system.
Test your installation
After authenticating, you can test your installation. For a quick test, run
checks --help
.
Additional information
Run checks --help
or see the CLI commands and options summary.
Getting support
Send an email to [email protected] whenever you need help with the Checks CLI or Checks in general.
Authenticate the CLI
After installing the CLI, you must sign in to a Google Account. To authorize the Checks CLI's access to Checks, use either a service account or user account.
A service account is a Google Cloud account associated with your Google Cloud project and not a specific user. Service accounts are useful for setting up Checks in a CI environment.
A user account is a Google Account that has access to your Checks account. This is the best option for using the Checks CLI from your command line.
Authenticate with a service account
- Open the Google Cloud console and select your project.
- In the API Library, enable the Checks API.
- Create a service account for your project by navigating to the IAM Service
Accounts page in Google Cloud Console. Click
Create Service Account and enter service account details.
- Create a private JSON key for your newly created service account and move the key to a location accessible to your build environment. Be sure to keep this file somewhere safe, because it grants administrator access to Checks.
- Set the environment variable
CHECKS_CREDENTIALS
to the path of your private key JSON file.
- To grant the Service Account access to your Checks account, add the email address and give it the Owner role on the Checks Console Settings page. For more information on inviting users to your Checks account, see Managing team access.
Authenticate with a user account
Important: If you're connecting through SSH, forward port 9005.
Sign in to Firebase using your Google Account with the following command:
checks login
This command connects your local machine to Checks and grants you access to your Checks accounts.
- Use
checks login --reauth
if you have previously signed in, but want to switch to a different Google Account. - Use
checks logout
to sign out.
- Use
Open the generated authentication URL in the browser.
Sign in to your Google Account.
Give consent to Checks to access your Checks account.