Azure DevOps
Public preview: install the Rorix Security Scanner from the Azure DevOps Marketplace. The published
RorixScan@0task installsRorix.Cli 0.1.2on the build agent.
CI gate warning:
Rorix.Cli 0.1.2can return exit code0for blocking findings or a missing manifest. The Marketplace task and manual CLI setup below should be advisory-only until a corrected public package is installed and failing-case Azure checks pass. Do not use the current task as a required security gate.
Run Rorix vulnerability scans as part of your Azure DevOps build and release pipelines.
Marketplace Extension
The supported integration path is the Rorix Security Scanner extension from the Azure DevOps Marketplace:
steps:
- task: RorixScan@0
inputs:
apiKey: $(RORIX_API_KEY)
command: scan
format: sarifThe extension handles CLI installation and authentication automatically. Store RORIX_API_KEY as a secret variable and see the available inputs (command, format, policyFile, path) in the extension's marketplace listing.
Manual CLI Setup
If you prefer to install the CLI yourself, use the script-based approach below.
Basic Scan
trigger:
- main
pool:
vmImage: 'ubuntu-latest'
steps:
- task: UseDotNet@2
inputs:
packageType: 'sdk'
version: '9.x'
- script: |
dotnet tool install -g Rorix.Cli
rorix login $(RORIX_API_KEY)
rorix scan
displayName: 'Rorix Vulnerability Scan'Policy Enforcement
Use this example only after the corrected public CLI is installed and failing-case Azure checks pass.
trigger:
- main
pool:
vmImage: 'ubuntu-latest'
steps:
- task: UseDotNet@2
inputs:
packageType: 'sdk'
version: '9.x'
- script: |
dotnet tool install -g Rorix.Cli
rorix login $(RORIX_API_KEY)
rorix scan --policy .rorix.yml --exit-code
displayName: 'Rorix Policy Check'After those checks pass, --exit-code can make the pipeline step fail on policy violations. The current public 0.1.2 package does not reliably do so.
Setting Up the API Key
Store your Rorix API key securely using Azure DevOps Variable Groups:
- Go to Pipelines then Library in your Azure DevOps project
- Create a new Variable Group or use an existing one
- Add a variable named
RORIX_API_KEY - Click the lock icon to mark it as a secret
- Link the Variable Group to your pipeline:
variables:
- group: 'Rorix'SBOM Generation
Generate an SBOM artifact as part of your build:
steps:
- script: |
dotnet tool install -g Rorix.Cli
rorix login $(RORIX_API_KEY)
rorix sbom --format cyclonedx --output $(Build.ArtifactStagingDirectory)/sbom.json
displayName: 'Generate SBOM'
- task: PublishBuildArtifacts@1
inputs:
pathToPublish: '$(Build.ArtifactStagingDirectory)/sbom.json'
artifactName: 'sbom'