IBM Tealeaf CX Versión 9 Release de diciembre de Manual del Inyector de cookies de Tealeaf

Transcripción

1 IBM Tealeaf CX Versión 9 Release de diciembre de 2014 Manual del Inyector de cookies de Tealeaf

2 Note Before using this information and the product it supports, read the information in Notices en la página 29. Esta edición se aplica a la ersión 9, release 0, modificación 1 de IBM Tealeaf CX y a todos los releases y modificaciones posteriores hasta que se indique lo contrario en nueas ediciones. Copyright IBM Corporation 1999, 2014.

3 Contenido Manual del Inyector de cookies de Tealeaf Capítulo 1. Instalación y configuración del Inyector de cookies de Tealeaf... 1 Visión general Plataformas soportadas Soporte SSL Mantenimiento y resolución de problemas Inhabilitar otros agentes de sesionización Adquisición de software Instrucciones para la instalación y configuración.. 3 Configuración del Inyector de cookies de Tealeaf para arios dominios Configuración de cxresults Verificación de la instalación Actualización del Inyector de cookies de Tealeaf.. 5 Actualización del seridor web Copia de seguridad Gestión de cambios de configuración Proceso de actualización Capítulo 2. Inyector de cookies de Tealeaf para Apache 1.3.x Requisitos del sistema Instalación del Inyector de cookies utilizando un script Instalación manual del Inyector de cookies Configuración Configuración para arios dominios Capítulo 3. Inyector de cookies de Tealeaf para Apache 2.x Requisitos del sistema Instalación del Inyector de cookies utilizando un script Instalación manual del Inyector de cookies Configuración Configuración para arios dominios Capítulo 4. Inyector de cookies de Tealeaf para Microsoft IIS Requisitos del sistema Niel de instalación Seridor Sitio Utilización del script de configuración Instalación manual Configuración Configuración para arios dominios Capítulo 5. Inyector de cookies de Tealeaf para Microsoft IIS 7.0 o posterior Instalación Niel de instalación Utilización del script de configuración Instalación manual Configuración Configuración para arios dominios Capítulo 6. Inyector de cookies de Tealeaf para SunOne-iPlanet 3.1 o posterior Requisitos del sistema Instalación del Inyector de cookies utilizando un script Instalación manual del Inyector de cookies Configuración Configuración para arios dominios Capítulo 7. IBM Tealeaf documentation and help Notices Trademarks Priacy Policy Considerations Copyright IBM Corp. 1999, 2014 iii

4 i IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

5 Manual del Inyector de cookies de Tealeaf El Manual del Inyector de cookies de Tealeaf proporciona instrucciones de instalación y configuración para el Inyector de cookies de Tealeaf, un generador de cookies ligero que se puede instalar en el entorno del seridor web. Cuando se despliega el Inyector de cookies, genera identificadores de sesión que se garantiza que son exclusios en Tealeaf. Nota: El Inyector de cookies es el método preferido para generar identificadores para Tealeaf. Tealeaf proporciona arios mecanismos para obtener identificadores de sesión. Consulte "Gestión de sesionización de datos en Tealeaf CX" en el Manual de instalación de IBM Tealeaf CX. Copyright IBM Corp. 1999, 2014

6 i IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

