ADC

Importaciones

Varias funciones de Web App Firewall utilizan archivos externos que se cargan al Web App Firewall al configurarlo. Mediante la GUI, puede administrar esos archivos en el panel Importaciones, que tiene cuatro fichas correspondientes a los cuatro tipos de archivos que puede importar: Objetos de error HTML, objetos de error XML, esquemas XML y archivos WSDL (Lenguaje de descripción de servicios web). Con la línea de comandos de Citrix ADC, puede importar estos tipos de archivos, pero no puede exportarlos.

Objeto de error HTML

Cuando se bloquea la conexión de un usuario a una página HTML o Web 2.0, o un usuario solicita una página HTML o Web 2.0 inexistente, Web App Firewall envía una respuesta de error basada en HTML al explorador del usuario. Al configurar qué respuesta de error debe usar el Web App Firewall, tiene dos opciones:

  • Puede configurar una dirección URL de redirección, que se puede alojar en cualquier servidor web al que los usuarios también tengan acceso. Por ejemplo, si tiene una página de error personalizada en el servidor web, 404.html, puede configurar Web App Firewall para redirigir a los usuarios a esa página cuando se bloquea una conexión.
  • Puede configurar un objeto de error HTML, que es una página web basada en HTML alojada en el propio Web App Firewall. Si elige esta opción, debe cargar el objeto de error HTML en el Web App Firewall. Esto se hace en el panel Importaciones, en la ficha Objeto de error HTML.

El objeto de error debe ser un archivo HTML estándar que no contenga sintaxis que no sea HTML, excepto para las variables de personalización del objeto de error de Web App Firewall. No puede contener ningún script CGI, código analizado por el servidor o código PHP. Las variables de personalización permiten incrustar información de solución de problemas en el objeto de error que recibe el usuario cuando se bloquea una solicitud. Aunque la mayoría de las solicitudes que bloquean Web App Firewall son ilegítimas, incluso un Web App Firewall configurado correctamente puede bloquear ocasionalmente solicitudes legítimas, especialmente cuando se implementan por primera vez o después de realizar cambios significativos en los sitios web protegidos. Al incrustar información en la página de error, usted proporciona al usuario la información que él o ella necesita dar a la persona de soporte técnico para que pueda solucionarse cualquier problema.

Las variables de personalización de la página de error de Web App Firewall son:

  • $ {NS_TRANSACTION_ID}. El identificador de transacción que el Web App Firewall asignó a esta transacción.
  • $ {NS_APPFW_SESSION_ID}. El ID de sesión de Web App Firewall.
  • $ {NS_APPFW_VIOLATION_CATEGORY}. La comprobación de seguridad o regla específica de Web App Firewall que se ha infringido.
  • $ {NS_APPFW_VIOLATION_LOG}. El mensaje de error detallado asociado con la infracción.

  • ${COOKIE El contenido de la cookie especificada. Para <CookieName>, sustituya el nombre de la cookie específica que quiere mostrar en la página de error. Si tiene varias cookies cuyo contenido quiere mostrar para la solución de problemas, puede utilizar varias instancias de esta variable de personalización, cada una con el nombre de la cookie correspondiente. Nota: Si tiene activado el bloqueo para la comprobación de coherencia de cookies, las cookies bloqueadas no se muestran en la página de error porque el Web App Firewall las bloquea.

Para utilizar estas variables, se incrustan en el HTML o XML del objeto de página de error como si fueran una cadena de texto normal. Cuando el objeto de error se muestra al usuario, para cada variable de personalización, el Web App Firewall sustituye la información a la que se refiere la variable. A continuación se muestra una página de error HTML de ejemplo que utiliza variables personalizadas.

<!doctype html public "-//w3c//dtd html 4.0//en">  <html>  <head>  <title>Page Not Accessible</title>  </head>  <body>  <h1>Page Not Accessible</h1>  <p>The page that you accessed is not available. You can:</p>  <ul>  <li>return to the <b><a href="[homePage]">home page</a></b>, re-establish your session, and try again, or,</li>  <li>report this incident to the help desk via <b><a href="mailto:[helpDeskEmailAddress]">email</a></b> or by calling [helpDeskPhoneNumber].</li>  </ul>  <p>If you contact the help desk, please provide the following information:</p>  <table cellpadding=8 width=80%>  <tr><th align="right" width=30%>Transaction ID:</th><td align="left" valign="top" width=70%>${NS_TRANSACTION_ID}</td></tr>  <tr><th align="right" width=30%>Session ID:</th><td align="left" valign="top" width=70%>${NS_APPFW_SESSION_ID}</td></tr>  <tr><th align="right" width=30%>Violation Category:</th><td align="left" valign="top" width=70%>${NS_APPFW_VIOLATION_CATEGORY}</td></tr>  <tr><th align="right" width=30%>Violation Log:</th><td align="left" valign="top" width=70%>${NS_APPFW_VIOLATION_LOG}</td></tr>  <tr><th align="right" width=30%>Cookie Name:</th><td align="left" valign="top" width=70%>${COOKIE("[cookieName]")}</td></tr>  </table>  <body>  <html>
<!--NeedCopy-->

Para utilizar esta página de error, cópiela en un editor de texto o HTML. Sustituya la información local apropiada por las siguientes variables, que están entre corchetes para distinguirlas de las variables Citrix ADC. (Déjelos sin cambios. ):

  • [homePage]. La URL de la página de inicio de su sitio web.
  • [helpDeskEmailAddress]. La dirección de correo electrónico que quiere que los usuarios utilicen para informar de incidentes de bloqueo.
  • [helpDeskPhoneNumber]. El número de teléfono al que quiere que los usuarios llamen para informar de incidentes de bloqueo.
  • [cookieName]. El nombre de la cookie cuyo contenido quiere mostrar en la página de error.

Objeto de error XML

Cuando se bloquea la conexión de un usuario a una página XML o un usuario solicita una aplicación XML inexistente, Web App Firewall envía una respuesta de error basada en XML al explorador del usuario. Para configurar la respuesta de error, cargue una página de error basada en XML en el Web App Firewall en el panel Importaciones, en la ficha Objeto de error XML. Todas las respuestas de error XML se hospedan en Web App Firewall. No se puede configurar una dirección URL de redirección para aplicaciones XML.

Nota: Puede utilizar las mismas variables de personalización en un objeto de error XML que en un objeto de error HTML.

Esquema XML

Cuando Web App Firewall realiza una comprobación de validación en la solicitud de un usuario para una aplicación XML o Web 2.0, puede validar la solicitud con el esquema XML o documento de tipo de diseño (DTD) de esa aplicación y rechazar cualquier solicitud que no siga el esquema o DTD. Tanto un esquema XML como un DTD son archivos de configuración XML estándar que describen la estructura de un tipo específico de documento XML.

WSDL

Cuando el Web App Firewall realiza una comprobación de validación en la solicitud de un usuario para un servicio web basado en XML SOAP, puede validar la solicitud en el archivo de definición de tipo de servicios web (WSDL) para ese servicio web. Un archivo WSDL es un archivo de configuración XML SOAP estándar que define los elementos de un servicio web XML SOAP específico.

Importaciones