Kevin reportz: Scuba stuffs

Tool Purpose and Functionality

ScubaGoggles assesses whether the configuration of a GWS organization conforms to SCuBA's security baseline policies. It's in alpha development, meaning it's still being refined, and results should be reviewed carefully.

Scope of the Project

The tool primarily focuses on GWS Admin log events to check conformance with SCuBA baseline policies. It includes various Google services like Gmail, Calendar, Groups, Chat, Drive, and Meet. The tool is capable of generating HTML reports indicating whether GWS settings conform to SCuBA's baselines.

Requirements and Setup

Installation involves setting up a Python virtual environment, downloading dependencies, and the Open Policy Agent (OPA) executable. The tool requires OAuth API scopes to be authorized, which necessitates a Google Cloud project and OAuth credentials. Users need to follow detailed instructions to set up the environment, manage permissions, and download necessary files.

Running the Tool

The tool is executed via command line, with options to specify baselines, output paths, and other configurations. Users can assess all or specific components of GWS and generate reports in different formats. The tool supports both regular and cached run modes for different use cases.

Limitations and Recommendations

ScubaGoggles relies on log events, so absence of logs for a particular setting might require manual verification against SCuBA baselines. Log retention limits might affect the visibility of some events. Testing in a newly created organizational unit is recommended for evaluating specific controls.

Security Contributions

It provides an automated way to check GWS configurations against established security baselines. Helps organizations identify and rectify deviations from recommended security settings. Supports ongoing efforts to maintain and enhance cloud security postures in line with best practices.

My best guess at installation Commands for Linux (yes, would put on Wiki if I did it)


# Download ScubaGoggles
wget [URL_of_ScubaGoggles_latest_release.zip] 
unzip scubagoggles-[latest-version].zip 
cd scubagoggles-[latest-version] 

# Install Python Dependencies
pip3 install virtualenv
virtualenv -p python3 .venv
source .venv/bin/activate

# Install Dependencies
# For running ScubaGoggles directly
python3 -m pip install .

# For running via scuba.py script
pip3 install -r requirements.txt

# Download OPA Executable
python download_opa.py -v 0.57.1 -os linux
chmod +x opa_linux_amd64_static # Make OPA executable