7 Capítulo 1. Instalación y configuración del Inyector de cookies de Tealeaf Visión general Este documento proporciona información sobre la instalación y configuración del Inyector de cookies de Tealeaf en cada plataforma soportada. Nota: El Inyector de cookies de Tealeaf es un componente opcional independiente de cualquier otro software de Tealeaf del que puede tener licencia. El uso del código del Inyector de cookies está sujeto a los términos siguientes: EL SOFTWARE DE INYECTOR DE COOKIES LO PROPORCIONA TEALEAF TECHNOLOGY, INC., UNA EMPRESA DE IBM ("TEALEAF") "TAL CUAL" Y SE RENUNCIA A CUALQUIER GARANTÍA EXPLÍCITA O IMPLÍCITA, INCLUIDAS PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS DE COMERCIALIZACIÓN, ADECUACIÓN A UN PROPÓSITO DETERMINADO Y DE NO VULNERABILIDAD. EN NINGÚN CASO TEALEAF O NINGUNA DE SUS ENTIDADES PRINCIPALES, SUBSIDIARIA O AFILIADAS ES RESPONSABLE DE NINGÚN DAÑO DIRECTO, INDIRECTO, ACCIDENTAL, ESPECIAL, EJEMPLAR O INDIRECTO (INCLUYENDO, PERO SIN LIMITARSE A, LA ADQUISICIÓN DE SERVICIOS O BIENES SUSTITUTIVOS; LA PÉRDIDA DE USO, DATOS O BENEFICIOS; O INTERRUPCIÓN DE NEGOCIO) SIN IMPORTAR LA CAUSA Y EN CUALQUIER TEORÍA DE RESPONSABILIDAD, YA SEA EN CONTRATO, RESPONSABILIDAD ESTRICTA O AGRAVIO (INCLUIDA LA NEGLIGENCIA U OTROS) QUE SE PRODUZCA DE ALGÚN MODO DEL USO DEL SOFTWARE DE INYECTOR DE COOKIES INCLUSO SI SE HA AVISADO DE LA POSIBILIDAD DE DICHO DAÑO. Nota: Las directrices de Priacy and Electronic Communications Regulations 2003 contienen directrices específicas respecto al uso y gestión de cookies para los clientes de la Unión Europea. Debe consultar a su asesor legal sobre el cumplimiento de estas directrices y otras regulaciones relacionadas con la priacidad aplicables. El Inyector de cookies de Tealeaf es un programa de utilidad específico de la plataforma ligero que se instala en el seridor web o el seridor de aplicaciones con la finalidad de emitir cookies HTTP que contienen identificadores exclusios globales (GUID). Estos GUID se utilizan para la secuenciación (o 'sesionización') de los datos capturados por IBM Tealeaf cximpact. El Inyector de cookies de Tealeaf Cookie se utiliza junto con Tealeaf Passie Capture en los casos en que no hay ninguna ariable de estado de cookie o aplicación que se pueda asignar como una clae fiable para la sesionización de los pares de solicitud y respuesta HTTP(S) en una sesión de isitante lógica. El Inyector de cookies de Tealeaf se instala en cada seridor web o seridor de aplicaciones, donde comprueba en cada solicitud entrante si existe la cookie o cookies configuradas. Si la solicitud no contiene la cookie o cookies para las que el Inyector de cookies se ha configurado para emitir, el Inyector añade una cabecera Set-Cookie (Establecer cookie) a la respuesta para cada cookie. Copyright IBM Corp. 1999,

8 Plataformas soportadas Opcionalmente, también puede inyectar cookies en las cabeceras de solicitud para que puedan erlas los componentes de la aplicación web que están en sentido descendente del seridor donde se ha instalado el Inyector. El Inyector de cookies también puede añadir una cabecera de respuesta que identifica el nombre del seridor para que esta información esté disponible en las coincidencias capturadas por un seridor de IBM Tealeaf CX Passie Capture Application. El Inyector de cookies de Tealeaf no reconfigura ni interfiere en los puertos que los seridores web están utilizando. El Inyector de cookies soporta las siguientes plataformas de seridor y sistemas operatios: Nota: Para ersiones y sistemas operatios no soportados, se puede proporcionar el código fuente si se solicita. Para obtener más información, póngase en contacto con Tealeaf Tabla 1. Plataformas soportadas Software de seridor Windows 2000, 2003, 2008 y posterior Linux (Intel), kernel 6.2 o posterior Solaris (SPARC) 6 o posterior IBM AIX 4.3 o posterior SunOne/iPlanet 3.1 o posterior Sí Sí Sí Sí Apache o posterior Apache o posterior MSFT IIS 5.0 o posterior Disponible si se solicita Sí Sí Sí Sí Sí Sí Sí Sí No disponible No disponible No disponible Soporte SSL Nota: los filtros de Apache o SunOne/iPlanet pueden estar disponibles para otras ariantes de UNIX si se solicitan. En los casos en que Tealeaf no puede proporcionar una ersión binaria, el código fuente puede estar disponible para que los clientes construyan sus propias. Nota: los inyectores de cookies para ersiones anteriores de Apache 1.3 están disponibles si se solicitan. El Inyector de cookies de Tealeaf aproecha la arquitectura natia del seridor web para ealuar e inyectar la serie de cookies configuradas de Tealeaf. El Inyector de cookies ejecuta este procedimiento después de que el seridor web ha descifrado o terminado la conexión SSL. Como resultado, el Inyector de cookies de Tealeaf no tiene ningún efecto en el proceso de terminación de SSL y no es necesaria ninguna consideración para certificados SSL. Mantenimiento y resolución de problemas El Inyector de problemas de Tealeaf debe mantenerse como una opción de configuración de producción del seridor web. 2 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

