Configurar acción de respuesta
Después de habilitar la función de respuesta, debe configurar una o varias acciones para gestionar las solicitudes. El respondedor admite los siguientes tipos de acciones:
-
Responda con. Envía la respuesta definida por la expresión de Target sin reenviar la solicitud a un servidor web. (El dispositivo Citrix ADC sustituye y actúa como servidor web). Utilice este tipo de acción para definir manualmente una respuesta sencilla basada en HTML. Normalmente, el texto de una acción Responder con consiste en un código de error del servidor web y una breve página HTML.
-
Responda con SQL OK. Envía la respuesta SQL OK designada definida por la expresión Target. Utilice este tipo de acción para enviar una respuesta SQL OK a una consulta SQL.
-
Responda con un error SQL. Envía la respuesta de error SQL designada definida por la expresión Target. Utilice este tipo de acción para enviar una respuesta de error SQL a una consulta SQL.
-
Responda con la página HTML. Envía la página HTML designada como respuesta. Puede elegir entre una lista desplegable de páginas HTML que se han cargado anteriormente o cargar una nueva página HTML. Utilice este tipo de acción para enviar una página HTML importada como respuesta. El dispositivo responde con un encabezado personalizado en la acción responsewithhtmlpage responder. Puede configurar hasta ocho encabezados personalizados. La página HTML importada se almacena en el directorio
/var/download/responder. -
Redireccionamiento. Redirige la solicitud a una página web o servidor web diferente. Una acción de redireccionamiento puede redirigir las solicitudes enviadas originalmente a un sitio web “ficticio” que existe en DNS, pero para el que no existe un servidor web real, a un sitio web real. También puede redirigir las solicitudes de búsqueda a una URL adecuada. Normalmente, el destino de redirección de una acción de redireccionamiento consiste en una URL completa.
Para configurar una acción de respuesta mediante la línea de comandos de Citrix ADC:
Muestra la configuración actual de la acción de respuesta especificada. Si no se proporciona ningún nombre de acción, muestre una lista de todas las acciones de respuesta configuradas actualmente en el dispositivo Citrix ADC, con la configuración abreviada.
En el símbolo del sistema, escriba los siguientes comandos para configurar una acción de respuesta y verificar la configuración:
add responder action <name> <type> <target> [-bypassSafetyCheck (YES | NO) ]show responder action
Parámetros:
-
Name. Nombre de la acción de respuesta. Longitud máxima: 127
-
type. Tipo de acción de respuesta. Puede ser: (respondwith).
-
target. Expresión que especifica con qué responder
-
htmlpage. Opción que especifica responder con html page
-
bypassSafetyCheck. El control de seguridad para permitir expresiones inseguras. Nota: Este atributo está en desuso.
-
hits. Número de veces que se ha realizado la acción.
-
referenceCount. Número de referencias a la acción.
-
undefHits. El número de veces que la acción dio lugar al UNDEF.
-
comment. Cualquier tipo de información sobre esta acción de respuesta.
-
builtin. Marcar para determinar si la acción de respuesta está integrada o no
Ejemplo:
To create a responder action that displays a “Not Found” error page for URLs that do not exist:
> add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
To create a responder action that displays a “Not Found” error page for URLs that do not exist:
add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
<!--NeedCopy-->
Para modificar una acción de respuesta existente mediante la línea de comandos de Citrix ADC:
En el símbolo del sistema, escriba el siguiente comando para modificar una acción de respuesta existente y verificar la configuración:
set responder action <name> -target <string> [-bypassSafetyCheck ( YES | NO )]show responder action
Ejemplo:
set responder action act404Error -target '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
<!--NeedCopy-->
Para quitar una acción de respuesta mediante la línea de comandos de Citrix ADC:
En el símbolo del sistema, escriba el siguiente comando para quitar una acción de respuesta y verificar la configuración:
rm responder action <name>show responder action
Ejemplo:
rm responder action act404Error
Done
> show responder action
Done
<!--NeedCopy-->
Para agregar encabezados personalizados en la acción responsewithhtmlpage responder mediante la línea de comandos de Citrix ADC:
Un dispositivo Citrix ADC ahora puede responder con encabezados personalizados en la acción responsewithhtmlpage responder. Puede configurar hasta ocho encabezados personalizados. Anteriormente, el dispositivo solo respondía con encabezados estáticos Content-type:text/html y Content-Length:<value>.
Nota:
En la configuración de encabezados personalizados, también puede sobrescribir el valor del encabezado “Content-Type”.
En el símbolo del sistema, escriba el siguiente comando:
add responder action <name> <type> (<target> | <htmlpage>) [-comment <string>] [-responseStatusCode <positive_integer>] [-reasonPhrase <expression>] [-headers <name(value)> ...]
Donde:
nombre. Nombre de la acción de respuesta. Debe comenzar con una letra, un número o un carácter de guión bajo (_) y debe contener solo letras, números y guión (-), punto (.), guión (.), espacio(), at (@), igual a (=), dos puntos (:) y guión bajo. Se puede cambiar después de agregar la directiva de respuesta.
Tipo. Tipo de acción de respuesta. Los ajustes disponibles funcionan de la siguiente manera:
- respondwith
<target>: Responde a la solicitud con la expresión especificada como destino. - respondwithhtmlpage: Responde a la solicitud con el objeto de página HTML cargado especificado como destino.
- redirect: Redirige la solicitud a la URL especificada como destino.
- sqlresponse_ok: Envía una respuesta SQL OK.
- sqlresponse_error: Envía una respuesta SQL ERROR. Se trata de un argumento obligatorio. Valores posibles: noop, respondwith, redirect, respondwithhtmlpage, sqlresponse_ok, sqlresponse_error
Objetivo. Expresión que especifica con qué responder. Normalmente es una URL para directivas de redireccionamiento o una expresión de sintaxis predeterminada. Además de las expresiones de sintaxis predeterminada de Citrix ADC que hacen referencia a la información de la solicitud, una expresión de generador de cadenas puede contener texto y HTML, y códigos de escape simples que definen líneas y párrafos nuevos. Coloque cada elemento de expresión de stringbuilder (ya sea una expresión de sintaxis predeterminada de Citrix ADC o una cadena) entre comillas dobles. Usa el signo más (+) para unir los elementos.
htmlpage. En el caso de las directivas respondwithhtmlpage, nombre del objeto de página HTML que se va a utilizar como respuesta. En primer lugar, debe importar el objeto de página. Longitud máxima: 31
Comment. Cualquier tipo de información sobre esta acción de respuesta. Longitud máxima: 255
responseStatusCode. Código de estado de respuesta HTTP, por ejemplo 200, 302, 404, etc. El valor predeterminado para el tipo de acción de redirección es 302 y para respondwithhtmlpage es 200 Valor mínimo: 100 Valor máximo: 599
reasonPhrase. Expresión que especifica la frase del motivo de la respuesta HTTP. La frase del motivo puede ser un literal de cadena con comillas o una expresión PI. Por ejemplo: “URL no válida:” + HTTP.REQ.URL Longitud máxima: 8191
Headers. Uno o más encabezados para insertar en la respuesta HTTP. Cada encabezado se especifica como “name (expr)”, donde expr es una expresión que se evalúa en tiempo de ejecución para proporcionar el valor del encabezado con nombre. Puede configurar un máximo de ocho encabezados para una acción de respuesta.
Para configurar una acción de respuesta mediante la interfaz gráfica de usuario:
- Vaya a AppExpert > Responder > Acciones.
- En el panel de detalles, realice una de las acciones siguientes:
- Para crear una acción, haga clic en Agregar.
- Para modificar una acción existente, selecciónela y, a continuación, haga clic en Abrir.
- Haga clic en Crear o en Aceptar, en función de si va a crear una acción o modificar una acción existente.
- Haga clic en Cerrar. Aparece un mensaje en la barra de estado que indica que la función se ha habilitado.
- Para eliminar una acción de respuesta, selecciónela y, a continuación, haga clic en Quitar. Aparece un mensaje en la barra de estado que indica que la función se ha inhabilitado.
Para agregar una expresión mediante el cuadro de diálogo Agregar expresión
-
En el cuadro de diálogo Crear acción de respuesta o Configurar acción de respuesta, haga clic en Agregar.
- En el cuadro de diálogo Agregar expresión, en el primer cuadro de lista, elija el primer término de la expresión.
- HTTP. El protocolo HTTP. Elija esta opción si quiere examinar algún aspecto de la solicitud que pertenece al protocolo HTTP.
- SYS. Uno o varios sitios web protegidos. Elija esta opción si quiere examinar algún aspecto de la solicitud que pertenece al destinatario de la solicitud.
- CLIENT. El equipo que envió la solicitud. Elija esta opción si quiere examinar algún aspecto del remitente de la solicitud.
- ANALYTICS. Los datos analíticos asociados a la solicitud. Elija esta opción si quiere examinar los metadatos de la solicitud.
- SIP. Solicitud SIP. Elija esta opción si quiere examinar algún aspecto de una solicitud SIP. Al elegir, el cuadro de lista situado más a la derecha muestra los términos apropiados para la siguiente parte de la expresión.
- En el segundo cuadro de lista, elige el segundo término para su expresión. Las elecciones dependen de la elección que haya realizado en el paso anterior y son apropiadas para el contexto. Después de hacer la segunda elección, la ventana de Ayuda situada debajo de la ventana Construir expresión (que estaba en blanco) muestra ayuda para describir el propósito y el uso del término que acaba de elegir.
- Siga eligiendo términos en los cuadros de lista que aparecen a la derecha del cuadro de lista anterior o escribiendo cadenas o números en los cuadros de texto que aparecen para pedirle que escriba un valor hasta que finalice la expresión.
Configuración de la acción HTTP global
Puede configurar la acción HTTP global para que invoque una acción de respuesta cuando se agote el tiempo de espera de una solicitud HTTP. Para configurar esta función, primero debe crear la acción de respuesta que quiere invocar. A continuación, configura la acción de tiempo de espera HTTP global para responder a un tiempo de espera con esa acción de respuesta.
Para configurar la acción HTTP global mediante la línea de comandos de Citrix ADC:
En el símbolo del sistema, escriba el siguiente comando:
set ns httpProfile -reqTimeoutAction <responder action name>save ns config
Por <responder action name>, sustituya el nombre de la acción de respuesta.
Configurar importación de páginas HTML
Cuando un dispositivo Citrix ADC responde con un mensaje personalizado, podemos responder con un archivo HTML. Puede importar el archivo mediante el comando import responder htmlpage y, a continuación, utilizar este archivo en el comando add responder action <act name> respondwithhtmlpage <file name>. También puede importar el archivo a través de la GUI de Citrix ADC. Puede importar la página HTML deseada en la carpeta del dispositivo y cargarla durante el tiempo de ejecución del respondedor.
Importar página HTML mediante la CLI
En el símbolo del sistema, escriba:
import responder htmlpage [<src>] <name> [-comment <string>] [-overwrite][-CAcertFile <string>]
Ejemplo:
import responder htmlpage http://www.example.com/page.html my-responder-page -CAcertFile my_root_ca_cert
Donde: certificado de CA se utiliza para verificar el certificado de cliente. El certificado debe importarse mediante el comando de CLI “import ssl certfile” o su equivalente a través de API o GUI. Si el nombre del certificado no está configurado, se utilizan los certificados de CA raíz predeterminados para la verificación del certificado.
Importar página HTML mediante la GUI de Citrix ADC
- Vaya a AppExpert > Responder > Importación de páginas HTML.
- En el panel de detalles de Responder HTML Imports, haga clic en Agregar.
-
En la página Objeto de importación de página HTML, defina los siguientes parámetros:
- Nombre. Nombre de la página HTML.
- Importar desde. Importado de un archivo, texto o texto.
- URL. Seleccione esta opción para introducir la ubicación URL del archivo HTML.
- archivo. Seleccione el archivo HTML del directorio del dispositivo.
- Texto. Seleccione el archivo HTML como texto.
- Haga clic en Continuar.
- Compruebe los detalles de la página HTML del respondedor
-
Haga clic en Listo.
Para modificar una página HTML, puede seleccionar un archivo y hacer clic en Modificar archivo de página HTML de Responder en la lista desplegable Seleccionar acción .
