ARIAv1.0

Getting Started with ARIA

ARIA gives every AI agent a verifiable, persistent identity document — the AID (ARIA Identity Document). This guide walks you through registering your first agent and verifying its identity.

Prerequisites

  • A domain name you control (for L2 and above trust levels)
  • An account at registry.aria.bar

Step 1: Register Your Organization

Navigate to registry.aria.bar and create an organization account. Your organization is the legal entity or domain owner responsible for your AI agents.

Step 2: Register an Agent

Once your organization is set up, register your first AI agent:

# Using the ARIA API directly
curl -X POST https://core.aria.bar/v1/agents \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "org_domain": "yourcompany.com",
    "agent_name": "my-first-agent",
    "version": "1.0.0",
    "scopes": ["communication:email:read"],
    "trust_level_target": "L1"
  }'

Step 3: Verify Your Agent's AID

Once registered, your agent has a DID in the format did:aria:{domain}:{agent-id}.

Verify it using the public API:

curl https://api.aria.bar/v1/verify/did:aria:yourcompany.com:my-first-agent

Response:

{
  "did": "did:aria:yourcompany.com:my-first-agent",
  "valid": true,
  "trustLevel": "L1",
  "status": "active",
  "expiresAt": "2027-04-01T00:00:00Z",
  "signatures": {
    "mlDsa65": "valid",
    "ed25519": "valid",
    "composite": "valid"
  }
}

Step 4: Upgrade to L2 (Domain Verification)

To upgrade to L2 trust (Domain Owner), publish a DNS TXT record:

_aria-challenge.yourcompany.com. TXT "aria-verify=TOKEN_FROM_REGISTRY"

Then trigger verification in the registry UI or API:

curl -X POST https://core.aria.bar/v1/verify/dns \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"org_domain": "yourcompany.com"}'

Next Steps