gatekeeper-securitycenter

README

gatekeeper-securitycenter

gatekeeper-securitycenter allows you to use Security Command Center as a dashboard for Kubernetes resource policy violations.

gatekeeper-securitycenter is:

• a Kubernetes controller that creates Security Command Center findings for violations reported by the audit controller in Open Policy Agent (OPA) Gatekeeper.

• a command-line tool that creates Security Command Center sources and manages the IAM policies of the sources.

gatekeeper-securitycenter works with both Security Command Center Standard tier and Security Command Center Premium tier.

Prerequisites

Before installing the gatekeeper-securitycenter controller, create all the following resources:

• a Kubernetes cluster, for instance a Google Kubernetes Engine (GKE) cluster
• OPA Gatekeeper installed in the Kubernetes cluster
• a Security Command Center source
• a Google service account with the Security Center Findings Editor role on the Security Command Center source.

To create these prerequisite resources, choose one of these options:

1. Use the shell scripts in the scripts directory. These scripts create resources using the gcloud command-line tool from the Google Cloud SDK.

2. Follow the step-by-step instructions in the accompanying tutorial.

If you use Security Command Center Standard tier, you must have an appropriate Cloud IAM role for Security Command Center at the organization level, such as Security Center Admin Editor. Your organization administrator can grant you this role.

If your user account is not associated with an organization on Google Cloud, you can create an organization resource by signing up for either Cloud Identity or Google Workspace (formerly G Suite) using a domain you own. Cloud Identity offers a free edition.

Downloading the gatekeeper-securitycenter command-line tool

Download the binary for your platform:

VERSION=v0.4.1
curl -Lo gatekeeper-securitycenter "https://github.com/GoogleCloudPlatform/gatekeeper-securitycenter/releases/download/${VERSION}/gatekeeper-securitycenter_$(uname -s)_$(uname -m)"
chmod +x gatekeeper-securitycenter

Installing the gatekeeper-securitycenter controller

Install the gatekeeper-securitycenter controller in your cluster by following the documentation in the manifest directory.

Documentation

• Tutorial

• Building gatekeeper-securitycenter

• Developing gatekeeper-securitycenter

• Releasing gatekeeper-securitycenter

Disclaimer

This is not an officially supported Google product.