Dela via

Skapa anpassade felsidor för Application Gateway

  • Artikel

Med Application Gateway kan du skapa anpassade felsidor i stället för att visa standardsidor. Du kan använda din varumärkesanpassning och layout för fel som rör olika svarskoder. Vissa scenarier för att ställa in anpassade felsidor är

  • Visar en sida för underhåll eller status för svarskoden 502 Felaktig gateway. Detta är användbart när din programgateway inte har någon serverdelsserver att dirigera trafik till under schemalagt underhåll eller ett oförutseddt problem med serverdelspoolservrar.
  • Visar en anpassad sida för obehörig åtkomst för 403 Förbjuden svarskod som inträffar när WAF är i förebyggande läge och blockerar skadlig trafik.
  • Visar en företagsanpassad sida med kontaktuppgifter i händelse av ett problem.

Svarskoder som stöds

De anpassade felsidorna stöds för följande svarskoder:

Svarskod beskrivning
400 Felaktig begäran (i förhandsversion)
403 Ej tillåtet
405 Metoden är inte tillåten (förhandsversion)
408 Tidsgräns för begäran (förhandsversion)
500 Internt serverfel (förhandsversion)
502 Felaktig gateway
503 Tjänsten är inte tillgänglig (förhandsversion)
504 Gateway-timeout (i förhandsversion)

Kommentar

  • API-version 2022-09-01 eller senare bör användas för att konfigurera felsidor för de nya svarskoderna (i förhandsversion).
  • Svarskoden 404 (sidan hittades inte) stöds för närvarande inte.
  • De anpassade felsidorna visas för svarskoder som genereras av Application Gateway. Om ett fel kommer från serverdelsservern skickas det oförändrade till klienten.

Konfigurationsnivåer

De anpassade felsidorna kan definieras på global nivå eller lyssnarnivå:

  • Global nivå – De felsidor som angetts på global nivå tillämpas på alla lyssnare av den programgatewayen. Dess konfiguration via Azure-portalen stöds för närvarande inte.
  • Lyssnarnivå – Felsidorna på lyssnarnivå ger dig detaljerad kontroll för att ange felsidor för program som hanteras av lyssnaren.

Kommentar

När du använder en kombination av felsidor på global nivå och lyssnarnivå för en gateway måste du uttryckligen nämna URL:erna för alla önskade svarskoder för lyssnaren. En lyssnarspecifik konfiguration åsidosätter alla tidigare globala konfigurationer som gäller för lyssnaren.

Behov

Om du vill skapa en anpassad felsida bör du

  • känna till svarskoden som en anpassad felsida behövs för.
  • känner till motsvarande fjärrplats (URL) för HTML-sidan. Detta måste vara en offentligt tillgänglig fil.
  • se till att felsidan är offentligt tillgänglig och returnera ett svar på 200.
  • se till att felsidan ska vara i *.htm- eller *.html-tilläggstyp.
  • se till att sidstorleken är mindre än 1 MB.

Du kan referera till interna eller externa bilder/CSS för den här HTML-filen. För externt refererade resurser använder du absoluta URL:er som är offentligt tillgängliga. Tänk på HTML-filstorleken när du använder base64-kodade infogade bilder, JavaScript eller CSS.

Kommentar

  • I Azure-ekosystemet måste du använda ett Azure Blob Storage-konto eller en virtuell dator som värd för en felsida. Observera att Blob Storage bör vara direkt åtkomligt eftersom lagringskonton som frontas av Azure CDN-tjänster för närvarande inte stöds.
  • Du kan också välja att vara värd för felsidorna på valfri fjärrplats.
  • Relativa länkar stöds inte.

Hur fungerar det?

När du har angett en felsida i programgatewayens konfiguration verifierar gatewayen anslutningen till HTML-sidan via Internet. Den laddar sedan ned filen i sin lokala cache.

När en klient får ett fel returnerar programgatewayen en svarskod och html-sidan. Alla externt refererade resurser (till exempel avbildningar, JavaScript- och CSS-filer) hämtas direkt av klienten.

Programgatewayen kontrollerar inte regelbundet källfilens plats för att hämta en ny version. Du kan utföra alla konfigurationsuppdateringar på gatewayen för att manuellt uppdatera filens cacheminne. Du kan till exempel ändra fel-URL:en från sida 1 till sida 2 och sedan tillbaka till sidan 1, eller när du lägger till en ny lyssnare.

Portalkonfiguration

Steg för att konfigurera lyssnarspecifika anpassade felsidor:

  1. Gå till Application Gateway i portalen och välj den resurs som krävs.

  2. Välj Lyssnare och navigera till en viss lyssnare som du vill ange en felsida för.

  3. Under avsnittet Anpassade felsidor anger du offentligt tillgängliga URL:er för de statuskoder som krävs.

  4. Välj Spara.

    Screenshot of Application Gateway custom error page.

Azure PowerShell-konfiguration

Du kan använda Azure PowerShell för att konfigurera en anpassad felsida. Till exempel en global anpassad felsida:

$appgw   = Get-AzApplicationGateway -Name <app-gateway-name> -ResourceGroupName <resource-group-name>

$updatedgateway = Add-AzApplicationGatewayCustomError -ApplicationGateway $appgw -StatusCode HttpStatus502 -CustomErrorPageUrl "http://<website-url>"

Set-AzApplicationGateway -ApplicationGateway $appgw

Eller en felsida på lyssnarnivå:

$appgw   = Get-AzApplicationGateway -Name <app-gateway-name> -ResourceGroupName <resource-group-name>

$listener01 = Get-AzApplicationGatewayHttpListener -Name <listener-name> -ApplicationGateway $appgw

$updatedlistener = Add-AzApplicationGatewayHttpListenerCustomError -HttpListener $listener01 -StatusCode HttpStatus502 -CustomErrorPageUrl "http://<website-url>"

Set-AzApplicationGateway -ApplicationGateway $appgw

Mer information finns i Add-AzApplicationGatewayCustomError och Add-AzApplicationGatewayHttpListenerCustomError.

Nästa steg

Information om Application Gateway-diagnostik finns i Serverdelshälsa, diagnostikloggar och mått för Application Gateway.