Creare pagine di errore personalizzate del gateway applicazione
Il gateway applicazione consente di creare pagine di errore personalizzate da visualizzare al posto delle pagine di errore predefinite. Con una pagina di errore personalizzata è possibile usare il layout e il marchio aziendali.
È possibile, ad esempio, definire la propria pagina di manutenzione se l'applicazione Web non è raggiungibile. In alternativa, è possibile creare una pagina di accesso non autorizzato se viene inviata una richiesta dannosa a un'applicazione Web.
Le pagine di errore personalizzate sono supportate per i due scenari seguenti:
- Pagina Manutenzione: questa pagina di errore personalizzata viene inviata al posto di una pagina 502 - Gateway non valido. Viene visualizzata quando il gateway applicazione non dispone di back-end a cui indirizzare il traffico. Quando, ad esempio, è pianificata la manutenzione oppure quando un problema imprevisto influisce sull'accesso al pool back-end.
- Pagina Accesso non autorizzato: questa pagina di errore personalizzata viene inviata al posto di una pagina 403 - Accesso non autorizzato. Viene visualizzata quando il WAF del gateway applicazione rileva traffico dannoso e lo blocca.
Se un errore proviene dalle destinazioni back-end del pool back-end, l'errore viene passato di nuovo al chiamante non modificato. Le pagine di errore personalizzate verranno visualizzate solo quando una richiesta non riesce a raggiungere il back-end o quando WAF è in modalità di prevenzione e blocca la richiesta.
Le pagine di errore personalizzate possono essere definite a livello globale e a livello di listener:
- Livello globale: la pagina di errore è applicabile al traffico di tutte le applicazioni Web distribuite nel gateway applicazione specifico.
- Livello di listener: la pagina di errore è applicabile al traffico ricevuto nel listener specifico.
- Entrambi i livelli: la pagina di errore personalizzata definita a livello di listener sostituisce quella impostata a livello globale.
Per creare una pagina di errore personalizzata è necessario disporre di:
- un codice di stato risposta HTTP;
- posizione corrispondente per la pagina di errore.
- la pagina degli errori deve essere accessibile a Internet e restituire 200 risposte.
- la pagina degli errori deve essere in *.htm o *.html tipo di estensione.
- le dimensioni della pagina di errore devono essere inferiori a 1 MB.
- la pagina degli errori deve essere ospitata nell'archiviazione BLOB di Azure
È possibile fare riferimento a immagini/CSS interni o esterni per questo file HTML. Per le risorse a cui si fa riferimento esternamente, usare gli URL assoluti accessibili pubblicamente. Tenere presente le dimensioni del file HTML quando si usano immagini inline con codifica base64, javascript o CSS.
Nota
I collegamenti relativi ai file nella stessa posizione non sono supportati.
Dopo aver specificato una pagina di errore, il gateway applicazione verifica la connettività Internet al file e salva il file nella cache del gateway applicazione locale. La pagina HTML verrà gestita dal gateway applicazione, mentre le risorse a cui si fa riferimento esternamente (ad esempio immagini, javascript, file css) vengono recuperate direttamente dal client. Per modificare una pagina di errore personalizzata esistente, è necessario puntare a un percorso BLOB diverso nella configurazione del gateway applicazione. Il gateway applicazione non controlla periodicamente il percorso DEL BLOB per recuperare nuove versioni.
Configurazione del portale
Passare a Gateway applicazione nel portale e scegliere un gateway applicazione.
Selezionare Listener e passare a un listener specifico in cui si vuole specificare una pagina di errore.
Configurare una pagina di errore personalizzata per un errore WAF 403 o una pagina di manutenzione 502 a livello di listener.
Nota
La creazione di pagine di errore personalizzate a livello globale dal portale di Azure non è attualmente supportata.
In Url della pagina Errore selezionare Sì e quindi configurare un URL BLOB accessibile pubblicamente per un determinato codice di stato di errore. Selezionare Salva. Il gateway applicazione è ora configurato con la pagina di errore personalizzata.
Configurazione di Azure PowerShell
È anche possibile usare Azure PowerShell per configurare una pagina di errore personalizzata. Una pagina di errore personalizzata globale di esempio:
$appgw = Get-AzApplicationGateway -Name <app-gateway-name> -ResourceGroupName <resource-group-name>
$updatedgateway = Add-AzApplicationGatewayCustomError -ApplicationGateway $appgw -StatusCode HttpStatus502 -CustomErrorPageUrl "http://<website-url>"
O una pagina di errore a livello di listener:
$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>"
Per altre informazioni, vedere Add-AzApplicationGatewayCustomError e Add-AzApplicationGatewayHttpListenerCustomError.
Passaggi successivi
Per informazioni sulla diagnostica gateway applicazione, vedere Integrità back-end, log di diagnostica e metriche per gateway applicazione.