publish-to-ghazdo

Publish finalized SARIF files to GitHub Advanced Security for Azure DevOps.

224|105|Updated Nov 5, 2015
One-click install
npx skills add https://github.com/microsoft/sarif-sdk --skill publish-to-ghazdo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: publish-to-ghazdo
Source: https://github.com/microsoft/sarif-sdk/tree/main/skills/publish-to-ghazdo
Command: npx skills add https://github.com/microsoft/sarif-sdk --skill publish-to-ghazdo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the secure submission of finalized SARIF files to GitHub Advanced Security for Azure DevOps (GHAzDO) via the Sarif.Multitool publish-to-ghazdo verb.

Core Features & Use Cases

  • Automates publishing finalized SARIF to GHAzDO, ensuring provenance requirements are met.
  • Supports dry-run and live publish flows with environment-variable secret handling.
  • Validates provenance offline to prevent misconfigured or unfinalized SARIF from being ingested.

Quick Start

Run Sarif.Multitool publish-to-ghazdo against your finalized SARIF file and supply the secret via an environment variable (default GHAZDO_TOKEN) after confirming the target org/project/repo.

Frequently Asked Questions about publish-to-ghazdo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a finalized SARIF file to GitHub Advanced Security for Azure DevOps?▼

To publish a finalized SARIF file to GHAzDO, run the Sarif.Multitool publish-to-ghazdo verb with an environment variable secret like a PAT or Entra token to authenticate the upload.

Does uploading SARIF to GHAzDO require a specific authentication token?▼

Yes, uploading SARIF to GHAzDO requires a secret in an environment variable, defaulting to GHAZDO_TOKEN, which uses a PAT or Entra token to authenticate the request.

How do I validate SARIF provenance before publishing to Azure DevOps?▼

You can validate SARIF provenance offline using GHAzDO rules to ensure versionControlProvenance is correctly configured, preventing misconfigured or unfinalized files from being ingested.

Can I preview a SARIF upload to GHAzDO before submitting it?▼

Yes, you can perform a dry-run preview to verify the target org, project, and repo resolution before executing the final publish flow to the configured endpoint.

What endpoint does GHAzDO use for SARIF ingestion?▼

GHAzDO SARIF ingestion targets advsec.dev.azure.com for upload resolution, falling back to dev.azure.com based on the repository provenance described in the file.

Why does my SARIF publish to GHAzDO fail with a provenance error?▼

Publishing fails when the SARIF file lacks proper versionControlProvenance or is unfinalized, which offline GHAzDO rules validation checks to prevent misconfigured ingestion.