Manuellen Angriffsmodus beenden

POST /v1/attack-protection/attack-mode:deactivate · Berechtigung attack-protection:write

Beendet sofort den Angriffsmodus-Zeitraum, den Sie mit activate eingeschaltet haben. Dabei werden das Ereignis attack_mode_deactivated und ein Verwaltungs-Audit-Eintrag (attack_mode.deactivated) geschrieben; Akteur ist Ihre Anmeldeinformation.

Nur Ihr manueller Zeitraum endet. Ein Zeitraum, der durch den automatischen Auslöser oder durch den KeenAuth-Betrieb geöffnet wurde, kann nicht vorzeitig beendet werden: Solange er offen ist, meldet die Antwort weiterhin active: true. Ist kein manueller Zeitraum offen, wird nichts geschrieben und der aktuelle Status zurückgegeben; der Aufruf kann daher gefahrlos wiederholt werden.

Anfrage

Kein Body.

Antwort

200 OK mit dem aktuellen Status, so wie ihn GET /v1/attack-protection/attack-mode zurückgibt.

Fehler

Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.

HTTP code Wann
401 unauthenticated Der API-Schlüssel fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Dem Schlüssel fehlt die Berechtigung attack-protection:write.
429 rate_limited Das Ratenlimit wurde überschritten; beachten Sie Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut.

Beispiel

curl -X POST https://api.eu.keenauth.com/v1/attack-protection/attack-mode:deactivate \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth attack-protection attack-mode deactivate