9 Si necesita resoler un problema en el seridor web, el Inyector de cookies de Tealeaf se puede inhabilitar y se pueden reanudar las operaciones del seridor web. Una ez inhabilitado el Inyector de cookies, las cookies de Tealeaf configuradas para que las establezca el Inyector de cookies ya no están presentes en la corriente de datos de solicitud y respuesta HTTP(S). El proceso de inhabilitación del Inyector de cookies aría según la plataforma. Inhabilitar otros agentes de sesionización Adquisición de software Para el funcionamiento correcto del Inyector de cookies de Tealeaf, deben inhabilitarse los otros agentes de sesionización de Tealeaf, ya que pueden alterar temporalmente los alores establecidos por el Inyector de cookies. 1. Mediante TMS, abra el editor de interconexiones. Consulte "Tealeaf Management System" ("Sistema de gestión de Tealeaf") en la publicación IBM Tealeaf cximpact Administration Manual. 2. Los siguientes agentes de sesión no deberían estar en la interconexión de proceso principal o cualquier interconexión hijo fuera de la interconexión de proceso principal: [Sessioning] [TLSessioning] 3. Mediante el PCA, debe inhabilitar la sesionización. En la pestaña Interconexión en la consola web de PCA, compruebe que Use Sessioning se haya establecido en false. Si debe cambiar el alor, seleccione Guardar cambios en la parte inferior de la página de la pestaña Interconexión. Consulte "Consola web de PCA - Pestaña Interconexión" en el Manual de la aplicación de captura pasia de IBM Tealeaf El software de Inyector de cookies de Tealeaf está disponible para instalar desde la distribución de Tealeaf en el siguiente directorio: TealeafCX\Sample Code\cxCookieFilters Instrucciones para la instalación y configuración Para su plataforma web, utilice el enlace siguiente de su plataforma de seridor web para obtener instrucciones sobre cómo instalar y configurar el Inyector de cookies de Tealeaf: Capítulo 6, Inyector de cookies de Tealeaf para SunOne-iPlanet 3.1 o posterior, en la página 23 Capítulo 2, Inyector de cookies de Tealeaf para Apache 1.3.x, en la página 7 Capítulo 3, Inyector de cookies de Tealeaf para Apache 2.x, en la página 11 Capítulo 4, Inyector de cookies de Tealeaf para Microsoft IIS 6.0, en la página 15 Capítulo 5, Inyector de cookies de Tealeaf para Microsoft IIS 7.0 o posterior, en la página 19 Configuración del Inyector de cookies de Tealeaf para arios dominios Puede configurar el Inyector de cookies de Tealeaf para emitir identificadores de sesión para arios dominios proporcionados por el mismo seridor web de Apache. Capítulo 1. Instalación y configuración del Inyector de cookies de Tealeaf 3

