Vytvořit vlastní chybové stránky brány aplikaceCreate Application Gateway custom error pages

Služba Application Gateway vám umožní vytvořit vlastní chybové stránky místo zobrazení výchozích chybových stránek.Application Gateway allows you to create custom error pages instead of displaying default error pages. U vlastní chybové stránky můžete použít vlastní značky a rozložení.You can use your own branding and layout using a custom error page.

Můžete například definovat vlastní stránku údržby, pokud vaše webová aplikace není dostupná.For example, you can define your own maintenance page if your web application isn't reachable. Nebo můžete vytvořit stránku neoprávněného přístupu, pokud je do webové aplikace odeslán škodlivý požadavek.Or, you can create an unauthorized access page if a malicious request is sent to a web application.

Vlastní chybové stránky jsou podporovány v následujících dvou scénářích:Custom error pages are supported for the following two scenarios:

  • Stránka údržby – tato vlastní chybová stránka je odeslána namísto stránky chybné brány 502.Maintenance page - This custom error page is sent instead of a 502 bad gateway page. Je zobrazena, když aplikační brána nemá žádný back-end pro směrování provozu.It's shown when Application Gateway has no backend to route traffic to. Například když je naplánovaná údržba nebo když nepředvídaný problém ovlivňuje přístup k back-endového fondu.For example, when there's scheduled maintenance or when an unforeseen issue effects backend pool access.
  • Neoprávněný přístupová stránka – Tato vlastní chybová stránka je odeslána namísto stránky 403 neoprávněných přístupů.Unauthorized access page - This custom error page is sent instead of a 403 unauthorized access page. Zobrazuje se, když WAF aplikační brány detekuje škodlivý provoz a blokuje jej.It's shown when the Application Gateway WAF detects malicious traffic and blocks it.

Pokud chyba pochází z back-endových serverů, pak je předána spolu nezměněné zpět volajícímu.If an error originates from the backend servers, then it's passed along unmodified back to the caller. Vlastní chybová stránka se nezobrazí.A custom error page isn't displayed. Aplikační brána může zobrazit vlastní chybovou stránku, když požadavek nemůže dosáhnout back-endu.Application gateway can display a custom error page when a request can't reach the backend.

Vlastní chybové stránky lze definovat na globální úrovni a na úrovni posluchače:Custom error pages can be defined at the global level and the listener level:

  • Globální úroveň – chybová stránka se vztahuje na provoz pro všechny webové aplikace nasazené v této aplikační bráně.Global level - the error page applies to traffic for all the web applications deployed on that application gateway.
  • Úroveň naslouchací procesu - chybová stránka je použita pro přenosy přijaté na tomto naslouchací proces.Listener level - the error page is applied to traffic received on that listener.
  • Oba - vlastní chybová stránka definovaná na úrovni posluchače přepíše jednu sadu na globální úrovni.Both - the custom error page defined at the listener level overrides the one set at global level.

Chcete-li vytvořit vlastní chybovou stránku, musíte mít:To create a custom error page, you must have:

  • stavový kód odpovědi HTTP.an HTTP response status code.
  • umístění chybové stránky.the corresponding location for the error page.
  • veřejně přístupný objekt blob úložiště Azure pro umístění.a publicly accessible Azure storage blob for the location.
  • typu rozšíření *.htm nebo *.html.an *.htm or *.html extension type.

Velikost chybové stránky musí být menší než 1 MB.The size of the error page must be less than 1 MB. Pokud jsou na chybové stránce propojeny obrázky, musí se jednat o veřejně přístupné absolutní adresy URL nebo vložená zakódovaná bitová kopie base64 na vlastní stránce chyby.If there are images linked in the error page, they must be either publicly accessible absolute URLs or base64 encoded image inline in the custom error page. Relativní odkazy s obrázky ve stejném umístění objektu blob nejsou aktuálně podporovány.Relative links with images in the same blob location are currently not supported.

Po zadání chybové stránky ji aplikační brána stáhne z umístění objektu blob úložiště a uloží ji do mezipaměti místní brány aplikace.After you specify an error page, the application gateway downloads it from the storage blob location and saves it to the local application gateway cache. Pak se chybová stránka zobrazí přímo z aplikační brány.Then the error page is served directly from the application gateway. Chcete-li upravit existující vlastní chybovou stránku, musíte v konfiguraci aplikační brány přejděte na jiné umístění objektů blob.To modify an existing custom error page, you must point to a different blob location in the application gateway configuration. Aplikační brána pravidelně nekontroluje umístění objektů blob, aby načítala nové verze.The application gateway doesn't periodically check the blob location to fetch new versions.

Konfigurace portáluPortal configuration

  1. Přejděte na portálu do brány aplikace a zvolte aplikační bránu.Navigate to Application Gateway in the portal and choose an application gateway.

    ag-přehled

  2. Klikněte na Naslouchací procesy a přejděte na konkrétní naslouchací proces, kde chcete zadat chybovou stránku.Click Listeners and navigate to a particular listener where you want to specify an error page.

    Naslouchací procesy aplikační brány

  3. Nakonfigurujte vlastní chybovou stránku pro chybu 403 WAF nebo stránku údržby 502 na úrovni posluchače.Configure a custom error page for a 403 WAF error or a 502 maintenance page at the listener level.

    Poznámka

    Vytváření vlastních chybových stránek globální úrovně z portálu Azure momentálně není podporované.Creating global level custom error pages from the Azure portal is currently not supported.

  4. Zadejte veřejně přístupnou adresu URL objektu blob pro daný stavový kód chyby a klepněte na tlačítko Uložit.Specify a publicly accessible blob URL for a given error status code and click Save. Aplikační brána je nyní nakonfigurována s vlastní chybovou stránkou.The Application Gateway is now configured with the custom error page.

    Chybové kódy brány aplikace

Konfigurace Azure PowerShelluAzure PowerShell configuration

Azure PowerShell můžete použít ke konfiguraci vlastní chybové stránky.You can use Azure PowerShell to configure a custom error page. Například globální vlastní chybová stránka:For example, a global custom error page:

$updatedgateway = Add-AzApplicationGatewayCustomError -ApplicationGateway $appgw -StatusCode HttpStatus502 -CustomErrorPageUrl $customError502Url

Nebo chybová stránka na úrovni posluchače:Or a listener level error page:

$updatedlistener = Add-AzApplicationGatewayHttpListenerCustomError -HttpListener $listener01 -StatusCode HttpStatus502 -CustomErrorPageUrl $customError502Url

Další informace naleznete v tématech Add-AzApplicationGatewayCustomError a Add-AzApplicationGatewayHttpListenerCustomError.For more information, see Add-AzApplicationGatewayCustomError and Add-AzApplicationGatewayHttpListenerCustomError.

Další krokyNext steps

Informace o diagnostice brány aplikace naleznete v tématu Back-end health, diagnostic kázně a metriky pro aplikační bránu.For information about Application Gateway diagnostics, see Back-end health, diagnostic logs, and metrics for Application Gateway.