Skip to main content

OWASP Dependency-Check CI/CD integration with Snapsec VM

Use OWASP Dependency-Check in your CI pipeline to scan application dependencies for known vulnerabilities and then push the findings into Snapsec VM using a simple webhook. This guide shows you, step by step, how to:
  1. Run Dependency-Check in your GitHub Actions or GitLab CI pipeline.
  2. Generate a JSON report.
  3. Send that JSON report directly to Snapsec VM using a webhook.
You do not need to be a CI/CD expert to follow this guide.

1. Prerequisites

  • A project with dependencies you want to scan (Maven, Gradle, npm, etc.).
  • Dependency-Check installed in your CI environment (CLI or Docker image).
  • Snapsec:
    • An Assessment in Snapsec VM where Dependency-Check findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • CI environment with curl available.

2. Create an assessment in Snapsec VM

  1. Log in to the Snapsec UI.
  2. Go to VM / Assessments.
  3. Click New Assessment, name it (for example, Dependency-Check - Services), save it, and copy its Assessment ID.
You will use this Assessment ID in the webhook URL.

3. Generate Dependency-Check JSON report (locally or in CI)

For a basic CLI run that outputs JSON:
This creates a JSON report file such as dependency-check-report.json in the current directory. You can try this locally first to confirm it works before adding it to your CI.

4. Push Dependency-Check JSON directly to Snapsec VM via webhook

Important: Replace <assessment-id> with your actual Assessment ID and <your-api-key> with your API key. Note on the -k flag: This flag tells curl to perform an “insecure” SSL transfer, which bypasses certificate validation. You may need this for local or development environments. Remove it if your endpoint has a valid SSL certificate.
Below are ready-to-use examples for GitHub Actions and GitLab CI.

5. GitHub Actions example

How to use this:
  1. Create .github/workflows/dependency-check-to-snapsec.yml.
  2. Copy the YAML above.
  3. Add SNAPSEC_ASSESSMENT_ID and SNAPSEC_API_KEY as GitHub secrets.
  4. Adjust paths and options as needed, then push your changes.

6. GitLab CI example

With these examples, even if you are new to CI/CD, you can:
  1. Run OWASP Dependency-Check automatically in your pipeline.
  2. Upload the JSON report directly to Snapsec VM using the provided webhook.

*** Add File: /Users/imran/Desktop/suite-docs/integrations/vm/kube-bench.mdx

title: kube-bench description: Step-by-step guide to run kube-bench in GitHub or GitLab CI and push findings into Snapsec VM via webhook. mode: wide

kube-bench CI/CD integration with Snapsec VM

Use kube-bench in your CI pipeline (or as part of your cluster security checks) to run Kubernetes CIS benchmark tests and then push the findings into Snapsec VM using a simple webhook.

1. Prerequisites

  • Access to a Kubernetes cluster or node where kube-bench can run.
  • kube-bench available in your CI or cluster environment (container image or binary).
  • Snapsec:
    • An Assessment in Snapsec VM where kube-bench findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • curl available in the environment running kube-bench.

2. Create an assessment in Snapsec VM

Create an assessment (for example, kube-bench - Cluster A) in VM / Assessments, then copy its Assessment ID.

3. Generate kube-bench JSON report

On a node (or in CI) where Kubernetes config is available:
This writes the CIS benchmark results as JSON to kube-bench.json.

4. Push kube-bench JSON directly to Snapsec VM via webhook

Important: Replace <assessment-id> with your actual Assessment ID and <your-api-key> with your API key. Note on the -k flag: This flag tells curl to perform an “insecure” SSL transfer, which bypasses certificate validation. You may need this for local or development environments. Remove it if your endpoint has a valid SSL certificate.
Below are example CI configurations.

5. GitHub Actions example

6. GitLab CI example

With these examples, kube-bench results from CIS checks can be uploaded straight into Snapsec VM.

*** Add File: /Users/imran/Desktop/suite-docs/integrations/vm/cloudsploit.mdx

title: CloudSploit description: Step-by-step guide to run CloudSploit in GitHub or GitLab CI and push findings into Snapsec VM via webhook. mode: wide

