Documentation
Getting started
OASB (Open Agent Security Benchmark) is a standardized framework for assessing AI agent security. There are two ways to use it: run the full evaluation suite from the canonical repository to score a security product, or check an agent's OASB-1 compliance with the reference implementation.
Run the benchmark suite
The canonical source for the full evaluation suite is github.com/opena2a-org/oasb: 222 attack scenarios mapped to 15 MITRE ATLAS techniques, run against any security product that implements the SecurityProductAdapter interface. Requires Node.js 18+.
git clone https://github.com/opena2a-org/oasb.git cd oasb && npm install npm test
To evaluate your own product instead of the reference adapter, point OASB_ADAPTER at your adapter module:
OASB_ADAPTER=./my-adapter.js npm testCapabilities a product does not declare are reported N/A, not FAIL, so scorecards stay comparable across tools with different surfaces. See the adapter guide in the repository.
Check agent compliance (reference implementation)
To check an agent project against the OASB-1 controls, run the reference implementation with a single command. Requires Node.js 18+.
npx hackmyagent secure --benchmark oasb-1Maturity levels
Choose the level appropriate for your deployment stage.
Baseline security for development and prototypes. Every AI agent should meet these requirements.
Production-ready security for agents handling sensitive data. Recommended for most deployments.
Maximum security for regulated industries, financial services, and high-value targets.
npx hackmyagent secure --benchmark oasb-1 --level L2Output formats
Export results for integration with your tools.
npx hackmyagent secure -b oasb-1 -f sarif -o results.sarifCI/CD integration
Add security verification to your deployment pipeline.
GitHub Actions
name: OASB Security Benchmark
on: [push, pull_request]
jobs:
security:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run OASB-1 Benchmark
run: |
npx hackmyagent secure \
--benchmark oasb-1 \
--format sarif \
--output results.sarif \
--fail-below 80
- name: Upload to GitHub Security
uses: github/codeql-action/upload-sarif@v3
with:
sarif_file: results.sarifFail threshold
Use --fail-below to set a minimum compliance score. Exits with code 1 if below threshold.
npx hackmyagent secure -b oasb-1 --fail-below 80Sample output
Example result for a compliant L1 agent.
OASB-1 Security Benchmark v1.0.0 ════════════════════════════════════════════════════════════ Target: https://api.example.com/v1/agent Level: L1 (Essential) Rating: COMPLIANT Score: 100% (14/14 controls passed) Category Results ──────────────────────────────────────────────────────────── [PASS] Identity & Provenance 2/2 100% [PASS] Authorization & Access 2/2 100% [PASS] Input Security 3/3 100% [PASS] Output Security 2/2 100% [PASS] Credential Management 2/2 100% [PASS] Supply Chain 2/2 100% [PASS] Isolation 1/1 100% Recommendation: Ready for L2 assessment
CLI reference
Resources