Skip to main content
Browse docs
By Audience
Getting Started
Configuration
Use Cases
IDE Integration
Third-Party Integrations
Engineering Cache
Console
API Reference
Gateway
Workflow Guides
Templates
Providers and SDKs
Industry Guides
Advanced Guides
Browse by Role
Deployment Guides
In-Depth Guides
Tutorials
FAQ

Generate Compliance Reports from the Console

When auditors ask "how do you govern AI?", you need more than a slide deck — you need evidence. The Keeptrusts console lets you generate compliance reports that combine policy enforcement data, audit logs, escalation metrics, and configuration history into auditor-ready packages.

Use this page when

  • Auditors need evidence of your AI governance controls (SOC 2, HIPAA, or custom frameworks).
  • You want to export audit logs, generate compliance packages, or track policy compliance status.
  • You are setting up scheduled reports for continuous compliance evidence.

Primary audience

  • Primary: Compliance Officers and Technical Leaders preparing audit evidence
  • Secondary: Technical Engineers configuring exports, Security Analysts reviewing audit logs

What You'll Accomplish

  • Export audit logs filtered by time range, team, and event type
  • Collect evidence for SOC 2, HIPAA, and other compliance frameworks
  • Track policy compliance status across your organization
  • Build custom reports tailored to your regulatory requirements
  • Schedule recurring report generation for continuous compliance

Export Workflows

Navigate to Exports in the console sidebar to create and manage report exports.

Creating an Export

  1. Click New Export
  2. Select the export type:
Export TypeContents
Audit LogAll console and API actions within the selected period
EventsGateway decision events (allowed, blocked, escalated)
EscalationsEscalation history with resolution details
ConfigurationsPolicy configuration versions and change history
Compliance PackageCombined report with all of the above
  1. Set filters: time range, team scope, gateway, severity
  2. Choose the output format: CSV, JSON, or PDF (for compliance packages)
  3. Click Generate

The export runs as a background job. When complete, download it from the Exports page or receive a notification on your configured channel.

# Example export configuration
export:
type: compliance_package
time_range:
start: "2025-01-01T00:00:00Z"
end: "2025-03-31T23:59:59Z"
scope:
teams: ["all"]
gateways: ["all"]
format: pdf
include:
- audit_log
- events_summary
- escalation_report
- configuration_changelog
- policy_compliance_status
notify_on_complete: "email:compliance@acme.com"

Export creation dialog

Evidence Collection

Compliance frameworks require specific categories of evidence. The Keeptrusts console organizes evidence collection around common audit requirements.

SOC 2 Evidence

SOC 2 audits focus on security, availability, processing integrity, confidentiality, and privacy. Keeptrusts maps to these trust service criteria:

Trust Service CriteriaKeeptrusts Evidence
CC6.1 — Logical accessAudit log of user authentication, role assignments, and access key management
CC6.2 — Access removalSCIM deprovisioning events, session revocations
CC7.1 — System monitoringGateway health metrics, error rate trends, alerting rule configurations
CC7.2 — Incident responseEscalation history, SLA compliance metrics, resolution actions
CC8.1 — Change managementConfiguration version history, validation evidence, deployment records

To generate a SOC 2 evidence package:

  1. Navigate to Exports → Compliance Packages
  2. Select SOC 2
  3. Set the audit period
  4. Click Generate

The package includes a cover page mapping each evidence artifact to the corresponding trust service criteria.

HIPAA Audit Support

For healthcare organizations, Keeptrusts provides HIPAA-specific evidence:

HIPAA RequirementKeeptrusts Evidence
Access controls (§164.312(a))RBAC configuration, SSO/MFA enrollment records
Audit controls (§164.312(b))Complete audit log with user actions and timestamps
Integrity controls (§164.312(c))Policy enforcement records showing PHI detection and blocking
Transmission security (§164.312(e))Gateway TLS configuration, encryption-at-rest status

Generate HIPAA evidence the same way as SOC 2, selecting HIPAA as the compliance framework.

Custom Framework Support

For organizations with bespoke compliance requirements:

  1. Navigate to Exports → Compliance Packages → Custom
  2. Define your framework sections
  3. Map each section to the Keeptrusts data sources it requires
  4. Save the framework template for reuse
  5. Generate reports on demand or on schedule

Audit Log Download

The audit log is the foundation of compliance evidence. It records:

  • Authentication events — login, logout, failed login, MFA challenges
  • Authorization events — role changes, team membership updates
  • Configuration changes — policy updates, gateway deployments, template modifications
  • Escalation actions — claim, resolve, reassign, expire
  • Financial events — wallet allocations, top-ups, cost ticket resolutions
  • Security events — API key creation/revocation, SSO configuration changes

