WhisperDocs
Verify & authorize

For site owners: what a Whisper agent is, and how to verify one

A request from a Whisper agent comes from an address you can look up. This page is for the people who run the sites those requests reach: what the agent is, the three ways to check one, what we do not promise, and where to report one.

Every capture on this page was taken from production between 2026-11-02 and 2026-11-04 with stock tools, and all but two with no account: the signed request and the User-Agent capture below needed an agent to send them. Re-run any of them yourself; the commands are the evidence.

What a Whisper agent is

A Whisper agent is software acting for a person who asked it to do something: an AI assistant fetching a page, a script calling an API, a device phoning home. In Cloudflare's terms it is an intermediary acting on a user's request, not a crawler. It does not roam the web looking for pages to index.

Each agent holds exactly one IPv6 address, a /128, out of 2a04:2a01::/32. That block is registered in the RIPE database to viaGraph b.v. as WHISPER-AGENTS and originated by our own network, AS219419:

$ whois -h whois.ripe.net -B 2a04:2a01::/32
# (filtered to the lines that matter)
inet6num:       2a04:2a01::/32
netname:        WHISPER-AGENTS
org:            ORG-VB155-RIPE
status:         AGGREGATED-BY-LIR
route6:         2a04:2a01::/32
origin:         AS219419

The route is RPKI-valid (RIPEstat rpki-validation for AS219419 and 2a04:2a01::/32 returns valid). One address is one agent, so one agent can be allowed, rate-limited or blocked on its own without touching any other.

How to verify one

Three methods, from the cheapest to the strongest. Use whichever your stack already speaks.

1. The published range

curl -s https://whisper.online/.well-known/agent-ranges.json
{
  "creationTime": "2026-09-24T00:00:00.000000",
  "prefixes": [
    {
      "ipv6Prefix": "2a04:2a01::/32"
    }
  ]
}

The same shape Google, OpenAI and Anthropic publish for their own agents, so an allow-list that already reads theirs can read ours. A source address inside the prefix is a Whisper agent's address. On its own that tells you the network, not which agent; the next two methods tell you which one.

2. Forward-confirmed reverse DNS

The reverse name of an agent's address points at the agent's name, and that name points back at the same address. Both answers are DNSSEC-signed, so validate them in your own process with delv rather than trusting a resolver's AD bit (RFC 4035 section 4.9.3 explains why a stub must not rely on it).

SRC="2a04:2a01:eb5a:ca74:cef2:2a:323d:40d4"
name=$(dig +short -x "$SRC")
fwd=$(dig +short AAAA "$name")
[ "$fwd" = "$SRC" ] && echo "FCrDNS OK: $name" || echo "FCrDNS FAIL"
FCrDNS OK: acef2002a323d40d4.t7af9242c44554e0f8e183ac8e6fbf645.agents.whisper.online.
delv @1.1.1.1 -x "$SRC"
delv @1.1.1.1 AAAA "$name"
; fully validated
4.d.0.4.d.3.2.3.a.2.0.0.2.f.e.c.4.7.a.c.a.5.b.e.1.0.a.2.4.0.a.2.ip6.arpa. 60 IN PTR acef2002a323d40d4.t7af9242c44554e0f8e183ac8e6fbf645.agents.whisper.online.
; fully validated
acef2002a323d40d4.t7af9242c44554e0f8e183ac8e6fbf645.agents.whisper.online. 60 IN AAAA 2a04:2a01:eb5a:ca74:cef2:2a:323d:40d4

Two things to know before you write the rule:

$ dig -x 2a04:2a01:9::50 @1.1.1.1
;; ->>HEADER<<- opcode: QUERY, status: NXDOMAIN
1.0.a.2.4.0.a.2.ip6.arpa. 300 IN SOA ns1.whisper.online. hostmaster.whisper.online. ...

If you would rather have one answer than run the legs yourself, the same chain is checked by a keyless endpoint, and its registry record is in RDAP:

curl -s https://rdap.whisper.online/verify-identity/2a04:2a01:eb5a:ca74:cef2:2a:323d:40d4 \
  | jq '{is_whisper_agent, fqdn, tenant, dane_ok}'
curl -s https://rdap.whisper.online/ip/2a04:2a01:eb5a:ca74:cef2:2a:323d:40d4 | jq '{handle, name, status}'
{
  "is_whisper_agent": true,
  "fqdn": "acef2002a323d40d4.t7af9242c44554e0f8e183ac8e6fbf645.agents.whisper.online",
  "tenant": "t7af9242c44554e0f8e183ac8e6fbf645",
  "dane_ok": true
}
{
  "handle": "acef2002a323d40d4",
  "name": "docs-example-1",
  "status": [
    "active"
  ]
}

An address we do not hold returns {"is_whisper_agent": false}, never an error.

3. Web Bot Auth (HTTP message signatures)

Requests an agent sends through our fetch-forward gateway are signed under RFC 9421 in the Web Bot Auth profile. Each signed request carries three headers:

Header What it holds
Signature-Agent sig1="https://whisper.online", the origin that serves our key directory
Signature-Input label sig1, covering "@authority" "@method" "@path" "signature-agent";key="sig1", with alg="ed25519", tag="web-bot-auth", and a five-minute created to expires window
Signature the Ed25519 signature over that base

This is what arrives at your site. Captured on 2026-11-03: the demo agent fetched a header echo through the gateway, and the echo printed the request it received (trimmed to the headers that matter here):

$ curl -s -u "w:{egress-bearer}" https://forward.whisper.online/forward \
    -H "X-Whisper-Target: https://httpbingo.org/headers"
