Server-seitige Verifizierung

Verifizieren Sie die SilentShield-Nonce immer auf Ihrem Server. Nur clientseitige Prüfungen können von Bots umgangen werden.

Warum serverseitig?

Das Widget läuft im Browser und injiziert eine Nonce in Formulare. Ein Bot könnte das Widget überspringen und das Formular direkt absenden. Die serverseitige Verifizierung stellt sicher, dass die Nonce legitim ausgestellt und von SilentShield geprüft wurde.

API-Endpoint

Method

POST

URL

https://api.silentshield.io/api/v1/captcha/verify-nonce

Headers

X-Api-Key: IHR_API_KEY Content-Type: application/json

Body

{ "nonce": "die-nonce-aus-dem-formular" }

Antwort-Format

{
  "ok": true,
  "verdict": "human",
  "confidence": 0.92,
  "requested_nonce": "..."
}

human

human — Benutzer ist sehr wahrscheinlich ein Mensch. Formular verarbeiten.

suspicious

suspicious — Benutzer könnte ein Bot sein. Zusätzliche Prüfung erwägen.

bot

bot — Hohe Sicherheit, dass dies ein Bot ist. Formular ablehnen.

Empfohlene Logik

In den meisten Fällen reicht die Prüfung des verdict-Feldes:

if verdict == "bot":
    Formular ablehnen (403)
elif verdict == "suspicious":
    optional zusätzliche Verifizierung
else:
    Formular normal verarbeiten

Fehlerbehandlung

Wenn die SilentShield-API nicht erreichbar ist (Timeout, 5xx-Fehler), entscheiden Sie sich für eine Strategie:

Fail Open

Fail Open — Formular akzeptieren (bessere UX, weniger sicher)

Fail Closed

Fail Closed — Formular ablehnen (sicherer, schlechtere UX)