Citrix ADC

Mapas de cadenas

Puede utilizar asignaciones de cadenas para realizar la coincidencia de patrones en todas las funciones de Citrix ADC que utilicen la sintaxis de directivas predeterminada. Un mapa de cadenas es una entidad Citrix ADC que consiste en pares clave-valor. Las claves y valores son cadenas en formato ASCII o UTF-8. La comparación de cadenas utiliza dos nuevas funciones,MAP_STRING(<string_map_name>) yIS_STRINGMAP_KEY(<string_map_name>).

Una configuración de directivas que utiliza asignaciones de cadenas funciona mejor que una que hace la coincidencia de cadenas a través de expresiones de directiva, y necesita menos directivas para realizar la coincidencia de cadenas con un gran número de pares clave-valor. Los mapas de cadena también son intuitivos, fáciles de configurar y dan como resultado una configuración más pequeña.

Cómo funcionan los mapas de cadenas

Los mapas de cadenas son similares en estructura a los conjuntos de patrones (un conjunto de patrones define una asignación de valores de índice a cadenas; un mapa de cadenas define una asignación de cadenas a cadenas) y los comandos de configuración para mapas de cadenas (comandos como add, bind, unbind, remove y show) son sintácticamente similares a la configuración para conjuntos de patrones. Además, al igual que con los valores de índice en un conjunto de patrones, cada clave de un mapa de cadenas debe ser única en el mapa. La tabla siguiente ilustra un mapa de cadenas llamado url_string_map, que contiene direcciones URL como claves y valores.

Tecla Valor
/url_1.html http://www.redirect_url_1.com/url_1.html
/url_2.html http://www.redirect_url_2.com/url_2.html
/url_3.html http://www.redirect_url_1.com/url_1.html

Tabla 1. Mapa de cadenas “url_string_map”

En la tabla siguiente se describen las dos funciones que se han introducido para habilitar la coincidencia de cadenas con claves en un mapa de cadenas. La coincidencia de cadenas siempre se realiza con las teclas. Además, las siguientes funciones realizan una comparación entre las claves del mapa de cadenas y la cadena completa que devuelve el prefijo de expresión. Los ejemplos de las descripciones hacen referencia al ejemplo anterior.

Para obtener información completa sobre las dos funciones introducidas para habilitar la coincidencia de cadenas con claves en un mapa de cadenas, consulte la Función de mapa de cadenastabla pdf.

Configuración de un mapa de cadenas

Primero crea un mapa de cadenas y, a continuación, une pares clave-valor a él. Puede crear un mapa de cadenas desde la interfaz de línea de comandos (CLI) o la utilidad de configuración.

Para configurar un mapa de cadenas mediante la interfaz de línea de comandos

En el símbolo del sistema, haga lo siguiente:

  1. Crear un mapa de cadenas.

add policy stringmap <name> -comment <string>

  1. Enlazar un par clave-valor al mapa de cadenas.

bind policy stringmap <name> <key> <value> [-comment <string>]

Ejemplo:

bind policy stringmap url_string_map1 "/url_1.html" "http://www.redirect_url_1.com/url_1.html"

Para configurar un mapa de cadenas mediante la GUI de Citrix ADC

Vaya a AppExpert > String Maps, haga clic en Agregar y especifique los detalles pertinentes.

Ejemplo: Directiva de respuesta con una acción de redirección

El siguiente caso de uso implica una directiva de respuesta con una acción de redirección. En el ejemplo siguiente, los cuatro primeros comandos crean el string map url_string_map y vinculan los tres pares clave-valor utilizados en el ejemplo anterior. Después de crear el mapa y vincular los pares clave-valor, se crea una acción de respuesta (act_url_redirects) que redirige el cliente a la dirección URL correspondiente en el mapa de cadenas o a www.default.com. También se configura una directiva de respuesta (pol_url_redirects) que comprueba si las URL solicitadas coinciden con alguna de las claves de url_string_map y, a continuación, realiza la acción configurada. Por último, vincula la directiva de respuesta al servidor virtual de conmutación de contenido que recibe las solicitudes de cliente que se van a evaluar.

add stringmap url_string_map

bind stringmap url_string_map /url_1.html http://www.redirect_url_1.com/url_1.html

bind stringmap url_string_map /url_2.html http://www.redirect_url_2.com/url_2.html

bind stringmap url_string_map /url_3.html http://www.redirect_url_1.com/url_1.html

add responder action act_url_redirects redirect 'HTTP.REQ.URL.MAP_STRING("url_string_map") ALT "www.default.com"' -bypassSafetyCheck yes

add responder policy pol_url_redirects TRUE act_url_redirects

bind cs vserver csw_redirect -policyname pol_url_redirects -priority 1 -type request

Para configurar un mapa de cadenas mediante la GUI de Citrix ADC

Siga el procedimiento que se indica a continuación para configurar un mapa de cadenas.

  1. En el panel de navegación, expanda AppExpert y haga clic en Cadena de mapas.
  2. En el panel de detalles, haga clic en Agregar.
  3. En la página Crear mapa de cadenas, establezca los siguientes parámetros:
    • Nombre. Nombre del mapa de cadenas.
    • Configurar el valor de clave. Entrada de valor de clave basada en ASCII vinculada al mapa de cadenas
    • Comentarios. Una breve descripción de los valores clave enlazados al mapa de cadenas.
  4. Haga clic en Crear y cerrar.

    configuración de mapa de cadenas

Mapas de cadenas