Domyślnie, gdy zapora aplikacji internetowej usługi Azure Front Door blokuje żądanie ze względu na dopasowaną regułę, zwraca kod stanu 403 z komunikatem "Żądanie jest zablokowane". Komunikat domyślny zawiera również ciąg odwołania do śledzenia używany do łączenia się z wpisami dziennika dla żądania.
Z tego artykułu dowiesz się, jak skonfigurować niestandardowy kod stanu odpowiedzi i niestandardowy komunikat z ciągiem referencyjnym dla danego przypadku użycia przy użyciu witryny Azure Portal, programu PowerShell lub interfejsu wiersza polecenia platformy Azure.
Wymagania wstępne
Konto Azure z aktywną subskrypcją.
Utwórz konto bezpłatnie.
Azure Cloud Shell lub Azure PowerShell.
Kroki opisane w tym artykule uruchamiają interaktywne polecenia cmdlet programu Azure PowerShell w usłudze Azure Cloud Shell. Aby uruchomić polecenia cmdlet w usłudze Cloud Shell, wybierz pozycję Otwórz usługę Cloud Shell w prawym górnym rogu bloku kodu. Wybierz pozycję Kopiuj , aby skopiować kod, a następnie wklej go w usłudze Cloud Shell, aby go uruchomić. Możesz również uruchomić usługę Cloud Shell z poziomu witryny Azure Portal.
Możesz również zainstalować program Azure PowerShell lokalnie , aby uruchomić polecenia cmdlet. Ten artykuł wymaga modułu Azure PowerShell. Jeśli uruchomisz program PowerShell lokalnie, zaloguj się do platformy Azure przy użyciu polecenia cmdlet Connect-AzAccount .
Konto Azure z aktywną subskrypcją.
Utwórz konto bezpłatnie.
Azure Cloud Shell lub Azure CLI.
Kroki opisane w tym artykule umożliwiają interaktywne uruchamianie poleceń interfejsu wiersza polecenia platformy Azure w usłudze Azure Cloud Shell. Aby uruchomić polecenia w usłudze Cloud Shell, wybierz pozycję Otwórz usługę Cloud Shell w prawym górnym rogu bloku kodu. Wybierz pozycję Kopiuj , aby skopiować kod i wklej go w usłudze Cloud Shell, aby go uruchomić. Możesz również uruchomić usługę Cloud Shell z poziomu witryny Azure Portal.
Możesz również zainstalować interfejs wiersza polecenia platformy Azure lokalnie , aby uruchomić polecenia. Ten artykuł wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.67.0 lub nowszej i rozszerzenia front-door . Uruchom polecenie az --version, aby znaleźć zainstalowaną wersję. Jeśli uruchamiasz Azure CLI lokalnie, zaloguj się do Azure używając polecenia az login.
Aby dostosować kod stanu odpowiedzi i treść, wykonaj następujące kroki:
Przejdź do zasad zapory aplikacji internetowej Front Door w Azure Portal.
W obszarze Ustawienia wybierz pozycję Ustawienia zasad.
Wprowadź niestandardowy kod stanu odpowiedzi i treść odpowiedzi w polach blok kodu stanu odpowiedzi i blok treści odpowiedzi.
Uwaga / Notatka
Zadania JavaScript i funkcje CAPTCHA są dostępne tylko w zasadach WAF w warstwie Premium usługi Azure Front Door.
Wybierz Zapisz.
Aby dostosować kod stanu odpowiedzi i treść, użyj polecenia cmdlet Update-AzFrontDoorWafPolicy .
# Update WAF policy settings to customize response body and status code
Update-AzFrontDoorWafPolicy `
-Name 'myWAFPolicy' `
-ResourceGroupName 'myResourceGroup' `
-RequestBodyCheck 'Enabled' `
-RedirectUrl 'https://learn.microsoft.com/en-us/azure/web-application-firewall/' `
-CustomBlockResponseStatusCode '403' `
-CustomBlockResponseBody '<html><head><title>WAF Demo</title></head><body><p><h1><strong>WAF Custom Response Page</strong></h1></p><p>Please contact us with this information:<br>{{azure-ref}}</p></body></html>'
Aby dostosować kod stanu odpowiedzi i treść odpowiedzi, użyj komendy az network front-door waf-policy update.
# Update WAF policy settings to customize response body and status code
az network front-door waf-policy update \
--name 'myWAFPolicy' \
--resource-group 'myResourceGroup' \
--request-body-check 'Enabled' \
--redirect-url 'https://learn.microsoft.com/en-us/azure/web-application-firewall/' \
--custom-block-response-status-code '403' \
--custom-block-response-body 'PGh0bWw+PGhlYWQ+PHRpdGxlPldBRiBEZW1vPC90aXRsZT48L2hlYWQ+PGJvZHk+PHA+PGgxPjxzdHJvbmc+V0FGIEN1c3RvbSBSZXNwb25zZSBQYWdlPC9zdHJvbmc+PC9oMT48L3A+PHA+UGxlYXNlIGNvbnRhY3QgdXMgd2l0aCB0aGlzIGluZm9ybWF0aW9uOjxicj57e2F6dXJlLXJlZn19PC9wPjwvYm9keT48L2h0bWw+'
Uwaga / Notatka
Wartość parametru --custom-block-response-body musi być ciągiem zakodowanym w formacie base64 .
W poprzednim przykładzie kod odpowiedzi był przechowywany jako 403 z niestandardowym komunikatem: "Skontaktuj się z nami, aby uzyskać następujące informacje:".
Uwaga / Notatka
{{azure-ref}} Wstawia unikatowy ciąg odwołania w treści odpowiedzi. Wartość jest zgodna z polem TrackingReference w dziennikach FrontDoorAccessLog i FrontDoorWebApplicationFirewallLog .
Ważne
Jeśli treść odpowiedzi bloku pozostanie pusta, zapora aplikacji internetowej zwróci odpowiedź 403 Zabronione dla normalnych bloków zapory aplikacji internetowej i 429 Zbyt wiele żądań dla bloków limitu szybkości.
Następny krok
