Für Shops
Immer mehr Shops verlangen, dass KI-Agenten sich zu erkennen geben. Dafür entsteht gerade ein Verfahren: Der Agent signiert seine Anfragen und nennt in der Kopfzeile Signature-Agent, wo sein öffentlicher Schlüssel liegt („HTTP Message Signatures for automated traffic“, ein Entwurf der IETF-Arbeitsgruppe Web Bot Auth, 1. September 2026, Autoren von Cloudflare und Google).
Damit wissen Sie, welcher Schlüssel unterschrieben hat. Der Entwurf sagt selbst, dass er keine Berechtigung und keine Vollmacht ausdrückt und nichts darüber aussagt, wer den Agenten betreibt. Genau diese Lücke füllt ID MANDAT.
In drei Schritten
- Signatur prüfen. Das erledigt eine Bibliothek oder Ihr Anbieter (zum Beispiel ein Content-Delivery-Netzwerk). ID MANDAT prüft die Signatur nicht.
- ID MANDAT fragen. Nehmen Sie die Adresse aus der Kopfzeile
Signature-Agentund fragen Sie nach, wer sie für sich erklärt hat. - Nach Ihrer Hausordnung entscheiden. Zum Beispiel: eingetragene Agenten dürfen Preise vergleichen, bestellen nur mit Bestätigung eines Menschen, nicht mehr gültige Einträge werden abgelehnt.
Die Abfrage
Signature-Agent: sig="https://bot.beispiel-firma.de"
curl "https://idmandat.com/api/v1/verify?signature_agent=https://bot.beispiel-firma.de"Sie können auch den ganzen Wert der Kopfzeile übergeben. Die Antwort ist wie bei der Abfrage nach Domain digital signiert (Ed25519, Beta, so prüfen Sie die Signatur) und gilt 15 Minuten. Auch KI-Agenten können direkt fragen: über unseren MCP-Server gibt es das Werkzeug verify_signature_agent.
Python
import requests
def wer_steckt_dahinter(signature_agent_header):
r = requests.get("https://idmandat.com/api/v1/verify",
params={"signature_agent": signature_agent_header}, timeout=5)
a = r.json()
if a.get("entry_state") in ("revoked", "suspended", "expired"):
return "ablehnen: Eintrag nicht mehr gültig"
if not a.get("registered") or a.get("ambiguous"):
return "unbekannt: nach eigener Hausordnung entscheiden"
agent = a["agents"][0] if a.get("agents") else {}
return a["organization"], a["level"], agent.get("may"), agent.get("mayNot")JavaScript
async function whoIsBehind(signatureAgent) {
const url = "https://idmandat.com/api/v1/verify?signature_agent=" + encodeURIComponent(signatureAgent);
const a = await (await fetch(url)).json();
if (["revoked", "suspended", "expired"].includes(a.entry_state)) return { allow: false, why: a.entry_state };
if (!a.registered || a.ambiguous) return { allow: null, why: "unknown" };
return { allow: true, company: a.organization, level: a.level, agent: a.agents[0] };
}Was die Antwort bedeutet
| Feld | Bedeutung |
|---|---|
registered | true: Ein eingetragenes Unternehmen erklärt dieses Schlüsselverzeichnis für einen seiner Agenten. |
level | verified, registered oder listed_unverified. Wie weit ID MANDAT das Unternehmen geprüft hat. |
agents[].may / mayNot | Was der Agent laut Unternehmen darf und nicht darf. Das ist die Erklärung des Unternehmens, keine Prüfung durch ID MANDAT. |
key_directory_link | same_domain: Das Schlüsselverzeichnis liegt auf der Domain des Unternehmens (oder einer Subdomain). Das ist ein Hinweis, kein Beweis. declared_only: Das Unternehmen erklärt es nur, es liegt woanders. |
entry_state | revoked, suspended, expired: Der Eintrag gilt nicht mehr. Dann nicht auf frühere Antworten verlassen. |
ambiguous | Mehrere Unternehmen erklären dasselbe Schlüsselverzeichnis. ID MANDAT kann nicht sagen, wer verantwortlich ist. |
Was ID MANDAT dabei nicht tut
- Es prüft nicht, ob die Signatur der Anfrage stimmt.
- Es prüft in dieser Version nicht, ob das Unternehmen das Schlüsselverzeichnis wirklich kontrolliert. Es steht in der Ausweis-Datei, die das Unternehmen auf seiner eigenen, per DNS bestätigten Domain ablegt. Wenn zwei Unternehmen dasselbe Verzeichnis erklären, sagen wir das ausdrücklich.
- Es bestätigt Identität und Befugnis, nicht Bonität, Vertrauenswürdigkeit oder Qualität.
- Ein fehlender Eintrag ist kein Zeichen für Fehlverhalten. Es gibt bisher nur wenige Einträge.
Hausordnung für KI-Agenten
Ein Shop kann in einer kleinen Datei festhalten, was Agenten bei ihm dürfen. Sie liegt unter /.well-known/agent-house-rules.json auf Ihrer Domain. Agenten-Betreiber sehen dann schwarz auf weiß, ob sie sich zu erkennen geben müssen, ob ein Eintrag in einem Register verlangt wird und welche Handlungen erlaubt sind, nur mit Bestätigung eines Menschen gehen oder untersagt sind.
Das ist ein eigener Vorschlag von ID MANDAT, kein Standard. Kein Agent liest diese Datei heute automatisch. Sie nützt, weil sie Ihre Regeln eindeutig festhält und Betreiber sie nachlesen können. Wenn das Format jemandem fehlt oder falsch erscheint, schreiben Sie uns.
Ihr Unternehmen und Ihre Agenten eintragen
Betreiben Sie selbst Agenten? Tragen Sie bei Ihrem Ausweis im Feld „Schlüsselverzeichnis“ die Adresse ein, die auch in Ihrer Signature-Agent-Kopfzeile steht. Dann können Shops Sie über den Schlüssel finden. Aufbau: Standard. Eintragen: 10 € im Jahr.