10 Nota: El Inyector de cookies de Tealeaf debe instalarse globalmente. La limitación del módulo a hosts irtuales específicos no es una solución soportada. En el archio de configuración de teacookies.conf, compruebe que las siguientes propiedades estén establecidas en los alores listados: TLCookieIssueSID=On TLCookieDomain no está establecido TLAddHostCookieDomain=True Nota: tenga en cuenta que el parámetro TLCookieDomain está comentado. Cuando TLAddHostCookieDomain=True, se emiten cookies de identificador diferentes para los dos dominios de segundo niel, debido a sus nombres de dominio diferentes. Configuración de cxresults Si IBM Tealeaf cxresults se ha instalado y configurado antes de la instalar y utilizar el Inyector de cookies de Tealeaf, debe actualizarse IBM Tealeaf cxresults para reflejar el nueo identificador de usuario proporcionado por el Inyector de cookies. Verificación de la instalación Consulte "Initial cxresults Configuration" ("Configuración inicial de cxresults") en la publicación IBM Tealeaf cxresults Administration Manual Para erificar la instalación correcta del Inyector de cookies de Tealeaf, realice los siguientes pasos para crear una sesión de Tealeaf con el cookie de Tealeaf insertado en la solicitud y para er la sesión a traés de IBM Tealeaf CX RealiTea Viewer o la Reproducción basada en naegador en el portal de Tealeaf. 1. Utilizando el naegador web, isite la aplicación web superisada por Tealeaf. Aance unas cuantas páginas para crear una sesión rastreable. 2. A traés del portal de Tealeaf o de IBM Tealeaf CX RealiTea Viewer, busque sesiones de Tealeaf que se hayan producido desde que ha instalado el Inyector de cookies. Nota: El cookie de Tealeaf lo instala el Inyector de cookies para cada isitante y lo guarda la sesión. En función de los alores de tiempo de espera de sesión, es posible que deba buscar las sesiones actias y las sesiones completadas. Para obtener más información sobre la búsqueda en RTV, consulte "RealiTea Viewer - Búsqueda de sesiones" en el Manual del usuario de IBM Tealeaf RealiTea Viewer. Para obtener más información sobre la búsqueda en el portal de Tealeaf, consulte "Búsqueda de datos de sesión" en el Manual del usuario de IBM Tealeaf cximpact. 3. Reproduzca una sesión encontrada. Para obtener más información sobre la reproducción en RTV, consulte "RealiTea Viewer - Ventana principal" en el Manual del usuario de IBM Tealeaf RealiTea Viewer. Para obtener más información sobre la reproducción en el portal de Tealeaf, consulte "CX Browser Based Replay" en el Manual del usuario de IBM Tealeaf cximpact. 4 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

11 4. Examine la ista de solicitud de la primera página de la sesión. a. En la sección [en], seleccione HTTP_SET_COOKIE. El alor para TLTSID debería estar definido. b. En la sección [iamie], el alor para TLTSID debería ser igual que el alor en la sección [en]. 5. Busque en la última página de la sesión. Compruebe que el alor para TLTSID es igual en ambas secciones de la ista de solicitud. Actualización del Inyector de cookies de Tealeaf Actualización del seridor web Si está actualizando el seridor web, puede que necesite desinstalar el Inyector de cookies y olerlo a instalar. Por ejemplo, si está actualizando de Apache 1.3 a Apache 2.0, se requiere una ersión diferente del Inyector de cookies. Compruebe cuál es la ersión adecuada en la documentación del Inyector de cookies para gestionar la actualización. Nota: para conserar los alores de configuración, puede que desee migrar los alores de la ersión antigua a la ersión nuea. Consulte Gestión de cambios de configuración. Copia de seguridad Antes de iniciar la actualización, realice una copia de seguridad del directorio del Inyector de cookies de Tealeaf en el seridor web. Gestión de cambios de configuración Los archios de configuración para el Inyector de cookies no cambian a menudo. Sin embargo, antes de una actualización, debería aplicar los cambios de configuración de los archios antiguos a una copia de los archios de configuración nueos. Es posible que le resulte más fácil utilizar diff en los archios y aplicar los alores nueos o cambiados del archio nueo en el antiguo. Guarde el archio de configuración nueo modificado fuera del directorio del Inyector de cookies. Proceso de actualización 1. Compruebe que la actualización se ha completado. 2. Copie los archios.dll o.so nueos en el directorio de Inyector de cookies de Tealeaf en el seridor web. 3. Copie los archios de configuración modificados en el directorio de Inyector de cookies de Tealeaf. 4. Reinicie el seridor web. 5. Compruebe que el Inyector de cookies funciona correctamente. Consulte Verificación de la instalación en la página 4. Capítulo 1. Instalación y configuración del Inyector de cookies de Tealeaf 5

12 6 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

