by nccgroup

nccgroup / G-Scout

Google Cloud Platform Security Tool

204 Stars 47 Forks Last release: Not found GNU General Public License v3.0 68 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


G-Scout is a tool for auditing Google Cloud Platform configurations. By making API calls, applying security rules, and generating HTML files based on the output, G-Scout makes it easy to analyze the security of a GCP environment.

There are two ways for the project owner to grant API permissions: 1. User Account: 1. Use an account with Viewer and Security Reviewer permissions on the project (may require the project to activate the Google Identity and Access Management API, which can be done in the console). 2. Approve the Oauth2 authentication request when prompted in your browser. 2. Service Account: 1. Go to the console service accounts page at https://console.cloud.google.com/iam-admin/serviceaccounts/project?project=[project] and create a service account. 2. Go to IAM management console at https://console.cloud.google.com/iam-admin/iam/project?project=[project] and add Security Reviewer and Viewer permissions to the service account created in step 1. 3. Generate a Service Account key from https://console.cloud.google.com/apis/credentials?project=[project]. 4. Place the JSON file (named keyfile.json) generated in step 3 into the application directory. 5. Set the environment variable

to the path of the JSON file downloaded. Or use the SDK to run
gcloud auth application-default login

To run the application:

virtualenv -p python2 venv
source venv/bin/activate
pip install -r requirements.txt
python gscout.py -h

The HTML report output will be in the "Report Output" folder.

When specifying the project name you can also use a wildcard to run G-Scout on multiple projects, for example:

python gscout.py --project-name "dev-*"
. You can also run G-Scout on all projects in an organization like this:
python gscout.py --organization "organization id"
, where the id will be a number you can find next to the organization name in the GCP console.

To create a custom rule, add it to the rules.py file. A Rule object takes a name, a category, and a filter function. The function will be passed a json object corresponding to the category. To see an example for each category (some of which are altered from the standard API response), see the entity_samples.json file.


python x_project.py
will create a file showing all results across all projects G-Scout has been run on for each finding specified. Change the items in the list of rule names in
to specify which rules to generate the files for.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.