CloudSploit CI/CD integration with Snapsec VM

Use CloudSploit to scan your cloud accounts for misconfigurations and then push the findings into Snapsec VM using a webhook.

1. Prerequisites

  • CloudSploit CLI (or Docker image) available in your CI environment.
  • Cloud provider credentials configured for CloudSploit (AWS, Azure, GCP, etc.).
  • Snapsec:
    • An Assessment in Snapsec VM where CloudSploit findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • curl available.

2. Create an assessment in Snapsec VM

Create an assessment such as CloudSploit - Cloud Posture and copy its Assessment ID.

3. Generate CloudSploit JSON report

Example using the CloudSploit CLI:
You can pass additional flags for account, regions, or plugins as needed.

4. Push CloudSploit JSON directly to Snapsec VM via webhook

Important: Replace <assessment-id> and <your-api-key> with real values.
The -k flag allows insecure SSL in dev; remove it for production.

5. GitHub Actions example

6. GitLab CI example

*** Add File: /Users/imran/Desktop/suite-docs/integrations/vm/kics.mdx

title: KICS description: Step-by-step guide to run KICS in GitHub or GitLab CI and push findings into Snapsec VM via webhook. mode: wide

KICS CI/CD integration with Snapsec VM

Use KICS (Keeping Infrastructure as Code Secure) to scan Terraform, Kubernetes, Docker, and other IaC files, then push the findings into Snapsec VM.

1. Prerequisites

  • Repositories containing IaC files (Terraform, CloudFormation, Kubernetes manifests, etc.).
  • KICS available in CI (Docker image or binary).
  • Snapsec:
    • An Assessment in Snapsec VM where KICS findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • curl available.

2. Create an assessment in Snapsec VM

Create an assessment like KICS - IaC and copy its Assessment ID.

3. Generate KICS JSON report

Example using the official KICS Docker image scanning the current repo:
This writes a JSON report named kics.json in the current directory.

4. Push KICS JSON directly to Snapsec VM via webhook

Replace <assessment-id> / <your-api-key> and remove -k once SSL is properly configured.

5. GitHub Actions example

6. GitLab CI example

*** Add File: /Users/imran/Desktop/suite-docs/integrations/vm/tfsec.mdx

title: TFSec description: Step-by-step guide to run TFSec in GitHub or GitLab CI and push findings into Snapsec VM via webhook. mode: wide

TFSec CI/CD integration with Snapsec VM

Use TFSec to statically analyze Terraform code for security misconfigurations and then push findings into Snapsec VM.

1. Prerequisites

  • Terraform code in your repository.
  • TFSec installed (CLI or Docker image).
  • Snapsec:
    • An Assessment in Snapsec VM where TFSec findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • curl available.

2. Create an assessment in Snapsec VM

Create an assessment like TFSec - Terraform and copy its Assessment ID.

3. Generate TFSec JSON report

4. Push TFSec JSON directly to Snapsec VM via webhook

Replace placeholders and remove -k once SSL is fully trusted.

5. GitHub Actions example

6. GitLab CI example

*** Add File: /Users/imran/Desktop/suite-docs/integrations/vm/checkov.mdx

title: Checkov description: Step-by-step guide to run Checkov in GitHub or GitLab CI and push findings into Snapsec VM via webhook. mode: wide

Checkov CI/CD integration with Snapsec VM

Use Checkov to scan Terraform, CloudFormation, Kubernetes, Helm and other IaC frameworks, then push the findings into Snapsec VM.

1. Prerequisites

  • An IaC repository you want to scan with Checkov.
  • Checkov installed in CI (Python package or Docker image).
  • Snapsec:
    • An Assessment in Snapsec VM where Checkov findings will be stored.
    • Assessment ID (<assessment-id>)
    • API key (<your-api-key>)
  • curl available.

2. Create an assessment in Snapsec VM

Create an assessment such as Checkov - IaC and copy its Assessment ID.

3. Generate Checkov JSON report

4. Push Checkov JSON directly to Snapsec VM via webhook

Replace placeholders with real values; remove -k once SSL is trusted.

5. GitHub Actions example

6. GitLab CI example