Konfigurieren einer benutzerdefinierten Antwort für Azure Application Gateway WAF

Wenn die Azure Web Application Firewall (WAF) in Azure Application Gateway eine Anforderung aufgrund einer übereinstimmenden Regel blockiert, wird standardmäßig ein 403-Statuscode mit der Meldung "Die Anforderung ist blockiert" zurückgegeben. Sie können die Antwort anpassen, indem Sie einen benutzerdefinierten Statuscode und eine Nachricht für Ihren Anwendungsfall konfigurieren.

Dieser Artikel zeigt Ihnen, wie Sie eine benutzerdefinierte Antwortseite konfigurieren, wenn die Web Application Firewall (WAF) von Azure Application Gateway eine Anfrage durch die Nutzung des Azure-Portals blockiert. Du kannst auch benutzerdefinierte Antworten mit der Azure CLI oder PowerShell konfigurieren.

Konfigurieren eines benutzerdefinierten Antwortstatuscodes und einer Nachricht

Führen Sie die folgenden Schritte aus, um den Antwortstatuscode und den Antworttext anzupassen:

  1. Wechseln Sie im Azure-Portal zu Ihrer WAF-Richtlinie für das Anwendungsgateway.

  2. Wählen Sie unter "Einstellungen" die Option "Richtlinieneinstellungen" aus.

  3. Im Abschnitt Benutzerdefinierte Antwort geben Sie den benutzerdefinierten Antwortstatuscode und den Antwortkörper in Block Response Status Code bzw. Block Response Body ein.

    Screenshot der Azure Web Application Firewall-Richtlinieneinstellungen.

  4. Wählen Sie Speichern aus.

Dieses Beispiel ändert den Standard-403-Antwortcode auf 429 und setzt die kurze Nachricht Die Anfrage wurde blockiert.

Screenshot eines benutzerdefinierten Antwortbeispiels.

Einschränkungen

Die folgenden Einschränkungen gelten, wenn Sie benutzerdefinierte Antworten für Azure Application Gateway WAF konfigurieren:

  • Sie können bis zu 20 WAF-Richtlinien mit einem benutzerdefinierten Blockantwort-Statuscode und -Body innerhalb eines Application Gateway aktivieren.
  • Sie können einen der folgenden benutzerdefinierten Statuscodes verwenden: 200, 403, 405, 406, 429, 990, 991, 992, 993, 994, 995, 996, 997, 998, 999.
  • Die maximale Größe für den benutzerdefinierten Blockantwortkörper beträgt 32 KB.
  • Sie müssen die Base64-Codierung für den benutzerdefinierten Blockantworttext verwenden, wenn Sie die Azure Resource Manager (ARM)-API verwenden.
  • Benutzerdefinierter Blockantwort-Statuscode und -Text werden im Application Gateway für Container-WAF nicht unterstützt.