Catalog
google/gke-workload-security

google

gke-workload-security

Audits, configures, and hardens workload-level security controls for Google Kubernetes Engine (GKE) applications and namespaces. Covers running cluster security audits (`audit_cluster.sh`), configuring Workload Identity Federation (impersonation, KSA/GSA binding, and pod setup), enforcing Network Policies (default-deny and Dataplane V2 logging), isolating high-risk pods inside GKE Sandbox (`gVisor`), enforcing Pod Security Standards (`restricted` labeling), and mounting Secret Manager secrets via CSI (`SecretProviderClass`). Use when auditing cluster security posture, isolating namespaces, applying pod security standards, setting up Workload Identity, or configuring network policies and secret volume mounts. Don't use for cluster-wide control plane security, RBAC hardening, Binary Authorization, Shielded Nodes, or enabling platform-level GKE add-ons (use gke-platform-security instead).

global
category:Security
New~1.9k
v1.0Saved Jul 24, 2026

GKE Workload Security

This skill provides workflows and best practices for securing GKE workloads. It covers security auditing, Identity and Access Management (Workload Identity), Network Security (Network Policies), and Node Security.

Workflows

1. Security Audit

Assess the current security posture of your cluster using the provided audit script.

Prerequisites:

  • gcloud CLI authenticated.
  • jq command-line JSON processor installed.

Capabilities:

  • Checks for Workload Identity.
  • Verifies Network Policy is enabled.
  • Checks if Shielded Nodes are enabled.
  • Checks if Binary Authorization is enabled.
  • Checks for Private Cluster configuration.

Command:

scripts/audit_cluster.sh <cluster-name> <region> <project-id>

2. Configure Workload Identity

Workload Identity allows Kubernetes Service Accounts (KSAs) to impersonate Google Service Accounts (GSAs). This is the recommended method for workloads to access Google Cloud APIs.

Steps:

  1. Create Namespace and KSA:

    kubectl create namespace workload-identity-test-ns
    kubectl create serviceaccount <ksa-name> \
        --namespace workload-identity-test-ns
    
  2. Bind KSA to GSA:

    gcloud iam service-accounts add-iam-policy-binding <gsa-name>@<project-id>.iam.gserviceaccount.com \
        --role roles/iam.workloadIdentityUser \
        --member "serviceAccount:<project-id>.svc.id.goog[workload-identity-test-ns/<ksa-name>]"
    
  3. Annotate KSA:

    kubectl annotate serviceaccount <ksa-name> \
        --namespace workload-identity-test-ns \
        iam.gke.io/gcp-service-account=<gsa-name>@<project-id>.iam.gserviceaccount.com
    
  4. Verify Example Pod: Use existing asset assets/workload-identity-pod.yaml to test the configuration. Update the <ksa-name> in the file first.

    kubectl apply -f assets/workload-identity-pod.yaml -n workload-identity-test-ns
    

3. Implement Network Policies

Control traffic flow between Pods using Network Policies. By default, all traffic is allowed.

Enable Network Policy Enforcement:

gcloud container clusters update <cluster-name> \
    --update-addons=NetworkPolicy=ENABLED \
    --region <region>

[!NOTE] If your cluster uses Dataplane V2 (--enable-dataplane-v2), Network Policy enforcement is built-in and this step is not required (and may fail).

Apply Default Deny Policy: Isolate namespaces by denying all ingress and egress traffic by default.

Replace <target-namespace> with the namespace you want to isolate.

kubectl apply -f assets/default-deny-netpol.yaml -n <target-namespace>

4. GKE Sandbox (gVisor) Pod Isolation

Run untrusted workloads in a sandbox for extra kernel isolation. (Note: Enabling Shielded Nodes (--enable-shielded-nodes) and GKE Sandbox (--enable-gke-sandbox) at the cluster control plane level are platform-level actions covered in the gke-platform-security skill.)

Run a Sandboxed Pod: Add runtimeClassName: gvisor to your Pod spec:

apiVersion: v1
kind: Pod
metadata:
  name: sandboxed-pod
spec:
  runtimeClassName: gvisor
  containers:
  - name: app
    image: nginx

5. Pod Security Standards

Enforce security policies on namespaces using labels.

Enforce Restricted Profile:

kubectl label --overwrite ns <namespace> \
    pod-security.kubernetes.io/enforce=restricted \
    pod-security.kubernetes.io/enforce-version=latest

[!NOTE] Using latest ensures you use the policies corresponding to the cluster's current version. You can pin it to a specific version (e.g., v1.30) to lock down the namespace to policies of a specific release.

6. Secret Manager Integration (CSI Driver)

Mount secrets from Google Cloud Secret Manager directly as volumes in your pods.

Prerequisites: Secret Manager CSI driver must be enabled on the cluster.

Example SecretProviderClass:

apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: my-secret-provider
spec:
  provider: gcp
  parameters:
    secrets: |
      - resourceName: "projects/<project-id>/secrets/my-secret/versions/latest"
        fileName: "my-secret-file"

Example Pod Spec excerpt:

