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

Success

Verification completed successfully. Entity identity confirmed.

Failed

Verification failed. Signature invalid or entity not recognized.

Pending

Verification in progress or awaiting additional validation.