Citrix ADC

Configurar acción de respuesta

Después de habilitar la función de respuesta, debe configurar una o más acciones para gestionar las solicitudes. El Responder admite los siguientes tipos de acciones:

  • Responda con. Envía la respuesta definida por la expresión Target sin reenviar la solicitud a un servidor web. (El dispositivo Citrix ADC sustituye a un servidor web y actúa como servidor web.) Utilice este tipo de acción para definir manualmente una respuesta simple basada en HTML. Normalmente, el texto de una respuesta con acción consiste en un código de error del servidor web y una breve página HTML.

  • Responda con SQL Aceptar. Envía la respuesta SQL Aceptar designada definida por la expresión Target. Utilice este tipo de acción para enviar una respuesta SQL Aceptar a una consulta SQL.

  • Responder con 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 cargaron 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.

  • Redirigir. Redirige la solicitud a una página web o servidor web diferente. Una acción de redirección puede redirigir solicitudes enviadas originalmente a un sitio web “ficticio” que existe en DNS, pero para el cual no hay un servidor web real, a un sitio web real. También puede redirigir las solicitudes de búsqueda a una URL apropiada. Normalmente, el destino de redirección para una acción de redirección consiste en una dirección 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 una 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 respondedor. Longitud máxima: 127

  • type. Tipo de acción de respondedor. Puede ser: (respondwith).

  • target. Una expresión que especifica qué responder con

  • htmlpage. Opción que especifica responder con página html

  • bypassSafetyCheck. La comprobación de seguridad para permitir expresiones inseguras. Nota: Este atributo está obsoleto.

  • hits. El número de veces que se ha realizado la acción.

  • referenceCount. El número de referencias a la acción.

  • undefHits. El número de veces que la acción dio lugar al FNUD.

  • comment. Cualquier tipo de información acerca de esta acción de respuesta.

  • builtin. Indicador 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

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

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

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 conContent-type:text/html encabezadosContent-Length:<value> estáticos.

Nota:

En la configuración de encabezado personalizada, también puede sobrescribir el valor de 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:

name. Nombre de la acción de respondedor. Debe comenzar con una letra, un número o un carácter de subrayado (_) y debe contener solo letras, números y el guión (-), punto (.) hash (#), espacio (), at (@), igual (=), dos puntos (:) y caracteres de subrayado. Se puede cambiar después de agregar la directiva de respuesta.

Type. Tipo de acción de respondedor. Los ajustes disponibles funcionan de la siguiente manera:

  1. respondwith <target>: Responda a la solicitud con la expresión especificada como destino.
  2. respondwithhtmlpage: Responde a la solicitud con el objeto de página HTML cargado especificado como destino.
  3. redirect: Redirigir la solicitud a la URL especificada como el destino.
  4. sqlresponse_ok: Enviar una respuesta SQL Aceptar.
  5. sqlresponse_error: Enviar una respuesta SQL ERROR. Este es un argumento obligatorio. Valores posibles: Noop, respondwith, redirect, respondwithhtmlpage, sqlresponse_ok, sqlresponse_error

Target. Expresión que especifica con qué responder. Normalmente, una dirección URL para directivas de redirección o una expresión de sintaxis predeterminada. Además de las expresiones de sintaxis predeterminada Citrix ADC que hacen referencia a la información de la solicitud, una expresión stringbuilder puede contener texto y HTML, así como códigos de escape simples que definen nuevas líneas y párrafos. Incluya cada elemento de expresión stringbuilder (una expresión de sintaxis predeterminada de Citrix ADC o una cadena) entre comillas dobles. Utilice el carácter más (+) para unir los elementos.

htmlpage. Para las directivas respondwithhtmlpage, nombre del objeto de página HTML que se va a utilizar como respuesta. Primero debe importar el objeto de página. Longitud máxima: 31

Comment. Cualquier tipo de información acerca de 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 de 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 GUI:

  1. Vaya a AppExpert > Respondedor > Acciones.
  2. 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.
  3. Haga clic en Crear o Aceptar, en función de si está creando una acción o modificando una acción existente.
  4. Haga clic en Cerrar. Aparece un mensaje en la barra de estado que indica que la función se ha habilitado.
  5. 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

  1. En el cuadro de diálogo Crear acción de respondedor o Configurar acción de respondedor, haga clic en Agregar.

  2. En el cuadro de diálogo Agregar expresión, en el primer cuadro de lista, elija el primer término para la expresión.
    • HTTP. El protocolo HTTP. Elija esto si quiere examinar algún aspecto de la solicitud que pertenece al protocolo HTTP.
    • SYS. Uno o más 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 esto si quiere examinar algún aspecto del remitente de la solicitud.
    • ANÁLISIS. Los datos de análisis asociados con la solicitud. Elija esta opción si quiere examinar los metadatos de solicitud.
    • SORBO. Una solicitud SIP. Elija esta opción si quiere examinar algún aspecto de una solicitud SIP. Cuando elija, el cuadro de lista situado más a la derecha muestra los términos apropiados para la siguiente parte de la expresión.
  3. En el segundo cuadro de lista, elija el segundo término para su expresión. Las opciones dependen de la elección que haya realizado en el paso anterior y son apropiadas para el contexto. Después de realizar su segunda elección, la ventana Ayuda situada debajo de la ventana Construir expresión (que estaba en blanco) muestra ayuda que describe el propósito y el uso del término que acaba de elegir.
  4. 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 invocar 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, configure la acción de tiempo de espera HTTP global para que responda 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

Para<responder action name>, sustituya el nombre de la acción de respuesta.

Configurar la 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 import responder htmlpage comando y, a continuación, utilizar este archivo en el add responder action <act name> respondwithhtmlpage <file name> comando. También puede importar el archivo a través de la GUI de Citrix ADC. Puede importar una 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 CLI “import ssl certfile” o equivalente a través de API o GUI. Si el nombre del certificado no está configurado, se utilizan certificados de CA raíz predeterminados para la verificación del certificado.

Importar página HTML mediante la GUI de Citrix ADC

  1. Vaya a AppExpert > Respondedor >** **Importaciones de páginas HTML.
  2. En el panel de detalles Importaciones HTML del Respondedor, haga clic en Agregar.
  3. En la página HTML Page Import Object, establezca los siguientes parámetros:

    1. Nombre. Nombre de la página HTML.
    2. Importar desde. Importado desde archivo, texto o texto.
    3. URL. Seleccione esta opción para introducir la ubicación URL del archivo HTML.
    4. Archivo. Seleccione el archivo HTML en el directorio del dispositivo.
    5. Texto. Seleccione el archivo HTML como texto.
  4. Haga clic en Continuar.
  5. Verificar detalles de la página HTML del respondedor.
  6. Haga clic en Listo.

    Importación de páginas HTML

Para modificar una página HTML, puede seleccionar un archivo y hacer clic en Modificar archivo de página HTML del Respondedor en la lista desplegable Seleccionar acción.

Modificar archivo de página HTML del respondedor

Configurar acción de respuesta