13 Capítulo 2. Inyector de cookies de Tealeaf para Apache 1.3.x Requisitos del sistema Antes de empezar, asegúrese de que tiene el software de Inyector de cookies de Tealeaf adecuado. Consulte Adquisición de software en la página 3. Consulte Capítulo 1, Instalación y configuración del Inyector de cookies de Tealeaf, en la página 1. No hay requisitos del sistema adicionales aparte de los archios del Inyector de cookies de Tealeaf. De la siguiente lista de archios del Inyector de cookies de Tealeaf, mod_teacookies1-3.so y teacookies.conf son archios necesarios que deben desplegarse en el seridor web en el directorio adecuado: mod_teacookies1-3.so: archio del Inyector de cookies de Tealeaf para Apache 1.3.x teacookies.conf: archio de configuración para el Inyector de cookies de Tealeaf para Apache 1.3.x Instalación del Inyector de cookies utilizando un script Esta sección describe cómo instalar el inyector de cookies utilizando un script. Utilice el script de configuración configurado incluido para instalar el Inyector de cookies. Este script actualiza automáticamente los archios de configuración adecuados para Apache 1.3.x y copia los archios del Inyector de cookies en la ubicación correcta. 1. Ejecute el script de configuración, pasando la ía de acceso completa a HTTPd como un argumento. Por ejemplo,./setup /usr/local/apache/bin/httpd. 2. Configure el Inyector de cookies editando teacookies.conf. Consulte Configuración en la página Ejecute httpd -t para probar la configuración y compruebe que no se isualizan errores. 4. Reinicie Apache para cargar el Inyector de cookies. Instalación manual del Inyector de cookies Esta sección describe cómo instalar manualmente el Inyector de cookies. 1. Copie mod_teacookies1-3.so y teacookies.conf desde el disco de distribución a un directorio de una unidad de almacenamiento local en el seridor web. 2. Añada la siguiente línea al final del archio de configuración httpd.conf de Apache y sustituya <path-to-teacookies> por la ía de acceso real donde se encuentra teacookies.conf. Por ejemplo: Include <path-to-teacookies> 3. Configure el Inyector de cookies editando teacookies.conf. Consulte Configuración en la página Ejecute httpd -t para probar la configuración y compruebe que no se isualizan errores. 5. Reinicie Apache para cargar el Inyector de cookies. Copyright IBM Corp. 1999,

14 Configuración Esta sección contiene información de configuración para el Inyector de cookies y Apache ersión 1.3.x Tabla 2. Valores de configuración para teacookies.conf. Opción LoadModule teacookies_module modules/ mod_teacookies1-3.so TLCookieEnabled On TLCookieIssueSID On TLCookieIssueHID Off TLCookieIssueUID On TLCookieInjectSID Off TLCookieInjectHID Off TLCookieInjectUID Off TLCookieDomain.mydomain.com Descripción Esta línea carga mod_teacookies1-3.so. En el mandato, sustituya los módulos con la ía de acceso real por mod_teacookies1-3.so. Esta opción determina si el filtro de cookies está actio o no. El establecimiento de esta opción en Off inhabilita el filtro de cookies la próxima ez que se reinicia Apache. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTSID (cookie de ID de sesión) si esta cookie no está presente en la solicitud. El alor predeterminado para esta opción es On. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTHID (cookie de ID de coincidencia). Esta cabecera se añade a cada respuesta si TLCookieIssueHID=On. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTUID (cookie de ID de usuario) si esta cookie no está presente en la solicitud. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTSID (cookie de ID de sesión) en la cabecera de solicitud de cookie si esta cookie no está presente en la solicitud. La cabecera de cookie se añade cuando no existe ninguna. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTHID (cookie de ID de coincidencia) en la cabecera de solicitud de cookie (la cabecera de cookie se añade si no existe ninguna). El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTUID (cookie de ID de usuario) en la cabecera de solicitud de cookie si esta cookie no está presente en la solicitud (la cabecera de cookie se añade si no existe ninguna). El alor predeterminado para esta opción es Off. Esta opción establece el dominio añadido a las cookies emitidas. El alor empieza con un punto y contiene al menos dos partes, lo cual funcionaría para cualquier subdominio del dominio especificado. Por ejemplo, y www2.mydomain.com. Si no se especifica, el dominio se analiza desde la cabecera de host en la solicitud. 8 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

