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 NetScaler 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。Envia la respuesta de错误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.
Configure una acción de respuesta mediante la CLI:
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 NetScaler, 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
show responder action
Parámetros:
Nombre。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 una página html.
hits。Número de veces que se ha realizado la acción.
referenceCount。Número de referencias a la acción.
undefHits。El号德有时乘缆车accion戴奥卢格联合国DEF.
comment。Cualquier tipo de información sobre esta acción de respuesta.
builtin。Marca para determinar si la acción del respondedor está integrada o no.
Ejemplo:
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." Hits: 0 Undef Hits: 0 Action Reference Count: 0 Done 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." Hits: 0 Undef Hits: 0 Action Reference Count: 0 Done
Modifique una acción de respuesta existente mediante la CLI:
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
-target 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." Hits: 0 Undef Hits: 0 Action Reference Count: 0 Done
Elimine una acción de respuesta mediante la CLI:
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
show responder action
Ejemplo:
rm responder action act404Error Done > show responder action Done
Agregue encabezados personalizados en la acción responsewithhtmlpage responder mediante la CLI:
联合国dispositivo NetScaler ahora喝水响应者欺诈encabezados personalizados en la acción responsewithhtmlpage responder. Puede configurar hasta ocho encabezados personalizados. Anteriormente, el dispositivo solo respondía con encabezados estáticosContent-type:text/html
yContent-Length:
。
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
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
: Responde a la solicitud con la expresión especificada como objetivo. - respondwithhtmlpage: responde a la solicitud con el objeto de página HTML cargado especificado como destino.
- redireccionar: redirige la solicitud a la URL especificada como destino.
- sqlresponse_ok: envía una respuesta de SQL OK。
- sqlresponse_error - Envía una respuesta de error deSQL. Se trata de un argumento obligatorio. Valores posibles:
noop
respondwith
,redirect
,respondwithhtmlpage
,sqlresponse_ok
,sqlresponse_error
Target: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 NetScaler que hacen referencia a la información de la solicitud, una expresión del generador de cadenas puede contener texto y HTML y códigos de escape simples que definen nuevas líneas y párrafos. Escriba cada elemento de expresión del generador de cadenas (ya sea una expresión de sintaxis predeterminada de NetScaler o una cadena) entre comillas dobles. Usa el signo más (+) para unir los elementos.
htmlpage:En el caso de las directivasrespondwithhtmlpage
,数量▽objeto de pagina HTML, se utilizará como respuesta. En primer lugar, debe importar el objeto de página. Longitud máxima: 31
Comentario: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 del tiporedirect action
es 302, y pararespondwithhtmlpage
, 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:"Invalid URL: " + HTTP.REQ.URL Maximum Length: 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 nombrado. Puede configurar un máximo de ocho encabezados para una acción de respuesta.
Configure una acción de respuesta mediante la interfaz gráfica de usuario:
- Vaya aAppExpert > Responder > Acciones。
- En el panel de detalles, realice una de las acciones siguientes:
- Para crear una acción, haga clic enAgregar。
- Para modificar una acción existente, selecciónela y, a continuación, haga clic enAbrir。
- Haga clic enCrearo enAceptar, en función de si va a crear una acción o modificar una acción existente.
- Haga clic enCerrar。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 enQuitar。Aparece un mensaje en la barra de estado que indica que la función se ha inhabilitado.
Agregue una expresión mediante el cuadro de diálogoAgregar expresión。
En el cuadro de diálogoCrear acción de respuestaoConfigurar acción de respuesta, haga clic enAgregar。
- En el cuadro de diálogoAgregar 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, configure la acción de tiempo de espera de HTTP global para responder a un tiempo de espera con esa acción de respuesta.
Configure la acción HTTP global mediante la CLI:
En el símbolo del sistema, escriba el siguiente comando:
set ns httpProfile -reqTimeoutAction
save ns config
Por
, reemplace el nombre de la acción de respuesta.
Configurar la importación de una página HTML
Cuando un dispositivo NetScaler responde con un mensaje personalizado, podemos responder con un archivo HTML. Puede importar el archivo mediante el comandoimport responder htmlpage
y, a continuación, utilizar este archivo en el comandoadd responder action
。También puede importar el archivo a través de la GUI de NetScaler. Puede importar la página HTML deseada en la carpeta del dispositivo y cargarla durante el tiempo de ejecución del respondedor.
Importar una página HTML mediante la CLI
En la línea de comandos, escriba:
import responder htmlpage [
Ejemplo:
进口响应者htmlpage http://www.example.com/page.html my-responder-page -CAcertFile my_root_ca_cert
Donde se usa un certificado de CA para verificar el certificado del cliente. El certificado debe importarse mediante el comandoimport ssl certfile
de la CLI o equivalente a través de una API o GUI. Si el nombre de un certificado no está configurado, se utilizan los certificados de CA raíz predeterminados para la verificación del certificado.
Importar una página HTML desde el sistema de archivos local
También puede importar una página HTML del sistema de archivos local. Para importarlo, copie el archivo mediante SCP o cualquier otra forma al directorio /var/tmp/ y, a continuación, impórtelo con la palabra clave «local:». Por ejemplo:
import responder htmlpage local:my_local_file.html my_local_file
Dondemy_local_file.html
está presente en el directorio «/var/tmp/».
Tenga en cuenta
que la palabra clave «local:» solo busca el archivo en el directorio «/var/tmp/». Para las particiones no predeterminadas, debe copiar el archivo en el directorio tmp específico de la partición que se encuentra en.
/var/partitions/
/tmp
Importar una página HTML mediante la interfaz gráfica
- Vaya aAppExpert>Responder>Importación de páginas HTML。
- En el panel de detalles deResponder HTML Imports, haga clic enAgregar。
En lapá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 enContinuar。
- Compruebe los detalles de la página HTML del respondedor
Haga clic enListo。
Para modificar una página HTML, puede seleccionar un archivo y hacer clic enModificar archivo de página HTML de Responderen la lista desplegableSeleccionar acción。