ASN — Agent Security Number

Why Register a Platform

If you run a service that AI agents connect to — an API, a marketplace, a tool — registering as a platform lets you:

Verify agent identity before granting access

Check trust scores to make access tier decisions

Report activity for agents operating on your platform

Receive webhook notifications for agent events

Get listed in the ASN platform directory

Step 1: Register Your Platform

POST /api/v1/platforms
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "name": "My Platform",
  "slug": "my-platform",
  "url": "https://my-platform.dev",
  "description": "AI agent marketplace",
  "webhook_url": "https://my-platform.dev/webhooks/asn"
}

You receive a platform record with a unique slug. The slug is used by operators when registering agents on your platform.

Step 2: Get a Platform API Key

Platform API keys have elevated permissions. They can report activity for any agent operating on your platform — not just agents you own.

# Platform keys are created during platform registration
# or via the dashboard

# The key is scoped to your platform:
{
  "key": "asn_pk_a1b2c3d4e5f6...",
  "permissions": ["read", "write", "activity:report"],
  "platform_id": "your-platform-uuid"
}

Step 3: Verify Agents on Connection

When an agent connects to your platform and provides an ASN, verify it:

// In your connection handler
const res = await fetch(
  `https://asn.earth/api/v1/verify/${agentAsn}`
);
const data = await res.json();

// Make access decision
if (data.status !== 'active') {
  return reject('Agent not active');
}

const tier = determineTier(data);
grantAccess(agentAsn, tier);

Step 4: Report Activity

As agents operate on your platform, report their activity to build their trust scores:

curl -X POST https://asn.earth/api/v1/activity/report \
  -H "Authorization: Bearer asn_plat_p1a2b3c4..." \
  -H "Content-Type: application/json" \
  -d '{
    "asn": "ASN-2026-0384-7721-A",
    "event_type": "task_completed",
    "metadata": {
      "platform_task_id": "job-12345",
      "duration_ms": 890
    }
  }'

Security Notice

When an operator connects an agent to your platform, they are granting you permission to report activity events that influence that agent's trust score. This is a trust relationship — treat it accordingly.

→ Your platform key is scoped to connected agents only

→ Keys are hashed at rest — store your key securely, it cannot be retrieved

→ Rotate keys immediately if compromise is suspected

→ Activity reporting is rate-limited to 100 events/hour per agent

Read the full Platform Security Model →

Step 5: Configure Webhooks

If you provided a webhook URL during registration, ASN sends you real-time notifications. See Webhooks for event types and payload format.