Filtering the Audit Log

Apply filters before download to reduce noise:

  • Date range — select the audit period
  • User — filter by specific user actions
  • Action type — narrow to authentication, configuration, or escalation events
  • Team — scope to a specific team
  • Severity — focus on high-impact events

Download Formats

FormatUse Case
CSVSpreadsheet analysis, custom reporting tools
JSONSIEM ingestion, programmatic analysis
PDFAuditor delivery, management review

Policy Compliance Status

The compliance status page gives you a real-time view of how well your organization adheres to its configured policies:

  • Active policies — count of policies currently enforced across all gateways
  • Policy coverage — percentage of gateways with at least one active policy
  • Enforcement rate — percentage of requests that pass through at least one policy rule
  • Violation rate — percentage of requests that trigger a block or escalation
  • Configuration drift — gateways running outdated configuration versions

Compliance Score

Keeptrusts calculates a composite compliance score (0–100) based on:

  • Policy coverage across gateways
  • SLA compliance for escalations
  • Configuration version currency
  • Security settings (SSO, MFA, key rotation)
  • Audit log completeness

The score is displayed on the Dashboard and included in compliance reports.

Custom Report Builders

Build reports that answer your organization's specific questions:

  1. Navigate to Exports → Report Builder
  2. Select data sources: events, escalations, audit log, configurations, spend
  3. Add visualizations: tables, bar charts, trend lines, pie charts
  4. Apply filters and groupings
  5. Add narrative sections with text blocks
  6. Preview and export as PDF

Report Sections

Common sections to include:

SectionContents
Executive summaryCompliance score, key metrics, notable incidents
Policy enforcementBlock rates, escalation volumes, resolution outcomes
Access controlUser and role activity, provisioning/deprovisioning
Change managementConfiguration changes, deployment history
Incident responseEscalation SLA compliance, resolution times
Financial controlsSpend tracking, budget adherence, cost ticket history

Scheduled Reports

Automate report generation for continuous compliance:

  1. Navigate to Exports → Schedules
  2. Click Create Schedule
  3. Select the report template or compliance package type
  4. Set the frequency: weekly, monthly, or quarterly
  5. Configure delivery: download link via email, or direct upload to S3-compatible storage
  6. Click Save

Scheduled reports run automatically and notify the configured recipients when complete.

# Example scheduled report
scheduled_report:
name: "Monthly SOC 2 evidence package"
template: soc2
frequency: monthly
day_of_month: 1
delivery:
email:
- "compliance@acme.com"
- "auditor@external-firm.com"
s3:
bucket: "acme-compliance-evidence"
prefix: "keeptrusts/soc2/"

Business Outcomes

OutcomeHow Compliance Reporting Delivers It
Audit readinessPre-built SOC 2 and HIPAA packages eliminate last-minute evidence scrambles
Continuous complianceScheduled reports and real-time compliance scores catch gaps before auditors do
Reduced audit costSelf-service evidence collection reduces the hours your team spends gathering artifacts
Stakeholder confidenceExecutive-friendly compliance scores and reports demonstrate governance maturity

Next steps

For AI systems

  • Canonical terms: compliance package, audit log, compliance score, evidence collection, export type (Audit Log, Events, Escalations, Configurations, Compliance Package), scheduled report.
  • Console navigation: Exports → New Export, Exports → Compliance Packages, Exports → Report Builder, Exports → Schedules.
  • Frameworks supported: SOC 2 (CC6.1, CC6.2, CC7.1, CC7.2, CC8.1), HIPAA (§164.312), custom frameworks.
  • Output formats: CSV, JSON, PDF.
  • Best next pages: Security Settings, Escalation Management, Export Workflows (CLI).

For engineers

  • Navigate to Exports → New Export; select type, set time range/scope/format, click Generate.
  • For SOC 2: Exports → Compliance Packages → SOC 2 → set audit period → Generate (includes trust-service-criteria mapping).
  • Scheduled reports: Exports → Schedules → Create Schedule; set frequency and delivery (email or S3).
  • Compliance score is displayed on the Dashboard and factors in policy coverage, SLA compliance, config currency, and security settings.
  • For CLI-based exports, see Export Workflows — the same underlying export engine.

For leaders

  • Self-service evidence packages reduce the hours your team spends gathering artifacts for auditors.
  • Scheduled reports ensure compliance evidence is always current — no last-minute scrambles before an audit.
  • The composite compliance score gives executives a single number for governance maturity, updated in real time.
  • SOC 2 and HIPAA mapping removes the guesswork of which Keeptrusts data satisfies which control.