Technical specification for IOA’s cryptographically signed governance evidence.
Every governance decision made by IOA—whether in Shadow, Graduated, or Enforce mode—produces an Evidence Bundle: a cryptographically signed, immutable record of the decision, its context, and all contributing factors.
Evidence Bundles serve three critical purposes:
{
"evidence_id": "EVID-2025-01-27-00123",
"timestamp": "2025-01-27T14:32:18.456Z",
"jurisdiction": "US-HIPAA",
"operation": "phi_redaction",
"risk_level": "HIGH",
"mode": "enforce",
"quorum": {
"enabled": true,
"consensus_type": "majority",
"agreement_ratio": "3/3",
"decision": "DENY",
"total_latency_ms": 2847.23
},
"votes": [
{
"model": "gpt-4-turbo",
"vote": "DENY",
"reasoning": "PHI exposure risk: patient name detected",
"latency_ms": 2134.56,
"timestamp": "2025-01-27T14:32:20.591Z"
},
{
"model": "claude-3-5-sonnet",
"vote": "DENY",
"reasoning": "HIPAA violation: identifiable health information",
"latency_ms": 1923.12,
"timestamp": "2025-01-27T14:32:20.379Z"
},
{
"model": "gemini-1.5-pro",
"vote": "DENY",
"reasoning": "Privacy risk: PII in public dataset",
"latency_ms": 2847.23,
"timestamp": "2025-01-27T14:32:21.303Z"
}
],
"context": {
"user_id": "user_abc123",
"tenant_id": "org_xyz789",
"session_id": "sess_def456",
"prompt_hash": "sha256:b1946ac92492d234...",
"input_tokens": 127,
"output_tokens": 0
},
"evidence_hash": "b1946ac92492d234",
"signature": {
"algorithm": "SHA256+RSA",
"signer": "IOA Trust Root CA",
"certificate_chain": ["cert_id_1", "cert_id_2"],
"signed_at": "2025-01-27T14:32:21.456Z",
"signature_value": "3045022100..."
},
"retention": {
"required_years": 7,
"jurisdiction_rule": "HIPAA §164.316(b)(2)(i)",
"delete_after": "2032-01-27T14:32:21.456Z"
}
}
Evidence IDs follow this format:
EVID-YYYY-MM-DD-NNNNN
Where:
EVID: Evidence Bundle prefixYYYY-MM-DD: UTC date of creationNNNNN: Sequential 5-digit counter (resets daily)Example: EVID-2025-01-27-00123
When Quorum is enabled, Evidence Bundles include detailed vote records from each model:
{
"model": "gpt-4-turbo",
"vote": "DENY",
"reasoning": "PHI exposure risk: patient name detected",
"confidence": 0.98,
"latency_ms": 2134.56,
"timestamp": "2025-01-27T14:32:20.591Z",
"model_version": "gpt-4-turbo-2024-04-09",
"provider": "OpenAI"
}
IOA supports three consensus modes:
| Mode | Logic | Fail-Safe |
|---|---|---|
| Majority | ≥ 50% agreement | DENY wins ties |
| Unanimous | 100% agreement | Disagreement → DENY |
| Weighted | Sum(vote × weight) | Configurable threshold |
Example Majority:
Example Weighted:
Clients can verify Evidence Bundles using IOA’s public certificate:
# Extract signature
jq -r '.signature.signature_value' evidence.json > signature.b64
# Extract canonical payload
jq -cS 'del(.signature)' evidence.json > payload.json
# Verify (requires IOA public cert)
openssl dgst -sha256 -verify ioa_public.pem \
-signature <(base64 -d signature.b64) payload.json
IOA’s Trust Root CA is:
SHA256:A1:B2:C3:... (published at trust.orchintel.com/ca.crt)Evidence Bundles are retained based on jurisdiction:
| Jurisdiction | Retention Period | Regulation |
|---|---|---|
| US-HIPAA | 7 years | 45 CFR §164.316(b)(2)(i) |
| US-SOX | 7 years | Sarbanes-Oxley §802 |
| EU-GDPR | Varies (1-10 years) | GDPR Article 17 |
| US-FDA | Device lifetime + 2 years | 21 CFR Part 11 |
| UK-MHRA | 5 years | GxP Guidelines |
Evidence Bundles are stored in:
Encryption:
Full evidence bundle with all fields:
curl https://orchintel.com/evidence/EVID-2025-01-27-00123.json
Formatted report with syntax highlighting:
curl https://orchintel.com/evidence/EVID-2025-01-27-00123.html
Detached signature for verification:
curl https://orchintel.com/evidence/EVID-2025-01-27-00123.json.sig
Complete evidence package (JSON + signature + certificates):
curl https://orchintel.com/evidence/EVID-2025-01-27-00123.tar.gz
GET /api/v1/evidence/{evidence_id}
GET /api/v1/evidence?start=2025-01-01&end=2025-01-31
GET /api/v1/evidence?decision=DENY
Find cases where models disagreed:
GET /api/v1/evidence?quorum_disagreement=true
index=ioa_evidence sourcetype=json
| spath evidence_id, quorum.decision, jurisdiction
| stats count by quorum.decision
from datadog import initialize, api
initialize(api_key='YOUR_KEY', app_key='YOUR_APP_KEY')
api.Event.create(
title="IOA Governance Decision",
text=f"Decision: {evidence['quorum']['decision']}",
tags=[f"jurisdiction:{evidence['jurisdiction']}"]
)
_sourceCategory=ioa/evidence
| json "quorum.decision", "jurisdiction", "evidence_id"
| where decision = "DENY"
| count by jurisdiction
Each Evidence Bundle includes Aletheia v2.0 ethics scoring:
{
"aletheia": {
"version": "2.0",
"facets": {
"transparency": 0.95,
"reliability": 0.92,
"accountability": 1.00,
"ethics": 0.89,
"fairness": 0.87,
"sustainability": 0.94
},
"overall_score": 0.93,
"assessment_timestamp": "2025-01-27T14:32:21.456Z"
}
}
Low scores (< 0.70) trigger automatic alerts and model re-evaluation.
Evidence Bundle creation adds < 50ms overhead to governance decisions (primarily signature computation). Quorum decisions take 2-5 seconds due to parallel model evaluation.
Yes. Enterprise tier supports:
Yes. Any modification to the bundle invalidates the cryptographic signature. IOA stores canonical hashes in an append-only ledger for additional integrity verification.
Historical Evidence Bundles referencing deprecated models remain valid. IOA maintains immutable records of model versions, training data provenance, and configuration used at decision time.
Evidence Bundles can be pseudonymized (user IDs replaced with hashes) or redacted (PII removed) while maintaining cryptographic integrity. Full deletion is supported after retention periods expire.
Generated: 2025-01-27
Version: 1.0.0
Maintained by: OrchIntel Systems Ltd.