Verification events

Track and audit all verification activities for agents and MCP servers.

Verification event tracking

Verification events provide a complete audit trail of all identity verification activities in the AIM platform. Every time an agent or MCP server is verified, challenged, or changes status, a verification event is recorded with full metadata.

Why verification events matter

Compliance and audit

Complete audit trail for SOC 2, HIPAA, and GDPR compliance requirements.

Security monitoring

Detect suspicious patterns like repeated verification failures.

Trust score input

Verification success/failure rates directly impact trust scores.

Historical analysis

Analyze verification patterns over time to identify trends.

Verification event structure

{
  "id": "ve_abc123def456",
  "entityId": "agent_xyz789",
  "entityType": "agent",
  "eventType": "signature_verification",
  "status": "success",
  "details": {
    "algorithm": "Ed25519",
    "publicKeyId": "pk_abc123",
    "signatureValid": true,
    "verificationTime": 12
  },
  "ipAddress": "192.168.1.100",
  "userAgent": "AIM-SDK/1.0.0 Python/3.11",
  "organizationId": "org_abc123",
  "createdAt": "2025-01-15T10:30:00Z"
}

Event status types

The status field of a verification event holds one of these values. This list is generated from the VerificationEventStatus constants in verification_event.go in the AIM server source (commit 156e355).

success

The request was approved. The event result is verified.

failed

The request was denied. The event result is denied.

pending

No decision has been made yet.

timeout

The verification did not finish in time.