Page Comparison

Overview

Data Theorem provides several integrations that collect information about your GKE deployments to help you manage your Kubernetes security posture. Additionally, like the data collected from all Data Theorem integrations, we send your GKE information to our analyzer to build a deep, full-stack understanding of your applications and resources they rely on.

...

• GCP Account Integration

• GCP Load Balancer Log Analysis Integration

• Kubernetes In-Cluster Helm Chart Integration

• Kubernetes Control-Plane Integration

We recommend enabling the GCP Account Integration and the GCP Load Balancer Log Analysis Integration, and optionally, one of the Kubernetes integrations.

KSPM Integrations

GCP Account Integration

The close integration of GKE and Google Cloud means that just by onboarding your GCP account we good visibility into your GKE clusters and the GCP resources they use.

How to enable this integration: https://datatheorem.atlassian.net/wiki/x/AoBQAg

GCP Load Balancer Log Analysis Integration

The Data Theorem GCP Load Balancer integration forwarding HTTP request logs from your GCP load balancers to a log sink that publishes HTTP request metadata to a Data Theorem Pub/Sub queue.

...

Data Theorem strongly recommends creating the sink at the organization level to maximize discovery, and to then use the sink’s log filter to limit which logs are sent to Data Theorem.

Information Collected

This integration collects non-sensitive runtime information about requests made to your load balancers. No request or response bodies or sensitive headers are collected.

Here is an example:

Image Added

Pre-requisites

• Make sure that Logging is enabled on the Load Balancer Backend Service Configuration

• Check this link for more information on how to enable Logging on the Load Balancer Backend Service

Create

...

a Pub/Sub

...

Topic For The Logs Routing Sink

...

1. In the GCP console, switch to the project where you will create the Pub/Sub topic

2. Using the left-hand side menu, select Pub/Sub (in the Analytics section), and then select Topics

...

1. , Click on Create Topic

2. In Create Topic Flow

3. Use datatheorem-logs-processing as the topic ID

...

2. Uncheck "Add a default subscription"

...

• No other options are needed

...

Click Create to create the topic

...

1. an confirm not other boxes are checked

2. Click Create

...

Create The Cloud Logging Sink

1. Using the left-hand side menu, select Logging (in the Observability section), then within the Configure subsection, select Log router

2. Click

...

1. Create Sink

2. In the Sink details section, input datatheorem-logs-processing as the sink name, and click Next

3. You will have to fill in the full ID of the sink destination. For a Pub/Sub topic, it must be formatted as (but replace the [PROJECT_ID] and [TOPIC_ID] with the topic's information): pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]

4. Click Next

...

Choose Logs to Include in Sink

...

Complete the sink creation by clicking on Create sink

Create a Service Account

...

1. In the Choose logs to include section, add the following inclusion filter: resource.type="http_load_balancer"

• You can click on Preview logs to see which logs will be included

1. Click Create sink

...

Create a

...

Service Account

...

To Authenticate Log Forwarding

1. In the GCP on console, switch back to the GCP project where the Pub/Sub topic was created

2. Then using the left-hand side menu, select IAM & Admin section, and then select Service Accounts

3. Click on Create Service Account at the top

4. In the Service account details section, input datatheorem-logs-processing as the name

...

1. Click CREATE AND CONTINUE

Allow Service Account to Assume Role To Authenticate Log Forwarding

1. In the Grant this service account access to project section

...

1. Select a role

2. Filter for “token creator” in the role filter

3. Select Service Account OpenID Connect Identity Token Creator

...

1. role to allow Pub/Sub to generate OIDC tokens that will be used to authenticate requests

2. Complete the service account creation by clicking on Done

...

Collect Service Account’s OAuth2 ClientId

1. On the service account listing, above the table, input datatheorem-logs-processing to retrieve the newly created service account

2. Copy the value from the OAuth 2 Client ID column and register it below

...

Create a Pub/Sub

...

Subscription In The Same GCP project As The Pub/Sub

...

Topic

1. Using the left-hand side menu, select Pub/Sub (in the Analytics section), then within the PUB/SUB subsection, select Subscriptions

2. Click on CREATE SUBSCRIPTION at the top

3. Input datatheorem-logs-processing as the subscription ID

4. Click on Select a Cloud Pub/Sub topic and input datatheorem to filter the previously created Pub/Sub topic

5. In the Delivery type section, select Push

6. In the Endpoint URL text box, input https://api-protect-api.securetheorem.com/logs/v1/ingest/gcp_load_balancers

...

1. Check on the Enable Authentication checkbox below the Endpoint URL, and select the previously created service account

2. In the Retry policy section at the bottom, change the retry policy in the subscription to exponential backoff instead of immediate retry

...

2. Click CREATE

Image Added

Kubernetes In-Cluster Helm Chart Integration

Overview

This integration uses a Helm chart to creates create a discovery deployment in the datatheorem namespace in your Kubernetes cluster. The deployment is not “in-line” for any of your cluster’s services. The application is stateless and designed to consume almost no resources, and it should not require any autoscaling.

It uses a the datatheorem-service-account bound to the datatheorem-cluster-role with the following permissions for read-only access on a limited set of cluster resources:

rules:
  - apiGroups:
      - "*"
    resources:
      - deployments
      - pods/log
      - pods
      - services
      - endpoints
      - persistentvolumeclaims
      - ingresses
      - gateways

    verbs:
      - list
      - get
      - watch 

and a cluster role binding the datatheorem-cluster-role to the datatheorem-service-account.

Installation

Step 1 : Extract all the items which you should receive during the onboarding process.

unzip DataTheorem-APIProtect-K8S_PROTECT.zip

Step 2 : Verify you are configured for the correct kubernetes cluster

kubectl config current-context

Step 3 : Install API Protect

Add mirroring to the chosen endpoint. This step must be repeated for each endpoint.

helm install k8s-protect    \
    ./k8s-protect           \
    --create-namespace      \
    --namespace datatheorem \
    --wait

Step 5 : Verify the deployment

It should look something like this

...

helm test -n datatheorem k8s-protect

Finished.

Un-Installation should it be required

helm uninstall -n datatheorem k8s-protect

Kubernetes Control-Plane Integration

...