spec:
  containers:
    - name: my-app
      volumeMounts:
        - name: secrets-store-inline
          mountPath: "/mnt/secrets"
          readOnly: true
  volumes:
    - name: secrets-store-inline
      csi:
        driver: secrets-store.csi.k8s.io
        readOnly: true
        volumeAttributes:
          secretProviderClass: "my-secret-provider"

7. Enable Network Policy Logging

If using GKE Dataplane V2, you can log allowed and denied connections.

Steps:

  1. Configure the NetworkLogging custom resource.

Example NetworkLogging Manifest:

apiVersion: networking.gke.io/v1alpha1
kind: NetworkLogging
metadata:
  name: default
spec:
  cluster:
    allow:
      log: true
      delegate: true
    deny:
      log: true
      delegate: true

This will log connection details to Cloud Logging.

Best Practices

  1. Least Privilege: Always use Workload Identity with minimal IAM roles. Avoid using Node default service accounts.
  2. Network Isolation: Use Network Policies to restrict Pod-to-Pod communication. Enable Network Policy Logging for visibility.
  3. Image Security: Use Binary Authorization to ensure only trusted images are deployed.
  4. Secret Management: Use Secret Manager CSI driver instead of default Kubernetes secrets for sensitive data.
  5. Pod Security: Enforce baseline or restricted Pod Security Standards on all non-system namespaces.
  6. Policy Enforcement: Consider using Policy Controller (Gatekeeper) to enforce custom security and compliance policies across the cluster.

Resources

Files4
4 files · 14.7 KB

Select a file to preview

Overall Score

86/100

Grade

A

Excellent

Safety

88

Quality

87

Clarity

85

Completeness

82

Summary

This skill provides practical workflows for auditing and hardening workload-level security in Google Kubernetes Engine (GKE), covering Workload Identity Federation, Network Policies, Pod Security Standards, GKE Sandbox isolation, and Secret Manager integration. It includes an executable audit script (`audit_cluster.sh`) and YAML asset templates for hands-on implementation across seven security domains.

Detected Capabilities

shell execution (audit script)kubernetes api calls (kubectl commands)gcloud cli operationsfile reads (audit configuration)yaml templatingjson parsing (jq filtering)

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

gke workload securityworkload identity setupnetwork policy isolationpod security standardsgke sandbox gvisorsecret manager csicluster security auditgke dataplane v2

Risk Signals

INFO

gcloud container clusters operations (describe, update)

SKILL.md sections 1, 3 and scripts/audit_cluster.sh
INFO

kubectl operations (create, apply, annotate, label) scoped to namespaces and user-provided resources

SKILL.md sections 2-7
INFO

Bash script with input validation on required parameters (cluster-name, region, project-id)

scripts/audit_cluster.sh lines 6-10
INFO

jq json parsing for cluster configuration extraction

scripts/audit_cluster.sh lines 15-28
INFO

No destructive operations (rm, rm -rf, chmod, sudo)

entire skill
INFO

No credential exposure (no hardcoded keys, .env access, or token reads)

entire skill
INFO

No outbound data exfiltration or external API calls beyond GCP cloud.google.com

entire skill
INFO

Assumes gcloud CLI pre-authenticated; no auth handling in skill itself

SKILL.md prerequisites

Referenced Domains

External domains referenced in skill content, detected by static analysis.

cloud.google.comwww.apache.org

Use Cases

  • Audit current GKE cluster security posture and identify gaps in Workload Identity, Network Policy, and Shielded Nodes configuration
  • Configure Workload Identity Federation to allow Kubernetes Service Accounts to impersonate Google Service Accounts with minimal privilege
  • Implement network isolation between pods using Network Policies with default-deny rules and Dataplane V2 logging
  • Run untrusted workloads in GKE Sandbox (gVisor) for kernel isolation without cluster-level platform changes
  • Enforce Pod Security Standards (restricted profile) on namespaces to prevent privileged container configurations
  • Mount secrets from Google Cloud Secret Manager directly as pod volumes using the CSI driver and SecretProviderClass
  • Enable and monitor Network Policy logging with GKE Dataplane V2 for compliance and visibility into allowed/denied pod connections

Quality Notes

  • Excellent scope documentation: clear boundaries between workload-level security (this skill) and platform-level control plane security (referenced gke-platform-security)
  • All seven workflows are complete with prerequisites, step-by-step instructions, and example YAML manifests
  • Supporting asset files are all present and properly referenced in the skill body
  • Audit script includes parameter validation with error handling and clear output formatting (PASS/FAIL/WARN)
  • Best practices section provides actionable guidance on least privilege, network isolation, image security, and policy enforcement
  • Resource links to official GCP documentation aid users in deeper learning
  • yaml templates use realistic examples (gcr.io image with full digest, resource limits, securityContext configurations)
  • Clear notes about Dataplane V2 prerequisites and version pinning for Pod Security Standards demonstrate operational maturity
Model: claude-haiku-4-5-20251001Analyzed: Jul 24, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use google/gke-workload-security in your dev environment

Command Palette

Search for a command to run...