Skip to content
↑↓ to move · Enter to openEsc to close
Glossary · Keys and discovery

The root authority key: AgenID's trust anchor, not yet created

Updated

Every verification system has to start trust somewhere. In AgenID that starting point is a single root authority key, whose public value is to be published in the public specification repository and pinned by verifiers, so nobody has to rely only on TLS to agenid.com.

The status is plain: the mechanism is specified and testable, and the key itself does not exist. That is why the reference deployment issues nothing above L1_REGISTERED today.

Definition

The root authority key is the Ed25519 trust anchor at the top of AgenID's verification model: the key whose signature makes an assertion above L1_REGISTERED valid, and whose public value verifiers pin out of band. It has not been created yet.

Also known as: trust anchor, AgenID root key

How it works in AgenID

The specification defines an authority registry document at /.well-known/agenid/authorities.json on agenid.com, listing each recognized authority's domain and authority key, signed by the root authority key. A verifier checks it over TLS and against the pinned root value; disagreement is trust_anchor_mismatch, a hard fail. That document is deliberately not published today, because a pin for a key that does not exist would be a false claim.

The pin would live in the specification repository precisely because that channel is separate from the registry, so a verifier can compare the two.

Why it matters

L2, L3 and L4 all require a VerificationAssertion signed by a root authority key; see verification levels. Without it, AgenID can show that an operator signed a declaration but not that anyone checked it. The creation ceremony is gated on hardening the agenid.com zone and the GitHub organization first, because an attacker controlling either could publish a different pin without touching the key. Custody in a hardware security module is planned.

What it does not mean

A root key would anchor verification, not permission: it would sign what was checked, never what an agent is allowed to do. v1.1.1 also has no delegation object, so the root would sign assertions directly; a v1.2 delegation design that narrows that exposure is a draft, not available.

Frequently asked questions

When will the root authority key exist?

No date is published. The ceremony has prerequisites that must close first, and the trust page tracks what is live.

Does AgenID work without it?

Yes, at L1_REGISTERED. Registration, resolution, the Verification Card and badges are live, and every signature is re-verifiable offline at /verify.

Why pin a key instead of relying on HTTPS?

A verifier that relies only on TLS is relying on AgenID's infrastructure. Checking a pinned value as well is independent verification.

What agenid.com issues today

The reference deployment at agenid.com issues DECLARED and L1_REGISTERED only. L2_DOMAIN_VERIFIED and higher require a VerificationAssertion signed by a root authority key, and that key has not been created yet. L5 is reserved by the specification and is not issuable at all.

Identity is not permission

Which agent is acting and who declared it is one question. What that agent is allowed to do is another, and it stays with the party on the other side and with the operator. Protocol v1.1.1 defines no signed authorization object.

Sources

  1. AgenID protocol specification (public repository)

Give your agent an identity

Register an agent in the browser — the signing key is generated on your device and never sent to AgenID — or resolve an existing AgenID and re-check its signature yourself.