From covenantctl to REST API to GitHub Actions — everything you need to integrate IP protection in your stack.
curl -X POST https://api.covenantengine.com/v1/scan \
-H "Authorization: Bearer $COVENANT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"file_uri": "s3://acme-corp/q3-report.pdf",
"vertical": "VENTURE_CAPITAL",
"enforce": true
}'
Response
{
"id": "scan_8a3d9b1",
"status": "completed",
"risk_score": 87,
"action": "WATERMARK_AND_ALERT",
"enforcement_id": "enf_92c4bf3"
}
GitHub Actions Native
# .github/workflows/covenant-scan.yml
name: Covenant IP Scan
on:
pull_request:
branches: [main]
jobs:
covenant-scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install covenantctl
run: pip install covenantctl
- name: Authenticate
run: covenantctl auth login --token ${{ secrets.COVENANT_TOKEN }}
- name: Scan repository for IP leaks
run: |
covenantctl scan dir . \
--exclude '.git,node_modules,*.test.js' \
--vertical VENTURE_CAPITAL \
--output json > covenant-results.json
- name: Fail on high risk
run: covenantctl report --fail-on HIGH --input covenant-results.json
- name: Upload results
uses: actions/upload-artifact@v4
with:
name: covenant-scan-results
path: covenant-results.json
Upload any file type. Covenant auto-detects VC, Healthcare, Gaming, Automotive or Source Code and routes to the correct shield.
Complete API coverage for every module. OpenAPI 3.1 schema available. SDKs for Python, Node.js, Go.
One workflow YAML. Scan PRs for IP risk. Block merges on CRITICAL findings. Zero-config vertical routing.
GCP Cloud KMS, AWS KMS, Azure Key Vault, or local PBKDF2. Envelope encryption. AES-256-GCM.
Offline JWT license validation. No internet required. For classified and air-gapped environments.
/metrics endpoint out of the box. 15 custom metrics. 4 Grafana dashboards included. OTLP trace export.
From pip install to first scan in under 2 minutes.