---

name: security-container-security description: > Use this skill when asked about container security, image scanning, Trivy, Grype, Clair, Snyk, Dockerfile security, admission control, Kyverno, OPA, runtime security, Falco, Tracee, CVE management, container signing, Cosign, SBOM, or distroless images. This skill enforces: image scanning in CI with severity gates, Dockerfile hardening with multi-stage builds and distroless bases, Kubernetes admission control policies, runtime security monitoring with Falco, image signing with Cosign, and SBOM generation. Do NOT use for: host OS security, network security policies, or Kubernetes RBAC design. version: "1.1.0" author: "j4flmao" license: "MIT" compatibility: claude-code: true cursor: true codex: true windsurf: true tags: [security, devops, containers, phase-10]

Security Container Security

Purpose

Build a container security program spanning image scanning (Trivy, Grype, Clair, Snyk), Dockerfile hardening (distroless, multi-stage, non-root), admission control (Kyverno, OPA/Gatekeeper), runtime monitoring (Falco, Tracee), image signing (Cosign), and SBOM generation.

Agent Protocol

Trigger

Exact user phrases: "container security", "image scanning", "Trivy", "Grype", "Clair", "Snyk", "Dockerfile security", "admission control", "Kyverno", "OPA", "runtime security", "Falco", "Tracee", "container CVE", "distroless", "multi-stage build", "image hardening", "K8s security", "container vulnerability", "Cosign", "image signing", "SBOM", "container admission", "pod security".

Input Context

Before activating, verify:

• Container registry (Docker Hub, ECR, GCR, GAR, ACR)
• Orchestration platform (Kubernetes, ECS, Nomad)
• CI/CD platform and image build pipeline
• Existing security tools and incident history
• Compliance standards (PCI DSS, SOC 2, HIPAA)
• Image volume (number of images, build frequency)

Output Artifact

Container security policy with image scanning config, admission rules, runtime monitoring as YAML files.

Response Format

# Trivy scan config
# Dockerfile best practice rules
# Kyverno admission policies
# Falco rules
# Cosign signing config

No preamble. No postamble. No explanations. No filler/hedging/transitions. Compress output -- why use many token when few do trick.

Completion Criteria

• Image scanning configured in CI with severity-gated policy
• Dockerfile follows hardening checklist
• Admission controller deployed with policy rules
• Runtime monitoring configured with Falco rules
• Image signing and verification configured (Cosign)
• Vulnerability management SLA defined
• SBOM generation integrated into build pipeline
• CVE exception process documented

Max Response Length

300 lines of configuration.

Workflow

Step 1: Image Scanning - CI Pipeline

Trivy: primary scanner for container images. Fast, offline capable, broad CVE coverage. trivy image --severity CRITICAL,HIGH --exit-code 1 --format sarif <image>.

Grype: secondary scanner for cross-reference. Integrates with Syft for SBOM-based scanning. grype myapp:latest --only-fixed --fail-on critical.

Clair: registry-based scanning via Clair v4 and Quay. Scans on push and on schedule.

Snyk: developer-friendly with IDE integration. Provides fix advice and reachability analysis.

Policy gates: CRITICAL -> block build, fix immediately. HIGH -> block if fixable version exists. MEDIUM -> warn with PR comment. LOW -> info, log only.

Scan at build time and rescan daily for new CVEs. Store results as attestation in registry. Output SARIF for GitHub Code Scanning integration.

Step 2: Dockerfile Hardening

Base image selection: Distroless for production: gcr.io/distroless/base. Scratch for statically linked Go binaries. Alpine for tooling and utility images.

Multi-stage pattern: Builder stage with full SDK and build tools. Runtime stage with minimal dependencies only. Builder stage never ships to registry.

