invalid_signature
HTTP 401 · Ludion-Error: invalid_signature
What happened
Section titled “What happened”Your request carried a Web Bot Auth signature, the Gate found your key, and the signature did not hold. The Gate treats that as a spoofing attempt, whatever the cause. Common causes:
- the request changed after signing (a proxy rewrote a header, the body changed);
- the signature was made for another host:
@authoritymust be this site; - the clock:
createdis in the future, orexpireshas passed, beyond ±30 seconds of skew (spec §10.4); - the lifetime
expires − createdis longer than 60 seconds (spec §10.4); tagis notweb-bot-auth, or theSignature-Agentdictionary key does not match the signature label;- the same signature (or nonce) was sent again: a signature cannot be reused.
Why this site asks
Section titled “Why this site asks”A signature is only worth something if a forged or replayed one never passes. The Gate rejects every signature it cannot verify exactly as sent, so that no one can borrow your name, and so that you can trust a VERIFIED result about anyone else.
How to fix it
Section titled “How to fix it”- Make a new signature for every request, just before sending it, and change nothing afterwards.
- Sign for the host you are calling, and keep the lifetime at 60 seconds or less (spec §10.4).
- Sync your clock (NTP).
npx ludion doctorshows the time it signs with. - For POST, PUT, PATCH and DELETE, also cover
@method,@pathandcontent-digest.npx ludion signdoes this for you.
Get verified in 3 minutes
Section titled “Get verified in 3 minutes”Ludion does not replace Web Bot Auth: any agent that signs requests with Web Bot Auth (RFC 9421) and publishes its key directory is already VERIFIED by Ludion Gates, at depth 0. If you have not signed anything yet, the free Ludion CLI gets you there.
Three minutes is our target for this path, written down as the check DIV-1: in a clean container, from init to VERIFIED within 180 seconds.
-
Create your agent identity (a Diver). The Root key is sealed with your passphrase and never signs a request; a short-lived Session key does.
Terminal window npx ludion init --name "My Agent" --contact mailto:you@example.com -
Publish the public files it wrote at your
Signature-Agentorigin over HTTPS:.well-known/http-message-signatures-directory(your keys, served asapplication/http-message-signatures-directory+json) andcard(who you are). Your own domain works; so willdvr-….agents.ludion.aionce registration opens. -
Sign each request. This prints a ready-to-run
curlwith theSignature-Agent,Signature-InputandSignatureheaders; a signature lives 60 seconds (spec §10.4), so make a new one per request.Terminal window npx ludion sign GET https://shop.example/checkout --curl -
Check yourself.
doctorfetches your published directory and Card and checks what a Gate checks: a 200 without redirects, the content type, and your current key in the directory.Terminal window npx ludion doctor
A Gate now classifies your requests as VERIFIED. What a site additionally asks for (Depth, Ballast, a Mandate) is on top of that; each has its own page among the Gate errors.