Documentation
SCA Policy Violation
Project-Agent / library/workflows/sca-policy-violation/README.md
Monitors Endor Labs CI/CD policy rules for violations, creates Jira blocker tickets to prevent deployment of non-compliant code, and sends engineering alerts to Slack.
Maturity: L3-4 (Enforced to Governed) · See the 5-level maturity model for where this workflow fits in your program.
Time Saved
~1 hour per violation of manual triage and ticket creation.
Connectors
| Connector | Operations | Risk Level | |-----------|-----------|------------| | Endor Labs | cicd_rules:read, findings:read | Low — read-only | | Jira | issues:create | Medium — creates blocker tickets | | Slack | chat:write | Low — notification only |
How It Works
- Query Endor Labs for CI/CD policy rule violations.
- Enrich each violation with finding details (CVE, severity, fix version).
- Create a Jira blocker ticket assigned to the repository owner.
- Post a Slack alert to the relevant engineering channel.
ARX Governance
Risk Classification
findings:read— Low. Read-only query against Endor Labs.issues:create— Medium. Creates blocking Jira tickets that can hold up deployments.chat:write— Low. Posts informational Slack messages.
HITL Gate Configuration
- No HITL gate required. Ticket creation is non-destructive and reversible.
Policy Rules
findings:read— permit — automated, no approval needed.issues:create— permit — creates tickets for human review downstream.chat:write— permit — notification only.
Audit Trail
- Violation ID, CVE, severity, and affected repository.
- Jira ticket key and assignee for every created issue.
- Slack message timestamp and channel.
- Full event log written to
arx.audit_log.
> See arx.yaml for the full governance configuration.
Setup Instructions
- Configure Endor Labs, Jira, and Slack connectors in
arx.yaml. - Set environment variables:
ENDOR_NAMESPACE,ENDOR_API_KEYJIRA_URL,JIRA_API_TOKEN,JIRA_PROJECT_KEYSLACK_BOT_TOKEN,SLACK_ENGINEERING_CHANNEL
- Map repository owners in
arx.yamlunderrepo_owner_mapfor Jira assignment. - Deploy with
arx deploy sca-policy-violation.
Schedule
Runs every 30 minutes during business hours (08:00-20:00 UTC weekdays).