Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Inference Hooks senden Prompts aus deiner Organisation an einen von dir gewählten KI-Sicherheitsserver und halten jede Anfrage zurück, bis ein Allow- oder Deny-Verdict vorliegt, bevor Claude sie verarbeitet. Diese Seite führt dich durch das Aktivieren der Funktion, das Verbinden deines Servers und das Steuern der Durchsetzung. Was Inference Hooks sind und wann du sie einsetzen solltest, erfährst du in der Übersicht zu Inference Hooks. Wie du den KI-Sicherheitsserver selbst baust, erfährst du unter Eine Inference-Hooks-Integration entwickeln.
Du benötigst:
organization:manage in claude.ai. Die integrierten Rollen Admin, Owner und Primary Owner besitzen sie, ebenso wie jede benutzerdefinierte Rolle, der sie erteilt wurde.https://-URL auf Port 443, auf einem öffentlich erreichbaren Host, ohne Weiterleitungen erreichbar. Die vollständigen Hosting-Anforderungen sowie Anleitungen zum Bau des Servers und zur Verifizierung signierter Anfragen findest du unter Eine Inference-Hooks-Integration entwickeln.Es gibt drei Durchsetzungszustände: aus (Enforce verdicts ist ausgeschaltet: dein KI-Sicherheitsserver wird nie kontaktiert und Prompts werden nicht geprüft), Shadow (Enforce verdicts ist eingeschaltet mit Mode auf Shadow mode: dein KI-Sicherheitsserver empfängt Prompts und liefert Verdicts, aber nichts wird blockiert) und durchsetzend (Enforce verdicts ist eingeschaltet mit Mode auf Allow the request oder Block the request: ein Deny blockiert die Anfrage). Die folgenden Schritte führen eine neue Konfiguration von „aus" zu „durchsetzend".
Inference Hooks für deine Organisation erlauben
Gehe zu claude.ai > Organization settings > Data and privacy und suche den Abschnitt Inference hooks. Schalte Allow for your organization ein.
Das Einschalten schaltet die Einstellungsseite für Inference Hooks frei und setzt Enforce verdicts immer auf „aus", sodass das Erlauben der Funktion nie von selbst eine Prüfung startet: Selbst eine Konfiguration, bei der die Durchsetzung zuvor eingeschaltet war, bleibt ungeprüft, bis du Enforce verdicts im letzten Schritt wieder einschaltest.
Die Einstellungsseite für Inference Hooks öffnen
Öffne weiterhin in Data and privacy den Abschnitt Inference hooks, um zur Einstellungsseite für Inference Hooks zu gelangen. Sie befindet sich unter „Data and privacy" und nicht als eigener Eintrag in der Einstellungsnavigation, daher lautet ihr Breadcrumb Data and privacy / Inference hooks. Bis du einen Endpunkt speicherst, warnt die Seite, dass Prompts noch nicht geprüft werden, und Enforce verdicts bleibt ausgeschaltet mit einem Requires endpoint-Badge.
Deinen Endpunkt konfigurieren
Klicke auf Configure, um den Dialog Configure endpoint zu öffnen, und fülle Folgendes aus:
https://-URL, die Verdict-Anfragen empfängt. Nur https://-URLs werden akzeptiert.- statt _ verwenden und dürfen nicht mit reservierten Namen kollidieren (Request-Framing-Header wie Content-* und Host, Proxy- und Cookie-Header, Client-Adress-Header wie X-Forwarded-*, die webhook-*-Signatur-Header und das Präfix X-Anthropic-*). Werte müssen druckbares ASCII sein.Der Dialog umfasst nur diese beiden Felder plus Test connection; er fragt nicht nach der Fehlerbehandlung, die du in Schritt 6 auswählst. Sobald ein Endpunkt gespeichert ist, lautet die Schaltfläche Edit.
Die Verbindung testen
Klicke auf Test connection. Claude sendet einen synthetischen Test-Prompt an die URL und Header, die aktuell im Formular stehen, nicht an die gespeicherten Werte – gib also alle gespeicherten Header-Werte vor dem Testen erneut ein. Bei Erfolg meldet das Ergebnis, ob dein KI-Sicherheitsserver für den Test-Prompt ein Allow- oder ein Deny-Verdict zurückgegeben hat, was einen „alles ablehnen"-Standard sichtbar macht, bevor du mit der Durchsetzung beginnst.
Häufige Fehlerergebnisse:
| Ergebnis | Was zu prüfen ist |
|---|---|
| URL abgelehnt | Die URL hat eine Strukturprüfung nicht bestanden. Verwende eine https://-URL auf Port 443. |
| Private oder interne IP | Der Host löst zu einer privaten oder internen Adresse auf. Verwende einen öffentlich erreichbaren Host. |
| Timeout | Der KI-Sicherheitsserver hat innerhalb des Timeouts kein Verdict zurückgegeben. |
| Transportfehler | DNS-Auflösung, TLS-Handshake oder Verbindung sind fehlgeschlagen. |
| Nicht-200-Status | Der KI-Sicherheitsserver hat mit einem anderen Status als 200 geantwortet. Verdicts müssen als HTTP 200 zurückkommen; Weiterleitungen werden nicht verfolgt und zählen als Fehler. |
| Nicht parsbare Antwort | Der KI-Sicherheitsserver hat geantwortet, aber der Body ist kein gültiges Verdict. |
Speichern und dein Signing Secret sichern
Speichere die Endpunkt-Konfiguration. Beim ersten Speichern wird dein Webhook-Signing-Secret generiert und einmalig angezeigt. Kopiere es und speichere es sicher, bevor du den Dialog schließt: Das Secret kann später nicht mehr abgerufen, sondern nur rotiert werden.
Dein KI-Sicherheitsserver verwendet dieses Secret, um die Signatur jeder empfangenen Anfrage zu verifizieren. Das Verifizierungsverfahren findest du unter Die Signatur verifizieren.
Fehlerbehandlung und Timeout wählen
Lege unter Failure handling mit Mode fest, was passiert, wenn der KI-Sicherheitsserver nicht erreichbar ist oder Verdicts ein Timeout erreichen:
Die dritte Option des Dropdowns, Shadow mode, ist ein Rollout-Werkzeug und keine Fehlerrichtlinie; siehe Shadow Mode.
Lege dann Prompt verdict timeout (ms) fest: 1 bis 10.000 ms, mit einem Standardwert von 5.000 ms. Das Budget deckt den gesamten Austausch ab, und ein langsameres Verdict zählt als nicht erreichbarer Server – wähle also den niedrigsten Wert, den dein Server zuverlässig einhalten kann.
Änderungen in diesem Abschnitt werden sofort gespeichert. Beim ersten Speichern sind die Standardwerte Allow the request und 5.000 ms.
Einen Rollout-Prozentsatz wählen
Lege unter Rollout mit Requests inspected (%) fest, für welchen Prozentsatz der Anfragen die Prüfung läuft, während du deinen KI-Sicherheitsserver hochfährst. Der Wert reicht von 0 bis 100: 100 prüft alles, und 0 schaltet die Prüfung aus.
Jede Anfrage würfelt einmal für ihren gesamten Konversations-Turn, sodass eine einzelne Konversation über mehrere Turns hinweg teilweise geprüft sein kann. Anfragen außerhalb des gesampelten Prozentsatzes laufen ohne Prüfung durch, selbst wenn die Fehlerbehandlung auf Block the request gesetzt ist.
Enforce verdicts einschalten
Um Verdicts gegen Live-Traffic auszuwerten, ohne zunächst jemanden zu blockieren, setze Mode auf Shadow mode (Schritt 6), bevor du die Durchsetzung einschaltest; siehe Shadow Mode.
Schalte Enforce verdicts ein, um Claude für jeden überwachten Prompt vom Verdict deines KI-Sicherheitsservers abhängig zu machen, und bestätige dann im Dialog, der deine Wahl zur Fehlerbehandlung noch einmal anzeigt. Rechne mit etwa einer Minute, bis die Änderung jeden Anthropic-Server erreicht; bereits laufende Anfragen werden unter der alten Einstellung abgeschlossen. Das Ausschalten stoppt das Senden von Prompts an deinen KI-Sicherheitsserver, ebenfalls innerhalb von etwa einer Minute; deine Konfiguration bleibt erhalten.
Der Shadow Mode führt deinen Hook gegen Live-Traffic aus, ohne etwas zu blockieren. Dein KI-Sicherheitsserver empfängt überwachte Prompts und liefert Verdicts genau wie bei der Durchsetzung, aber nichts wird blockiert: Jede Anfrage geht zum Modell durch, selbst wenn dein Server sie ablehnt oder nicht erreichbar ist, und der Endnutzer sieht nichts davon. Nutze ihn, um deine Richtlinie anhand des echten Traffics deiner Organisation abzustimmen, bevor du mit der Durchsetzung beginnst.
Um den Shadow Mode zu verwenden, setze Mode unter Failure handling auf Shadow mode und schalte dann Enforce verdicts ein, damit Prompts an deinen KI-Sicherheitsserver fließen. Solange er aktiv ist, zeigt die Einstellungsseite ein Shadow mode — not blocking-Badge. Um den Shadow Mode zu verlassen, setze Mode zurück auf Allow the request oder Block the request; Verdicts werden wieder durchgesetzt, sobald die Durchsetzung eingeschaltet ist.
Wähle unter Exclusions Rollen aus, deren Mitglieder nicht von Inference Hooks erfasst werden: Ihre Prompts werden nie an deinen KI-Sicherheitsserver gesendet. Nur benutzerdefinierte Rollen, die deine Organisation erstellt hat, können ausgeschlossen werden; die integrierten Rollen werden nicht angeboten. Wähle sie im Rollen-Selektor aus, dessen Platzhalter Select roles to exclude lautet, und verwalte auf der Rollen-Admin-Seite (Manage roles), wer welche Rolle innehat; das Ändern von Ausschlüssen erfordert die Berechtigung zur Identitätsverwaltung. Die Liste ist standardmäßig leer, und ohne ausgeschlossene Rollen wird jede überwachte Anfrage geprüft.
Der Ausschluss gilt für die interaktiven Sitzungen eines Nutzers; Traffic, der über Maschinen-Zugangsdaten authentifiziert wird, wird immer geprüft. Wenn Claude die Rollenzugehörigkeit eines Anfragenden nicht auflösen kann, schlägt die Anfrage mit einem wiederholbaren Fehler fehl (Fail Closed), anstatt ungeprüft durchzulaufen. Änderungen an der Ausschlussliste werden im Audit-Trail aufgezeichnet.
Lege unter Custom blocked prompt message einen benutzerdefinierten Text von bis zu 500 Zeichen fest, der an die Fehlermeldung angehängt wird, die ein Endnutzer sieht, wenn dein KI-Sicherheitsserver eine Anfrage ablehnt (typischerweise, wen man kontaktieren oder wo man eine Ausnahme beantragen kann). Die endgültige Nachricht besteht aus dem anfragespezifischen deny_reason deines KI-Sicherheitsservers (falls vorhanden), einer Leerzeile und dann diesem Text. Ohne konfigurierten benutzerdefinierten Text weist ein integrierter Standardtext den Nutzer an, sich an seine Administratoren zu wenden; du kannst die angehängte Nachricht auch vollständig ausschalten, sodass der Nutzer nur den deny_reason sieht.
Der Bereich zur Endpunkt-Gesundheit auf der Einstellungsseite für Inference Hooks zeigt:
Das Panel arbeitet nach dem Best-Effort-Prinzip: Wenn Anthropic die Zähler nicht lesen kann, zeigt es null Fehler und keine Fehlermeldungen statt eines eigenen Fehlers an – ein gesund aussehendes Panel ist also für sich genommen kein Beweis dafür, dass dein KI-Sicherheitsserver gesund ist. Failures per minute zählt jeden Fehler, einschließlich der Netzwerk- und DNS-Fehler, die den Circuit Breaker nie auslösen, sodass der Wert hoch sein kann, während Circuit breaker tripped leer bleibt.
Anhaltende Webhook-Fehler, die deinem KI-Sicherheitsserver zuzuschreiben sind, lösen den Circuit Breaker aus, der die Durchsetzung stoppt: Dein Server wird nicht mehr kontaktiert, und deine Failure handling-Wahl gilt für jede geprüfte Anfrage. Mit Block the request ausgewählt werden Nutzer in deiner Organisation blockiert, bis du handelst. Wenn der Breaker auslöst, werden Administratoren auch im Benachrichtigungscenter von claude.ai informiert.
Zur Wiederherstellung behebe das Problem am Server und schalte dann Enforce verdicts wieder ein, um den Breaker zurückzusetzen.
Klicke unter Request signing auf Rotate secret, um dein Signing Secret zu ersetzen. Die Rotation ist ein sofortiger Wechsel: Das neue Secret wird generiert und einmalig angezeigt, das alte Secret kann nicht mehr abgerufen werden, und keine Anfrage wird jemals mit beiden Secrets signiert – es gibt also keine Überlappungsphase, auf die du dich verlassen kannst.
Mit dem vorherigen Secret signierte Anfragen können nach der Rotation noch kurz eintreffen; Die Signatur verifizieren beschreibt, wie dein KI-Sicherheitsserver den Wechsel handhaben sollte.
Inference-Hooks-Aktivität wird im Activity Feed deiner Organisation aufgezeichnet: Konfigurationsänderungen, Ablehnungen und Anfragen, die unter deiner Fehlerbehandlungseinstellung ohne Prüfung durchgelaufen sind. Ablehnungsdatensätze enthalten Identifikatoren, mit denen du jede Ablehnung dem passenden Datensatz in deinem eigenen System zuordnen kannst.
Es gibt zwei Stufen von „aus":
Baue den KI-Sicherheitsserver: die Request- und Verdict-Schemas, Signaturverifizierung und Betriebssemantik.
Was Inference Hooks sind, wie der Verdict-Roundtrip funktioniert und was an deinen KI-Sicherheitsserver gesendet wird.
Was this page helpful?