15 Tabla 2. Valores de configuración para teacookies.conf. (continuación) Opción TLCookieAddHostCookieDomain On TLCookieExtendedCookieDomain Off TLCookieSecureCookie Off TLCookieIssueHostName Off TLCookieHostName=<nombre_máquina> Descripción Si se establece en True, el dominio que se utiliza para las cookies emitidas se analiza desde la cabecera de host en la solicitud. Esta opción es útil para sitios que tienen más de un dominio de niel superior (por ejemplo, y Esta opción se ignora si se especifica un alor para TLCookieDomain. El alor predeterminado para esta opción es On. Si se establece en True (cuando AddHostCookieDomain=True), el dominio para cabeceras Set-Cookies se establece en las dos últimas partes del nombre de host (de la cabecera de host) si la última parte es.com,.mil,.go,.edu,.org,.net o.int, o en las tres últimas partes del host si no es así. Cuando se establece en False (alor predeterminado), el dominio para Set-Cookies se establece en el nombre de dominio completo de la cabecera de host, empezando desde el primer punto. Esta opción especifica cuándo se añade el atributo Secure a las cabeceras Set-Cookie al establecer cookies. El establecimiento de esta opción en True puede hacer que el naegador deuela las cookies de Tealeaf sólo para solicitudes HTTPS. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se añade una cabecera de nombre de host a la respuesta que identifica el seridor web. El alor predeterminado para esta opción es Off. TLCookieHostName especifica el nombre del seridor web que debe deolerse en la cabecera de respuesta de nombre de host (si TLCookieIssueHostName=On). Si el alor de HostName se establece en el alor predeterminado, se utiliza el nombre del sistema. El alor predeterminado para esta opción es default. Configuración para arios dominios Si está configurando el Inyector de cookies de Tealeaf para emitir identificadores para arios dominios, se requiere una configuración adicional. Consulte Capítulo 1, Instalación y configuración del Inyector de cookies de Tealeaf, en la página 1. Capítulo 2. Inyector de cookies de Tealeaf para Apache 1.3.x 9

16 10 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

17 Capítulo 3. Inyector de cookies de Tealeaf para Apache 2.x Requisitos del sistema Antes de empezar, asegúrese de que tiene el software de Inyector de cookies de Tealeaf adecuado. Consulte Adquisición de software en la página 3. Consulte Capítulo 1, Instalación y configuración del Inyector de cookies de Tealeaf, en la página 1. No hay requisitos del sistema adicionales aparte de los archios del Inyector de cookies de Tealeaf. De la siguiente lista de archios del Inyector de cookies de Tealeaf, mod_teacookies.so y teacookies.conf son archios necesarios que deben desplegarse en el seridor web en el directorio adecuado: mod_teacookies.so: archio del Inyector de cookies de Tealeaf para Apache 2.x teacookies.conf: archio de configuración para el Inyector de cookies de Tealeaf para Apache 2.x Instalación del Inyector de cookies utilizando un script Esta sección describe cómo instalar el inyector de cookies utilizando un script. Utilice el script de configuración configurado incluido para instalar el Inyector de cookies. Este script actualiza automáticamente los archios de configuración adecuados para Apache 2.x y copia los archios del Inyector de cookies en la ubicación correcta. 1. Ejecute el script de configuración, pasando la ía de acceso completa a HTTPd como un argumento. Por ejemplo,./setup /usr/local/apache/bin/httpd. 2. Configure el Inyector de cookies editando teacookies.conf. Consulte Configuración en la página Ejecute httpd -t para probar la configuración y compruebe que no se isualizan errores. 4. Reinicie Apache para cargar el Inyector de cookies. Instalación manual del Inyector de cookies Esta sección describe cómo instalar manualmente el Inyector de cookies. 1. Copie mod_teacookies.so y teacookies.conf desde el disco de distribución a un directorio de una unidad de almacenamiento local en el seridor web. 2. Añada la siguiente línea al final del archio de configuración de Apache y sustituya <path-to-teacookies> por la ía de acceso actual donde se encuentra teacookies.conf. Por ejemplo: Include path-to-teacookies/teacookies.conf 3. Configure el filtro de cookies editando teacookies.conf. Consulte Configuración en la página Ejecute httpd -t para probar la configuración y compruebe que no se isualizan errores. 5. Reinicie Apache para cargar el Inyector de cookies. Copyright IBM Corp. 1999,

18 Configuración Esta sección contiene información de configuración para el Inyector de cookies y Apache ersión 2.x Tabla 3. Valores de configuración para teacookies.conf. Opción LoadModule teacookies_module modules/ mod_teacookies.so TLCookieEnabled On TLCookieIssueSID On TLCookieIssueHID Off TLCookieIssueUID On TLCookieInjectSID Off TLCookieInjectHID Off TLCookieInjectUID Off TLCookieDomain.mydomain.com Descripción Esta línea carga mod_teacookies.so. En el mandato, sustituya los módulos con la ía de acceso real por mod_teacookies.so. Esta opción determina si el filtro de cookies está actio o no. El establecimiento de esta opción en Off inhabilita el filtro de cookies la próxima ez que se reinicia Apache. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTSID (cookie de ID de sesión) si esta cookie no está presente en la solicitud. El alor predeterminado para esta opción es On. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTHID (cookie de ID de coincidencia). Esta cabecera se añade a cada respuesta si TLCookieIssueHID=On. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se añade una cabecera Set-Cookie a la respuesta para TLTUID (cookie de ID de usuario) si esta cookie no está presente en la solicitud. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTSID (cookie de ID de sesión) en la cabecera de solicitud de cookie si esta cookie no está presente en la solicitud. La cabecera de cookie se añade cuando no existe ninguna. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTHID (cookie de ID de coincidencia) en la cabecera de solicitud de cookie (la cabecera de cookie se añade si no existe ninguna). El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se inserta una nuea TLTUID (cookie de ID de usuario) en la cabecera de solicitud de cookie si esta cookie no está presente en la solicitud (la cabecera de cookie se añade si no existe ninguna). El alor predeterminado para esta opción es Off. Esta opción establece el dominio añadido a las cookies emitidas. El alor empieza con un punto y contiene al menos dos partes, lo cual funcionaría para cualquier subdominio del dominio especificado. Por ejemplo, y www2.mydomain.com. Si no se especifica, el dominio se analiza desde la cabecera de host en la solicitud. 12 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf

19 Tabla 3. Valores de configuración para teacookies.conf. (continuación) Opción TLCookieAddHostCookieDomain On TLCookieExtendedCookieDomain Off TLCookieSecureCookie Off TLCookieIssueHostName Off TLCookieHostName=<nombre_máquina> Descripción Si se establece en True, el dominio que se utiliza para las cookies emitidas se analiza desde la cabecera de host en la solicitud. Esta opción es útil para sitios que tienen más de un dominio de niel superior (por ejemplo, y Esta opción se ignora si se especifica un alor para TLCookieDomain. El alor predeterminado para esta opción es On. Si se establece en True (cuando AddHostCookieDomain=True), el dominio para cabeceras Set-Cookies se establece en las dos últimas partes del nombre de host (de la cabecera de host) si la última parte es.com,.mil,.go,.edu,.org,.net o.int, o en las tres últimas partes del host si no es así. Cuando se establece en False (alor predeterminado), el dominio para Set-Cookies se establece en el nombre de dominio completo de la cabecera de host, empezando desde el primer punto. Esta opción especifica cuándo se añade el atributo Secure a las cabeceras Set-Cookie al establecer cookies. El establecimiento de esta opción en True puede hacer que el naegador deuela las cookies de Tealeaf sólo para solicitudes HTTPS. El alor predeterminado para esta opción es Off. Esta opción especifica cuándo se añade una cabecera de nombre de host a la respuesta que identifica el seridor web. El alor predeterminado para esta opción es Off. TLCookieHostName especifica el nombre del seridor web que debe deolerse en la cabecera de respuesta de nombre de host (si TLCookieIssueHostName=On). Si el alor de HostName se establece en el alor predeterminado, se utiliza el nombre del sistema. El alor predeterminado para esta opción es default. Configuración para arios dominios Si está configurando el Inyector de cookies de Tealeaf para emitir identificadores para arios dominios, se requiere una configuración adicional. Consulte Capítulo 1, Instalación y configuración del Inyector de cookies de Tealeaf, en la página 1. Capítulo 3. Inyector de cookies de Tealeaf para Apache 2.x 13

20 14 IBM Tealeaf CX: Manual del Inyector de cookies de Tealeaf