Signature: sig1=:YXAjyt8KaLEnh0MpzZj3XO1GbsVPnexuNAqlktfUuCxvZMa0mm3RsneXJktXxF2QXuyrpb87fU0Z8HvgxK2kAw==:
Signature-Agent: sig1="https://whisper.online"
Signature-Input: sig1=("@authority" "@method" "@path" "signature-agent";key="sig1");created=1793738577;expires=1793738877;keyid="5HtlED7Zf1gV7QBh9t6OINT4XvoBTvvRPrrPTI2Ukp4";alg="ed25519";tag="web-bot-auth"
User-Agent: curl/8.5.0
X-Forwarded-For: 2a04:2a01:9b6d:23e8:4f98:8041:b132:6d8a, 2a09:8280:1:7fcb:9efa:a365:aa2a:d036

The first X-Forwarded-For entry is the agent's /128; the second is the echo's own front end. The User-Agent is the one the agent sent. The signature base RFC 9421 builds from that request is five lines:

"@authority": httpbingo.org
"@method": GET
"@path": /headers
"signature-agent";key="sig1": "https://whisper.online"
"@signature-params": ("@authority" "@method" "@path" "signature-agent";key="sig1");created=1793738577;expires=1793738877;keyid="5HtlED7Zf1gV7QBh9t6OINT4XvoBTvvRPrrPTI2Ukp4";alg="ed25519";tag="web-bot-auth"

Checked against the x of the directory key below with Python's cryptography package (Ed25519PublicKey.verify), it verifies.

The key directory is public, and the directory response is itself signed, so a verifier can tell it came from the host it asked:

curl -sSD - https://whisper.online/.well-known/http-message-signatures-directory
HTTP/2 200
cache-control: public, max-age=86400
access-control-allow-origin: *
content-digest: sha-256=:h3XU+z1rrGFstvY2wS5DKryy6t36Qw7Wy87T2RDyebk=:
signature-input: binding=("@authority";req "content-digest");created=1793577600;expires=1794182400;keyid="5HtlED7Zf1gV7QBh9t6OINT4XvoBTvvRPrrPTI2Ukp4";tag="http-message-signatures-directory"
signature: binding=:XIAfIvvAtx7hBEkoljz7YuW8A0AlgfgUVjO1fhPIN4qsWn7Av+XTfBoMjenh/iQKXcWEVui8aptg1VddAwmzAA==:
content-type: application/http-message-signatures-directory+json

{"keys":[{"kty":"OKP","crv":"Ed25519","alg":"ed25519","use":"sig","kid":"5HtlED7Zf1gV7QBh9t6OINT4XvoBTvvRPrrPTI2Ukp4","x":"G8aeCZXIhoI0V8nxSYie1goVNiSun6BPOvLYNFTYYjM","nbf":1790294400,"exp":1796169600}]}

The kid is the RFC 7638 thumbprint of the key. The same directory is served at https://agents.whisper.online/.well-known/http-message-signatures-directory.

Which traffic is signed depends on how the agent leaves our network:

How the agent connects Source address your site sees HTTP signature Reverse DNS
fetch-forward gateway (forward.whisper.online) the agent's /128 yes yes, forward-confirmed
SOCKS5 or HTTP CONNECT proxy the agent's /128 no: a TCP tunnel, TLS runs end to end between the agent and you yes, forward-confirmed
WireGuard (routed /128) the agent's /128 no: packets, TLS runs end to end yes, forward-confirmed

We cannot sign inside a TLS session we do not terminate, and we do not break TLS to do it. For tunnelled traffic, methods 1 and 2 are the check.

The User-Agent token

A request through the fetch-forward gateway carries a fixed product token at the end of its User-Agent, after whatever the agent itself sent:

WhisperAgent/1 (+https://whisper.online/docs/verify-agents)

This is what the site sees, captured at httpbingo.org on 2026-11-04 from an agent whose own User-Agent is my-agent/2.1:

curl -s -u "w:{your-egress-bearer}" -A "my-agent/2.1" https://forward.whisper.online/forward \
  -H "X-Whisper-Target: https://httpbingo.org/user-agent"
{
  "user-agent": "my-agent/2.1 WhisperAgent/1 (+https://whisper.online/docs/verify-agents)"
}

The agent's own value is kept and the token goes last. A request with no User-Agent carries the token alone. A value that already has a WhisperAgent/ product is left as it is, so the token never appears twice. The whole field stays within 2048 characters; when an agent's value is longer, its tail is cut, never inside a comment, and the token stays. A rule that matches WhisperAgent/ in the User-Agent finds every one of these requests.

The token is a label, not proof: anyone can send it. Use it to write the rule, then check the request with one of the three methods above. The signature does not cover the User-Agent, so the token changes nothing about verifying it. Tunnelled traffic (SOCKS5, HTTP CONNECT, WireGuard) carries only what the agent's own tool sends, because we never see that HTTP; an agent can add the token itself.

What we do not promise

Report an agent

Write to security@whisper.security. It is also the abuse-mailbox of AR80195-RIPE, the abuse contact on ORG-VB155-RIPE, so whois hands it to anyone who asks:

$ whois -h whois.ripe.net -B AR80195-RIPE
# (filtered to the lines that matter)
role:           Abuse-C Role
abuse-mailbox:  security@whisper.security

Send the source /128, the time in UTC, and what it did (log lines are ideal). Each /128 is one agent and is revocable on its own: once revoked, dig -x on the address returns nothing and /verify-identity returns is_whisper_agent: false, so the same tools that identified it show it is gone. Reporting one agent never affects any other.

Next: Access control - authorize on a confirmed name · Reverse DNS & FCrDNS - the threat model behind method 2 · Verify an agent - every proof, including the trustless one