Présentation de la règle de page d'erreurs personnalisée

La règle de page d'erreurs personnalisée est une fonction qui permet au serveur proxy d'utiliser une application pour générer une réponse de type erreur HTTP. Cette fonction permet à l'administrateur de renvoyer une page d'erreur lorsque le serveur proxy génère une erreur ou que le serveur de contenu renvoie une réponse qui n'aboutit pas.

La procédure suivante présente des scénarios expliquant comment utiliser la règle de pages d'erreurs, lorsque celle-ci est configurée :
  • Erreur interne
    1. Le client envoie la demande suivante au serveur proxy : GET /house/rooms/kitchen.jpg HTTP/1.1.
    2. Le serveur proxy génère une erreur interne car aucun serveur n'est mappée à la demande (HTTP 404 – Fichier introuvable).
    3. La règle de l'erreur est configurée pour traiter les réponses HTTP 404. Elle envoie donc une demande à l'application de la page d'erreurs pour extraire le contenu de l'erreur et l'envoyer au client. L'URI de la demande et le code de la réponse HTTP sont inclus sous forme de paramètre de requête dans l'application de la page d'erreurs. Si l'URI de l'application de la page d'erreurs est /ErrorPageApp/ErrorPage, l'URI de la demande adressée à l'application de la page d'erreurs est /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg. Les paramètres de la requête “responseCode” et “uri” sont envoyés à l'application de la page d'erreur par défaut.
    4. Le serveur proxy renvoie le code de réponse et le contenu renvoyé par l'application de page d'erreurs. Il est également possible de configurer l'application de page d'erreurs pour qu'elle renvoie le code de réponse qui est transmis dans le paramètre de requête responseCode.
  • Erreur éloignée
    1. Le client envoie la demande suivante au serveur proxy : GET /house/rooms/kitchen.jpg HTTP/1.1
    2. Le serveur proxy achemine la demande vers le serveur de contenu homeserver.companyx.com.
    3. Le serveur de contenu homeserver.companyx.com ne parvient pas à localiser le fichier /house/rooms/kitchen.jpg et envoie une réponse HTTP 404 (Fichier introuvable) au serveur proxy.
    4. La règle de l'erreur est configurée pour traiter les réponses HTTP 404. Elle envoie donc une demande à l'application de la page d'erreurs pour extraire le contenu de l'erreur et l'envoyer au client. L'URI de la demande et le code de la réponse HTTP sont inclus sous forme de paramètre de requête dans l'application de la page d'erreurs. Si l'URI de l'application de la page d'erreurs est /ErrorPageApp/ErrorPage, l'URI de la demande adressée à l'application de la page d'erreurs est /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg. Les paramètres de la requête “responseCode” et “uri” sont envoyés à l'application de la page d'erreur par défaut.
    5. Le serveur proxy renvoie le code de réponse et le contenu renvoyé par l'application de page d'erreurs. Il est également possible de configurer l'application de page d'erreurs pour qu'elle renvoie le code de réponse qui est transmis dans le paramètre de requête responseCode.
Un exemple d'application de la page d'erreurs est disponible dans le fichier <RACINE_INSTALL_WAS>/installableApps/HttpErrorHandler.ear.
Eviter les incidents Eviter les incidents: Lorsque vous configurez le routeur On Demand pour utiliser une application de traitement d'erreurs personnalisée, entrez la balise suivante dans la section <Head> de la page html :
<Base href="http://<Serveur>/<RacineContexteAppPageErreur>/" />
Pour <Serveur>, utilisez une valeur propre à votre topologie. Dans la plupart des cas, <Serveur> est le routeur On Demand. Vous pouvez obtenir ces informations depuis l'API du servlet.

Pour <RacineContexteAppPageErreur>, entrez la racine de contexte pour votre application de traitement d'erreurs.

Cette configuration permet d'éviter des problèmes d'affichage des informations sur l'erreur.

gotcha

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cjpx_ceppolicy
Nom du fichier : cjpx_ceppolicy.html