User: USER 10001:10001 -- never root. Filesystem: COPY --chown=10001:10001. Packages: pin exact versions, clean cache. rm -rf /var/cache/apk/* for Alpine.

HEALTHCHECK: 30s interval, 3s timeout. Labels for provenance tracking: org.opencontainers.image.source, org.opencontainers.image.revision.

Security: RUN --mount=type=bind for secrets. Never use build args for secrets. .dockerignore excludes node_modules, .git, .env, test.

Step 3: SBOM Generation

Syft: generate SBOM as build artifact. syft packages <image> -o cyclonedx-json > sbom.cdx.json.

Store SBOM in registry alongside image. Attest with Cosign for non-repudiation.

Grype scans SBOM directly without pulling image: grype sbom:sbom.cdx.json.

Formats: CycloneDX and SPDX supported. Use SBOM for vulnerability matching, license checks, supply chain transparency, software inventory. Policy: no image deployable without SBOM.

Step 4: Image Signing with Cosign

Sign image digest after scan passes. cosign sign --keyless <image>.

Keyless mode uses OIDC from CI provider. GitHub, GitLab, Google identities supported. No key management burden.

Signature stored in registry alongside image. Verify before admission: cosign verify --keyless <image>.

Attest scan results and SBOM: cosign attest --keyless --type cyclonedx sbom.cdx.json <image>.

Policy: only signed images with passing scans deployable. Key-based signing for air-gapped environments.

Step 5: Admission Control

Kyverno: Kubernetes-native admission policies. Policy types: Validate (deny if violated), Mutate (auto-modify spec), Generate (create resources), VerifyImages (require Cosign).

Key policies:

• Require image from approved registry
• Require Cosign signature verification
• Block privileged containers
• Enforce read-only root filesystem
• Require CPU and memory resource limits
• Block hostNetwork and hostPID
• Require runAsNonRoot: true
• Drop all Linux capabilities

OPA/Gatekeeper: alternative using Rego language. Better for complex cross-resource policies.

Dry-run mode: 7 days before enforcement. Audit violations, tune rules, then enforce.

Pod Security Standards: Restricted profile. Audit -> warn -> enforce rollout sequence.

Step 6: Runtime Security

Falco: syscall-level monitoring. Driver: driver.kind=modern-bpf for performance.

Default rules:

• Shell spawned inside container
• Write to sensitive paths (/etc/shadow, /var/lib/kubelet)
• Outbound connection to unknown IP
• Privilege escalation via setuid
• Unexpected process from web server
• Container with privileged flag

Tracee: eBPF-based runtime security. Signature detection for kernel exploits. Behavioral analysis for fileless execution. Container breakout detection.

Alert pipeline: Falco -> Falcosidekick -> AlertManager -> Slack or PagerDuty. Critical alerts trigger automatic pod termination.

Step 7: Vulnerability Management SLA

CRITICAL: patch within 24 hours. Mitigate with WAF rule or network policy if no fix. HIGH: patch within 7 days. MEDIUM: patch within 30 days. LOW: patch within 90 days.

Exception process: Documented justification with compensating control. Expiry date of max 30 days. Approval from security lead.

Tracking dashboard: Vulnerability age by severity. Image count affected. Fixable vs unfixable breakdown. Exception count and age.

Daily scan of deployed images for new CVEs. Alert on new critical or high findings. Auto-create tickets for fixable vulnerabilities.

Architecture / Decision Trees

Security Architecture Options

Architecture	Pros	Cons	Best For
Shift-left (CI scanning only)	Fast, developer-owned	No runtime coverage	Startups, small teams
Runtime + CI	Full coverage, defense in depth	Higher ops cost	Regulated, enterprise
Registry scanning only	No CI integration, passive	Delayed detection	Existing registries
Admission control only	Enforces at deploy time	Blocks bad images without finding them	Compliance enforcement

Scanner Decision Tree

Tool	Speed	Coverage	Integration	Best For
Trivy	Fast	OS + language libs	CI, CD, registry	Primary scanner
Grype	Medium	OS + language libs	CLI, SBOM	Secondary cross-ref
Clair	Slow (registry)	OS packages	Quay, registry	Registry-based orgs
Snyk	Fast	OS + libs + IaC	IDE, CI, registry	Developer experience
Docker Scout	Fast	OS + libs	Docker only	Docker Hub users

Runtime Security Tool Comparison

Tool	Mechanism	Performance Impact	Detection	Best For
Falco	Syscall (kernel module/eBPF)	< 5% CPU	System calls, file access	General container security
Tracee	eBPF	< 3% CPU	Signatures, behavior	Advanced threat detection
Aqua	Agent + eBPF	< 5% CPU	Full stack (K8s, network)	Enterprise security platform
Sysdig Secure	Agent + eBPF	< 5% CPU	Falco-based + forensics	Performance monitoring + security

Admission Control Decision Tree

Tool	Language	Complexity	Best For
Kyverno	YAML	Low	Kubernetes-native teams
OPA/Gatekeeper	Rego	Medium	Complex policies, multi-platform
Custom webhook	Any	High	Special requirements

Common Pitfalls

Pitfall 1: Scanning Only at Build Time

Images scanned at build time can have new CVEs discovered hours later. Daily rescan of registry is mandatory. Deployed images must be rescanned. Alert on new critical vulnerabilities in running images.

Pitfall 2: Ignoring Base Image Updates

Using the same base image for months accumulates vulnerabilities. Update base images monthly minimum. Use automated base image update tools. Pin base image SHA for reproducibility.

Pitfall 3: Admission Control Without Dry Run

Enforcing admission policies without dry-run breaks existing workloads. Use dry-run mode for 7-14 days before enforcement. Audit violations, tune rules, notify teams.

Pitfall 4: Runtime Security Without Alerting

Falco detects events but they go to /var/log/syslog by default. Without alert pipeline, events are invisible. Configure Falcosidekick. Route critical alerts to PagerDuty.

Pitfall 5: Blocking All Vulnerabilities

Blocking every CVE with a gate causes deployment delays. Gate on CRITICAL/HIGH only. Allow MEDIUM/LOW with warnings. Have exception process for false positives.

Pitfall 6: Not Signing Images Before Deployment

Signing after deployment is too late -- unsigned images already running. Sign images as post-scan step in CI. Verify signatures in admission controller.

Pitfall 7: Running as Root in Production

Root in container has unnecessary privileges. If container is compromised, attacker gets root on host kernel. Always use non-root USER. Drop all capabilities.

Pitfall 8: SBOM as Afterthought

SBOM generated once and forgotten. SBOM must be generated per build, stored alongside image, used for vulnerability scanning. Attest SBOM with Cosign.

Best Practices

Image Security

• Always pin base image versions (no latest)
• Use distroless or scratch for production
• Multi-stage builds with builder stage never shipped
• Run as non-root user
• Read-only root filesystem
• Drop all Linux capabilities
• HEALTHCHECK instruction in every image
• LABEL for provenance tracking

CI/CD Security Pipeline

1. Build image (multi-stage)
2. Scan with Trivy (fail on CRITICAL+HIGH)
3. Generate SBOM with Syft
4. Sign image with Cosign
5. Attest scan results and SBOM
6. Push to registry
7. Deploy through admission control
8. Runtime monitoring with Falco
9. Daily rescan deployed images

Admission Policy Minimum Set

• Require from approved registry only
• Require Cosign signature
• Block privileged containers
• Enforce read-only root filesystem
• Require CPU/memory limits
• Block hostNetwork, hostPID, hostIPC
• Require runAsNonRoot: true
• Drop all capabilities
• Block seccomp unconfined
• Require seccomp profile (RuntimeDefault)

Vulnerability Management

• SLA: CRITICAL 24h, HIGH 7d, MEDIUM 30d, LOW 90d
• Exception process: documented, approved, 30-day expiry
• Daily rescan of all deployed images
• Auto-create tickets for new critical CVEs
• Track vulnerability age and fix rate

Compared With

Container Security vs Host Security

Container security: image scanning, admission control, runtime security within containers, registry security. Host security: OS hardening, kernel patches, network security at host level. Containers share host kernel, so host security is foundational. Both needed for defense in depth.

Trivy vs Snyk vs Grype

Trivy: fastest, broadest CVE coverage, offline-capable, free, MIT license. Snyk: best developer experience, IDE integration, fix advice, commercial. Grype: SBOM-native, Syft integration, air-gapped capable, free, Apache license. Use Trivy as primary, Grype for cross-ref, Snyk for developer workflows.

Kyverno vs OPA/Gatekeeper

Kyverno: K8s-native YAML policies, simpler, auto-generation, mutate support. OPA/Gatekeeper: Rego language, more expressive, cross-platform, larger community. Kyverno for K8s-only. OPA for multi-platform.

Keyless vs Key-Based Signing

Keyless (Cosign OIDC): no key management, CI provider identity, cloud CI suitable. Key-based: full control, air-gapped, offline verification, key management overhead. Keyless for cloud-native. Key-based for regulated/air-gapped.

Operations & Maintenance

Daily Operations

• Verify scan pipeline runs successfully
• Check for new critical CVEs in deployed images
• Review Falco alerts (critical + warnings)
• Verify admission controller enforcing

Weekly Operations

• Review vulnerability exceptions and expiry
• Tune Falco rules (false positive reduction)
• Update base images
• Review admission audit logs
• Patch confirmed vulnerabilities

Monthly Operations

• Full image registry rescan
• Report vulnerability metrics (age, fix rate, count by severity)
• Update scanner databases
• Test Cosign verification pipeline
• Validate SBOM generation

Security Incident Response

1. Detect: Falco alert or vulnerability scan finding
2. Assess: criticality, affected images, running instances
3. Contain: patch image, redeploy, isolate compromised pods
4. Investigate: root cause analysis
5. Remediate: update base images, add scanning rules, tune policies
6. Document: incident report, preventive measures

CI/CD Pipeline Examples

GitHub Actions — Container Security Pipeline

# .github/workflows/container-scan.yml
name: Container Security
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
jobs:
  build-and-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build Image
        run: docker build -t app:${{ github.sha }} .
      - name: Trivy Scan
        uses: aquasecurity/trivy-action@master
        with:
          image-ref: app:${{ github.sha }}
          format: sarif
          severity: CRITICAL,HIGH
          exit-code: 1
      - name: Generate SBOM
        uses: anchore/sbom-action@v0
        with:
          image: app:${{ github.sha }}
          format: cyclonedx-json
      - name: Sign Image
        run: |
          cosign sign --keyless \
            --identity-token ${{ secrets.ID_TOKEN }} \
            registry.example.com/app@${{ steps.digest.outputs.digest }}
      - name: Push to Registry
        run: docker push registry.example.com/app:${{ github.sha }}

GitLab CI — Container Security

container-scan:
  stage: test
  image:
    name: aquasec/trivy:latest
    entrypoint: [""]
  script:
    - trivy image --severity CRITICAL,HIGH --exit-code 1 $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
    - syft packages $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA -o cyclonedx-json > sbom.json
  artifacts:
    reports:
      cyclonedx: sbom.json

Kyverno Policy Examples

Require Non-Root User

apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: require-non-root
spec:
  validationFailureAction: Enforce
  rules:
    - name: check-run-as-non-root
      match:
        any:
          - resources:
              kinds: ["Pod"]
      validate:
        message: "Containers must run as non-root user"
        pattern:
          spec:
            securityContext:
              runAsNonRoot: true

Block Privileged Containers

apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: block-privileged
spec:
  validationFailureAction: Enforce
  rules:
    - name: check-privileged
      match:
        any:
          - resources:
              kinds: ["Pod"]
      validate:
        message: "Privileged containers are not allowed"
        pattern:
          spec:
            containers:
              - securityContext:
                  privileged: false

Container Security Anti-Patterns

Anti-Pattern: Using :latest Tag

latest tag is ambiguous — point to different images over time. No traceability, no rollback, no audit. Use semantic versioning (v1.2.3) or commit SHA (sha-abc123) for immutable references. Enforce with admission controller blocking latest.

Anti-Pattern: Blindly Trusting Base Images

Pulling base images from Docker Hub without verification. Base images can contain malware, outdated packages, or backdoors. Use only verified official images. Pin to digest. Scan base images before building. Use Docker Content Trust or Cosign verification.

Anti-Pattern: Scanning Only at Build Time

New CVEs discovered daily. An image passing scan at build time may have critical vulnerabilities hours later. Rescan deployed images daily. Alert on new critical findings in running workloads. Auto-create tickets.

Anti-Pattern: No Resource Limits

Containers without CPU/memory limits can DoS the host node. One compromised container can starve others. Always set resource requests and limits. Admission policy should require resource specifications.

Anti-Pattern: Storing Secrets in Image Layers

Using ENV or build args for secrets embeds them in image layers. Anyone with docker history or registry access can extract secrets. Use RUN --mount=type=secret for build-time secrets. Inject runtime secrets via volumes, env-from, or secrets manager.

Vulnerability Management Anti-Patterns

Anti-Pattern: Treating All CVEs Equally

Not all CVEs are exploitable in your context. A CVE in a library function never called from application code is low risk. Use reachability analysis (Snyk, Mend) to prioritize fixable and reachable vulnerabilities. Gate only on reachable critical/high.

Anti-Pattern: No Exception Process

Blocking every CVE without exceptions causes deployment paralysis. Establish a documented exception process with compensating controls, owner approval, and expiry dates. Track exception metrics and reduce over time.

Anti-Pattern: Manual CVE Triage at Scale

Manual triage does not scale beyond 10-20 images. Automate vulnerability scanning results correlation with reachability, fixability, and exploitability (EPSS score). Auto-assign findings to service teams based on image ownership.

Container Security Operations

Daily Operations Checklist

• Verify scan pipeline ran successfully for all builds
• Check for new critical CVEs in deployed images
• Review Falco critical alerts from last 24 hours
• Verify admission controller policies are enforcing
• Check registry for unsigned images

Weekly Operations

• Review vulnerability exception requests and expiry
• Tune Falco rules for false positives
• Update base images to latest patch versions
• Review admission control audit logs
• Patch confirmed vulnerabilities within SLA

Monthly Operations

• Full registry rescan and vulnerability report
• Metrics report: vulnerability age, fix rate, count by severity
• Update scanner vulnerability databases
• Test Cosign verification end-to-end
• Validate SBOM generation for all active images
• Review and update exception list

Incident Response Playbook

1. Detect: Falco alert (shell in container, crypto miner behavior, unexpected outbound connection) or scan finding (new critical CVE in deployed image)
2. Assess: Identify affected images, running instances, blast radius. Determine if exploit exists in the wild (CISA KEV, EPSS > 0.9).
3. Contain: Patch image, rebuild, redeploy. If active compromise, isolate pod with network policy, capture forensic snapshot.
4. Eradicate: Remove compromised container, revoke credentials that may have been exposed, rotate secrets.
5. Recover: Deploy patched image. Verify admission policies blocked similar images. Update scanning rules.
6. Post-mortem: Root cause analysis. Update Dockerfile, base image, or admission policies to prevent recurrence.

Container Security Maturity Model

Level 1: Basic

• Manual image building with no scanning
• Root user in containers
• latest tags used in production
• No admission control
• No runtime monitoring

Level 2: Defined

• Image scanning in CI (Trivy, fail on critical)
• Multi-stage builds with non-root user
• Semantic versioning for images
• Basic admission policies (block privileged)
• Falco deployed with default rules

Level 3: Managed

• Automated SBOM generation and signing per build
• Admission control with image verification (Cosign)
• Runtime monitoring with custom Falco rules and alerting
• Vulnerability management with SLA and exception process
• Daily rescan of deployed images

Level 4: Optimized

• Policy-as-code with GitOps-driven admission (Kyverno/OPA in CI)
• Behavioral analysis with Tracee for advanced threat detection
• Automated CVE remediation with PR creation
• Reachability-aware vulnerability prioritization
• Container security metrics in executive dashboard

Rules

• No root user in container runtime
• No latest tag -- use semantic versioning or commit SHA
• Distroless base for production images
• Image scan on every build, daily rescan of registry
• Admission controller blocks unsigned images
• Falco alerts routed to security team within 1 minute
• Vulnerability exceptions expire after 30 days
• Build stage never ships to registry
• SBOM generated and stored for every image
• CVE fix prioritized by severity and fixability
• Admission policies dry-run for 7 days before enforcement
• Base images updated monthly minimum
• CRITICAL vulnerabilities patched within 24 hours
• Keyless signing for cloud CI, key-based for air-gapped
• Registry access restricted to approved publishers only

References

• references/container-security-fundamentals.md -- Container Security Fundamentals
• references/container-security-advanced.md -- Container Security Advanced Topics
• references/container-vulnerability-scanning.md -- Container Vulnerability Scanning
• references/image-security.md -- Image Security
• references/runtime-security.md -- Runtime Security
• references/admission-controller-policies.md -- Admission Controller Policies
• references/container-image-security.md -- Container Image Security
• references/container-runtime-security.md -- Container Runtime Security

Handoff

security-secrets-management for credential injection security-api-security for gateway and service mesh policies