IBM Tealeaf CX Version 9.0.1 4 décembre 2014 Manuel de l'injecteur de cookies
Important Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations figurant à la section «Remarques», à la page 29. LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial. Vous pouvez également consulter les serveurs Internet suivants : v http://www.fr.ibm.com (serveur IBM en France) v http://www.ibm.com/ca/fr (serveur IBM au Canada) v http://www.ibm.com (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, avenue de l'europe 92275 Bois-Colombes Cedex Cette édition s'applique à la version 9.0.1 de IBM Tealeaf CX et à toutes les éditions et modifications ultérieures, sauf mention contraire dans les nouvelles éditions. Copyright IBM Corporation 1999, 2014.
Table des matières Avis aux lecteurs canadiens...... v Le manuel de l'injecteur de cookies Tealeaf............... vii Chapitre 1. Installation et configuration de l'injecteur de cookies Tealeaf.... 1 Présentation générale........... 1 Plateformes prises en charge......... 2 Prise en charge du protocole SSL....... 2 Maintenance et traitement des incidents..... 2 Désactivation d'autres agents de session..... 3 Acquisition du logiciel........... 3 Instructions d'installation et de configuration... 3 Configuration de l'injecteur de cookies Tealeaf pour plusieurs domaines......... 3 Configuration de cxresults........ 4 Vérification de l'installation......... 4 Mise à niveau de l'injecteur de cookies Tealeaf... 5 Mise à niveau du serveur Web....... 5 Sauvegarde.............. 5 Gestion des modifications de configuration... 5 Processus de mise à niveau........ 5 Chapitre 2. Injecteur de cookies Tealeaf pour Apache 1.3.x.......... 7 Configuration système requise........ 7 Installation de l'injecteur de cookies à l'aide d'un script................. 7 Installation manuelle de l'injecteur de cookies... 7 Configuration.............. 8 Configuration pour plusieurs domaines.... 9 Chapitre 3. Injecteur de cookies Tealeaf pour Apache 2.x........... 11 Configuration système requise........ 11 Installation de l'injecteur de cookies à l'aide d'un script................ 11 Installation manuelle de l'injecteur de cookies... 11 Configuration............. 12 Configuration pour plusieurs domaines.... 13 Chapitre 4. Injecteur de cookies Tealeaf pour IIS 6.0 de Microsoft....... 15 Configuration système requise........ 15 Niveau de l'installation.......... 15 Serveur............... 15 Site................ 15 Utilisation du script de configuration...... 16 Installation manuelle........... 16 Configuration............. 16 Configuration pour plusieurs domaines.... 18 Chapitre 5. Injecteur de cookies Tealeaf pour IIS, version 7.0 ou supérieure, de Microsoft.............. 19 Installation.............. 19 Niveau de l'installation......... 19 Utilisation du script de configuration..... 19 Installation manuelle.......... 20 Configuration............. 20 Configuration pour plusieurs domaines.... 22 Chapitre 6. Injecteur de cookies Tealeaf pour SunOne-iPlanet, version 3.1 ou supérieure............. 23 Configuration système requise........ 23 Installation de l'injecteur de cookies à l'aide d'un script................ 23 Installation manuelle de l'injecteur de cookies... 23 Configuration............. 24 Configuration pour plusieurs domaines.... 25 Chapitre 7. Documentation et aide sur IBM Tealeaf............. 27 Remarques............. 29 Marques............... 31 Règles de confidentialité.......... 31 Copyright IBM Corp. 1999, 2014 iii
iv IBM Tealeaf CX - Manuel de l'injecteur de cookies
Avis aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuvent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-vous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claviers Les lettres sont disposées différemment : le clavier français est de type AZERTY, et le clavier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (français-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches présentées dans le tableau d'équivalence suivant sont libellées différemment selon qu'il s'agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier. Copyright IBM Corp. 1999, 2014 v
Brevets Il est possible qu'ibm détienne des brevets ou qu'elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu'ibm vous fournisse le présent document ne signifie pas qu'elle vous accorde un permis d'utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si vous avez besoin d'assistance ou si vous voulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234. vi IBM Tealeaf CX - Manuel de l'injecteur de cookies
Le manuel de l'injecteur de cookies Tealeaf Le manuel de l'injecteur de cookies Tealeaf fournit des instructions d'installation et de configuration pour l'injecteur de cookies Tealeaf, un générateur de cookies simple pouvant être installé sur votre serveur Web. Une fois déployé, l'injecteur de cookies génère des identifiants de session qui sont garantis uniques au sein de Tealeaf. Remarque : L'injecteur de cookies est la méthode de génération d'identifiants préférée de Tealeaf. Tealeaf fournit plusieurs mécanismes pour obtenir des identifiants session. Consultez "Gestion de la mise en sessions de données dans Tealeaf CX" dans le document IBM Tealeaf CX Installation Manual. Copyright IBM Corp. 1999, 2014 vii
viii IBM Tealeaf CX - Manuel de l'injecteur de cookies
Chapitre 1. Installation et configuration de l'injecteur de cookies Tealeaf Présentation générale Ce document fournit des informations relatives à l'installation et à la configuration de l'injecteur de cookies Tealeaf sur chaque plateforme prise en charge. Remarque : L'injecteur de cookies Tealeaf constitue un composant facultatif séparé de tout autre logiciel Tealeaf dont vous possédez la licence. L'utilisation du code d'injecteur de cookies est sujet aux conditions suivantes : LE LOGICIEL D'INJECTEUR DE COOKIES EST FOURNI "TEL QUEL" PAR TEALEAF TECHNOLOGY, INC., UNE SOCIÉTÉ IBM ("TEALEAF")", ET TOUTE GARANTIE, EXPLICITE OU IMPLICITE, Y COMPRIS ET SANS LIMITATION, LES GARANTIES IMPLICITES DE VALEUR MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET D'ABSENCE DE CONTREFAÇON, EST EXCLUE. TEALEAF OU SES ENTITÉS MÈRES, AFFILIÉES ET FILIALES NE SERONT EN AUCUN CAS TENUS POUR RESPONSABLE D'EVENTUELS DOMMAGES DIRECTS, INDIRECTS, MINEURS, SPÉCIAUX, EXEMPLAIRES OU CONSÉQUENTS (Y COMPRIS ET SANS LIMITATION, ACQUISITION DE PRODUITS OU SERVICES DE SUBSTITUTION, PERTE DE JOUISSANCE, DE DONNÉES OU DE BÉNÉFICES ET ARRÊT DE L'EXPLOITATION), QUELLES QU'EN SOIENT LES CAUSES ET QUEL QUE SOIT LE TYPE DE RESPONSABILITÉ, CONTRACTUELLE, SANS FAUTE OU FONDÉE SUR UN DÉLIT CIVIL (Y COMPRIS PAR NÉGLIGENCE) DÉCOULANT DE QUELQUE FAÇON QUE CE SOIT DE L'UTILISATION DE CE LOGICIEL D'INJECTEUR DE COOKIES, MÊME SUR RÉCEPTION D'UN AVIS CONCERNANT LA POSSIBILITÉ DE TELS DOMMAGES. Remarque : La réglementation sur la confidentialité et les communications électroniques de 2003 comportent des directives spécifiques relatives à l'utilisation et à la gestion des cookies pour les clients de l'union européenne. Consultez votre conseiller juridique pour plus d'informations sur la conformité à ces directives et aux autres réglementations applicables relatives à la confidentialité. L'injecteur de cookies Tealeaf est une fonctionnalité spécifique de plateforme simplifiée installée sur le serveur Web ou le serveur d'application et qui émet des cookies HTTP contenant des identificateurs globaux uniques (GUID). Ces GUID sont utilisés dans la mise en sessions des données capturées par IBM Tealeaf cximpact. L'injecteur de cookies Tealeaf est utilisé de concert avec la capture passive Tealeaf lorsqu'il n'existe aucun variable d'état d'application ou de cookie existant pouvant être désigné comme clé fiable pour ordonnancer les paires de requête et de réponse HTTP(S) en une session visiteur logique. L'injecteur de cookies Tealeaf est installé sur chaque serveur d'application ou serveur Web et y vérifie chaque requête entrante pour le ou les cookies configurés. Si la requête ne contient pas le ou les cookies devant être émis par l'injecteur de cookies, l'injecteur ajoute un en-tête Set-Cookie à chaque réponse de chaque cookie. Copyright IBM Corp. 1999, 2014 1
Plateformes prises en charge v Il peut également éventuellement injecter les cookies dans les en-têtes de requête pour qu'ils soient vus par les composants de l'application Web qui sont en aval du serveur, là où est installé l'injecteur. L'injecteur de cookies peut également ajouter un en-tête de réponse qui identifie le nom du serveur afin que cette information soit disponible en impacts capturés par un serveur IBM Tealeaf CX Passive Capture Application. v L'injecteur de cookies Tealeaf ne reconfigure pas et n'interfère pas avec les ports utilisés par vos serveurs Web. L'injecteur de cookies prend en charge les systèmes d'exploitation et les plateformes de serveur suivants : Remarque : Concernant les versions et systèmes d'exploitation non pris en charge, un code source peut être fourni sur demande. Pour plus d'informations, contactez Tealeaf http://support.tealeaf.com. Tableau 1. Plateformes prises en charge Logiciel serveur Windows 2000, 2003, 2008 et version Linux (Intel), noyau 6.2 ou version Solaris (SPARC) 6 ou version supérieure IBM AIX 4.3 ou version supérieure supérieure supérieure SunOne/iPlanet 3.1 ou version supérieure Oui Oui Oui Oui Apache 1.3.19 ou version antérieure Apache 2.0.39 ou version antérieure MSFT IIS 5.0 ou version supérieure Disponible sur demande Oui Oui Oui Oui Oui Oui Oui Oui Non disponible Non disponible Non disponible Remarque : Les filtres Apache ou SunOne/iPlanet peuvent être disponibles pour d'autres variantes UNIX sur demande. Si Tealeaf ne peut fournir de version binaire, le code source peut être disponible afin que les clients puissent la générer. Remarque : Les injecteurs de cookies des versions antérieures d'apache 1.3 sont disponibles sur demande. Prise en charge du protocole SSL L'injecteur de cookies Tealeaf optimise l'architecture native du serveur Web pour évaluer et injecter la suite de cookies Tealeaf configurée. L'injecteur de cookies exécute cette procédure après que le serveur Web a déchiffré ou terminé la connexion SSL. Ainsi, l'injecteur de cookies Tealeaf n'affecte pas le processus d'arrêt SSL et aucune mention de certificats SSl n'est nécessaire. Maintenance et traitement des incidents L'injecteur de cookies Tealeaf doit être traité comme une option de configuration de production du serveur Web. Si vous souhaitez résoudre un problème sur le serveur Web, vous pouvez désactiver l'injecteur de cookies Tealeaf et reprendre vos activité sur le serveur 2 IBM Tealeaf CX - Manuel de l'injecteur de cookies
Web. Une fois l'injecteur de cookies désactivé, les cookies Tealeaf configurés pour être émis par l'injecteur de cookies ne se trouvent plus dans le flux de données de réponse et de demande HTTP(S). v Le processus de désactivation de l'injecteur de cookies varie selon les plateformes. Désactivation d'autres agents de session Acquisition du logiciel Pour que l'injecteur de cookies Tealeaf puisse fonctionner correctement, vous devez désactiver d'autres agents de mise en sessions Tealeaf car ils peuvent redéfinir les valeurs définies par l'injecteur de cookies. 1. Via TMS, ouvrez Pipeline Editor. v Consultez "Système de gestion Tealeaf" dans le document IBM Tealeaf cximpact Administration Manual. 2. Les agents de session suivants ne doivent pas se trouver dans le pipeline de traitement principal ou dans tout pipeline enfant du pipeline de traitement principal : v [Sessioning] v [TLSessioning] 3. Via la PCA, vous pouvez désactiver la "mise en sessions". Dans l'onglet Pipeline de la console Web PCA, vérifiez que le paramètre Use Sessioning est réglé sur false. Si vous devez modifier la configuration, sélectionnez Enregistrez les modifications en bas de la page de l'onglet Pipeline. v Reportez-vous à la section "Console Web PCA - Pipeline Tab" du Guide de l'application Passive Capture d'ibm Tealeaf. Le logiciel d'injecteur de cookies Tealeaf est disponible pour installation depuis la distribution Tealeaf du répertoire suivant : TealeafCX\Sample Code\ cxcookiefilters Instructions d'installation et de configuration Concernant votre plateforme Web, utilisez le lien ci-dessous pour obtenir des instructions concernant l'installation et la configuration de l'injecteur de cookies Tealeaf : v Chapitre 6, «Injecteur de cookies Tealeaf pour SunOne-iPlanet, version 3.1 ou supérieure», à la page 23 v Chapitre 2, «Injecteur de cookies Tealeaf pour Apache 1.3.x», à la page 7 v Chapitre 3, «Injecteur de cookies Tealeaf pour Apache 2.x», à la page 11 v Chapitre 4, «Injecteur de cookies Tealeaf pour IIS 6.0 de Microsoft», à la page 15 v Chapitre 5, «Injecteur de cookies Tealeaf pour IIS, version 7.0 ou supérieure, de Microsoft», à la page 19 Configuration de l'injecteur de cookies Tealeaf pour plusieurs domaines Vous pouvez configurer l'injecteur de cookies Tealeaf pour émettre des identificateurs de session pour plusieurs domaines traités par le même serveur Web Apache. Chapitre 1. Installation et configuration de l'injecteur de cookies Tealeaf 3
Remarque : L'injecteur de cookies Tealeaf doit être installé au niveau global. Limiter le module à des hôtes virtuels spécifiques ne constitue pas une solution prise en charge. Dans le fichier de configuration teacookies.conf, vérifiez que les propriétés suivantes sont réglées sur les valeurs suivantes : TLCookieIssueSID=On TLCookieDomain n est pas réglé TLAddHostCookieDomain=True Remarque : Le paramètre TLCookieDomain est mis en commentaire. Lorsque TLAddHostCookieDomain=True, les deux domaines de second niveau émettent des cookies identificateurs distincts car ils possèdent des noms de domaine différents. Configuration de cxresults Si IBM Tealeaf cxresults a été installé et configuré avant l'installation et l'utilisation de l'injecteur de cookies Tealeaf, IBM Tealeaf cxresults doit être mis à niveau pour intégrer le nouvel identifiant utilisateur fourni par l'injecteur de cookies. Vérification de l'installation v Consultez "Initial cxresults Configuration" dans le document IBM Tealeaf cxresults Administration Manual Pour vérifier que l'injecteur de cookies Tealeaf est correctement installé, procédez aux étapes suivantes pour créer une session Tealeaf avec le cookie Tealeaf inséré dans la requête et pour afficher la session via IBM Tealeaf CX RealiTea Viewer ou via la relecture sur navigateur sur le portail Tealeaf. 1. A l'aide de votre navigateur Web, consultez l'application Web surveillée par Tealeaf. Naviguez sur quelques pages pour créer une session identifiable. 2. Via le portail Tealeaf ou IBM Tealeaf CX RealiTea Viewer, recherchez les sessions Tealeaf qui ont eu lieu depuis que vous avez installé l'injecteur de cookies. Remarque : v Le cookie Tealeaf est installé par l'injecteur de cookies pour chaque visiteur et est enregistré par la session. v En fonction des paramètres de délai d'attente de session, vous devez chercher des sessions actives et terminées. Pour plus d'informations sur la recherche de RTV, consultez "RealiTea Viewer - Recherche de sessions" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Pour plus d'informations sur la recherche dans le portail Tealeaf, consultez "Recherche dans les données de session" dans le document IBM Tealeaf cximpact - Guide d'utilisation. 3. Réexécutez une session trouvée. Pour plus d'informations sur la relecture de RTV, consultez "RealiTea Viewer - Fenêtre principale" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisateur. Pour plus d'informations sur la relecture dans le portail Tealeaf, consultez "Relecture sur navigateur CX" dans le document IBM Tealeaf cximpact - Guide d'utilisateur. 4 IBM Tealeaf CX - Manuel de l'injecteur de cookies
4. Examinez l'affichage des requêtes de la première page de la session. a. Dans la session [env], vérifiez HTTP_SET_COOKIE. La valeur de TLTSID ne doit pas être définie. b. Dans la section [iamie], la valeur de TLTSID ne doit pas être la même que dans la section [env]. 5. Accédez à la dernière page de la session. Vérifiez que la valeur de TLTSID est la même que dans les sections d'affichage de requêtes. Mise à niveau de l'injecteur de cookies Tealeaf Mise à niveau du serveur Web Pour mettre à niveau votre serveur Web, vous devez désinstaller l'injecteur de cookies puis le réinstaller. Par exemple, si vous passez de la version Apache 1.3 à la version Apache 2.0, une version différente d'injecteur de cookies est nécessaire. Consultez la documentation appropriée concernant la version de l'injecteur de cookies afin d'effectuer la mise à niveau. Remarque : Pour conserver vos paramètres de configuration, vous devez migrer les paramètres de votre ancienne version vers la nouvelle version. Voir «Gestion des modifications de configuration». Sauvegarde Avant de démarrer la mise à niveau, sauvegardez le répertoire de l'injecteur de cookies Tealeaf sur votre serveur Web. Gestion des modifications de configuration Les fichiers de configuration de l'injecteur de cookies ne sont que rarement modifiés. Cependant, avant la mise à niveau, copiez les modifications de configuration des anciens fichiers dans les nouveaux fichiers de configuration. v Vous pourrez alors plus facilement différencier les fichiers et appliquer tout paramètre modifié ou nouveau du nouveau fichier dans l'ancien fichier. Sauvegardez le nouveau fichier de configuration modifié en-dehors du répertoire de l'injecteur de cookies. Processus de mise à niveau 1. Vérifiez que la sauvegarde est terminée. 2. Copiez les nouveaux fichiers.dll ou.so dans le répertoire de l'injecteur de cookies Tealeaf sur votre serveur Web. 3. Copiez les fichiers de configuration modifiés dans le répertoire de l'injecteur de cookies Tealeaf. 4. Redémarrez le serveur Web. 5. Vérifiez que l'injecteur de cookies fonctionne correctement. Voir «Vérification de l'installation», à la page 4. Chapitre 1. Installation et configuration de l'injecteur de cookies Tealeaf 5
6 IBM Tealeaf CX - Manuel de l'injecteur de cookies
Chapitre 2. Injecteur de cookies Tealeaf pour Apache 1.3.x Avant de commencer, assurez-vous de disposer du logiciel d'injecteur de cookies Tealeaf approprié. Voir «Acquisition du logiciel», à la page 3. Voir Chapitre 1, «Installation et configuration de l'injecteur de cookies Tealeaf», à la page 1. Configuration système requise Il n'existe pas d'autre configuration système requise que les fichiers de l'injecteur de cookies Tealeaf. Parmi les fichiers de l'injecteur de cookies Tealeaf répertoriés ci-dessous, mod_teacookies1-3.so et teacookies.conf sont des fichiers requis devant être déployés sur le serveur Web dans le répertoire approprié : v v mod_teacookies1-3.so : fichier de l'injecteur de cookies Tealeaf pour Apache 1.3.x teacookies.conf : fichier de configuration de l'injecteur de cookies Tealeaf pour Apache 1.3.x Installation de l'injecteur de cookies à l'aide d'un script Cette section décrit comment installer l'injecteur de cookies à l'aide d'un script. Utilisez le script de configuration inclus pour installer l'injecteur de cookies. Ce script met automatiquement à jour les fichiers de configuration pour Apache 1.3.x et copie les fichiers de l'injecteur de cookies au bon endroit. 1. Exécutez le script de configuration, transmettant le chemin d'accès complet à HTTPd comme argument. Par exemple,./setup /usr/local/apache/bin/httpd. 2. Configurez l'injecteur de cookies en éditant teacookies.conf. Voir «Configuration», à la page 8. 3. Exécutez httpd -t pour tester la configuration, et vérifiez qu'aucune erreur ne s'affiche. 4. Redémarrez Apache pour charger l'injecteur de cookies. Installation manuelle de l'injecteur de cookies Cette section décrit comment installer manuellement l'injecteur de cookies. 1. Copiez mod_teacookies1-3.so et teacookies.conf depuis le disque de distribution vers un répertoire du disque dur local sur le serveur Web. 2. Ajoutez la ligne suivante à la fin du fichier de configuration d'apache httpd.conf, en remplaçant <path-to-teacookies> par le chemin d'accès actuel, là où teacookies.conf se trouve. Par exemple : inclure <path to-teacookies> 3. Configurez l'injecteur de cookies en éditant teacookies.conf. Voir «Configuration», à la page 8. 4. Exécutez httpd -t pour tester la configuration, et vérifiez qu'aucune erreur ne s'affiche. 5. Redémarrez Apache pour charger l'injecteur de cookies. Copyright IBM Corp. 1999, 2014 7
Configuration Cette section contient des informations de configuration relatives à l'injecteur de cookies pour Apache, version 1.3.x Tableau 2. Paramètres de configuration pour teacookies.conf. Option Description 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 TLCookieAddHostCookieDomain On Cette ligne charge mod_teacookies1-3.so. Dans la commande, remplacez les modules par le chemin d'accès actuel vers mod_teacookies1-3.so. Cette option détermine si le filtre à cookies est activé ou non. Régler cette option sur Off désactive le filtre au prochain démarrage d'apache. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTSID (cookie identifiant session) dans le cas où ce cookie n'est pas présent dans la requête. La valeur par défaut de cette option est On. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTHID (cookie identifiant impact). Cet en-tête est ajouté à chaque réponse si TLCookieIssueHID=On. La valeur par défaut de cette option est Off. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTUID (cookie identifiant utilisateur) dans le cas où ce cookie n'est pas présent dans la requête. La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTSID (cookie identifiant session) dans l'en-tête de requête du cookie dans le cas où un cookie n'est pas présent dans la requête. L'en-tête du cookie est ajouté si aucun n'existe. La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTHID (cookie identifiant impact) dans l'en-tête de requête du cookie (l'en-tête du cookie est ajouté si aucun n'existe). La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTUID (cookie identifiant utilisateur) dans l'en-tête de requête du cookie dans le cas où ce cookie n'est pas présent dans la requête (l'en-tête du cookie est ajouté si aucun n'existe). La valeur par défaut de cette option est Off. Cette option définit le domaine ajouté aux cookies émis. Le paramètre commence par un point et contient au moins deux parties qui fonctionnent pour tout sous-domaine du domaine spécifié. Par exemple, www.mydomain.com et www2.mydomain.com. Si cette valeur n'est pas spécifiée, le domaine est analysé par l'en-tête hôte dans la requête. Si cette valeur est réglée sur True, le domaine utilisé pour les cookies émis est analysé par l'en-tête hôte dans la requête. Cette option est utile pour les sites qui disposent de plus d'un domaine de niveau supérieur (par exemple, www.mystuff.com et www.foobar.com). Cette option est ignorée s'il existe une valeur spécifiée pour TLCookieDomain. La valeur par défaut de cette option est On. 8 IBM Tealeaf CX - Manuel de l'injecteur de cookies
Tableau 2. Paramètres de configuration pour teacookies.conf. (suite) Option TLCookieExtendedCookieDomain Off TLCookieSecureCookie Off TLCookieIssueHostName Off TLCookieHostName=<nomdemachine> Description Si cette valeur est réglée sur True (si AddHostCookieDomain=True), le domaine des en-têtes Set-Cookies est défini aux deux dernières parties du nom d'hôte (depuis l'en-tête hôte) si la dernière partie est.com,.mil,.gov,.edu,.org,.net ou.int, ou les trois dernières parties de l'hôte si ce n'est pas le cas. Lorsque cette valeur est réglée sur False (par défaut), le domaine des Set-Cookies est défini à l'ensemble du nom de domaine depuis l'en-tête hôte, dès le premier point. Cette option indique quand ajouter l'attribut sécurisé aux en-têtes Set-Cookie lors de la configuration des cookies. Régler cette option sur True peut forcer le navigateur à renvoyer uniquement les cookies Tealeaf pour les requêtes HTTPS. La valeur par défaut de cette option est Off. Cette option indique quand ajouter un en-tête de nom d'hôte à la réponse pour identifier le serveur Web. La valeur par défaut de cette option est Off. TLCookieHostName indique le nom du serveur Web à renvoyer dans l'en-tête de réponse du nom d'hôte (si TLCookieIssueHostName=On). Si la valeur du nom d'hôte est réglée sur défaut, le nom d'ordinateur est utilisé. La valeur par défaut de cette option est défaut. Configuration pour plusieurs domaines Si vous configurez l'injecteur de cookies Tealeaf dans le but d'émettre des identificateurs pour plusieurs domaines, une configuration supplémentaire est requise. v Voir Chapitre 1, «Installation et configuration de l'injecteur de cookies Tealeaf», à la page 1. Chapitre 2. Injecteur de cookies Tealeaf pour Apache 1.3.x 9
10 IBM Tealeaf CX - Manuel de l'injecteur de cookies
Chapitre 3. Injecteur de cookies Tealeaf pour Apache 2.x Avant de commencer, assurez-vous de disposer du logiciel d'injecteur de cookies Tealeaf approprié. Voir «Acquisition du logiciel», à la page 3. Voir Chapitre 1, «Installation et configuration de l'injecteur de cookies Tealeaf», à la page 1. Configuration système requise Il n'existe pas d'autre configuration système requise que les fichiers de l'injecteur de cookies Tealeaf. Parmi les fichiers de l'injecteur de cookies Tealeaf répertoriés ci-dessous, mod_teacookies.so et teacookies.conf sont des fichiers requis devant être déployés sur le serveur Web dans le répertoire approprié : v mod_teacookies.so : fichier d'injecteur de cookies Tealeaf pour Apache 2.x v teacookies.conf : fichier de configuration de l'injecteur de cookies Tealeaf pour Apache 2.x Installation de l'injecteur de cookies à l'aide d'un script Cette section décrit comment installer l'injecteur de cookies à l'aide d'un script. Utilisez le script de configuration inclus pour installer l'injecteur de cookies. Ce script met automatiquement à jour les fichiers de configuration pour Apache 2.x et copie les fichiers de l'injecteur de cookies au bon endroit. 1. Exécutez le script de configuration, transmettant le chemin d'accès complet à HTTPd comme argument. Par exemple,./setup /usr/local/apache/bin/httpd. 2. Configurez l'injecteur de cookies en éditant teacookies.conf. Voir «Configuration», à la page 12. 3. Exécutez httpd -t pour tester la configuration, et vérifiez qu'aucune erreur ne s'affiche. 4. Redémarrez Apache pour charger l'injecteur de cookies. Installation manuelle de l'injecteur de cookies Cette section décrit comment installer manuellement l'injecteur de cookies. 1. Copiez mod_teacookies.so et teacookies.conf depuis le disque de distribution vers un répertoire du disque dur local sur le serveur Web. 2. Ajoutez la ligne suivante à la fin du fichier de configuration d'apache, en remplaçant <path to-teacookies> par le chemin d'accès actuel, là où teacookies.conf se trouve. Par exemple : path to teacookies/teacookies.conf 3. Configurez le filtre à cookies en éditant teacookies.conf. Voir «Configuration», à la page 12. 4. Exécutez httpd -t pour tester la configuration, et vérifiez qu'aucune erreur ne s'affiche. 5. Redémarrez Apache pour charger l'injecteur de cookies. Copyright IBM Corp. 1999, 2014 11
Configuration Cette section contient des informations de configuration relatives à l'injecteur de cookies pour Apache, version 2.x Tableau 3. Paramètres de configuration pour teacookies.conf. Option Description LoadModule teacookies_module modules/ mod_teacookies.so TLCookieEnabled On TLCookieIssueSID On TLCookieIssueHID Off TLCookieIssueUID On TLCookieInjectSID Off TLCookieInjectHID Off TLCookieInjectUID Off TLCookieDomain.mydomain.com TLCookieAddHostCookieDomain On Cette ligne charge mod_teacookies.so. Dans la commande, remplacez les modules par le chemin d'accès actuel vers mod_teacookies.so. Cette option détermine si le filtre à cookies est activé ou non. Régler cette option sur Off désactive le filtre au prochain démarrage d'apache. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTSID (cookie identifiant de la session) dans le cas où ce cookie n'est pas présent dans la requête. La valeur par défaut de cette option est On. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTHID (cookie identifiant impact). Cet en-tête est ajouté à chaque réponse si TLCookieIssueHID=On. La valeur par défaut de cette option est Off. Cette option indique quand ajouter un en-tête Set-Cookie à la réponse pour TLTUID (cookie identifiant utilisateur) dans le cas où ce cookie n'est pas présent dans la requête. La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTSID (cookie identifiant session) dans l'en-tête de requête du cookie dans le cas où ce cookie n'est pas présent dans la requête. L'en-tête du cookie est ajouté quand aucun n'existe. La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTHID (cookie identifiant impact) dans l'en-tête de requête du cookie (l'en-tête du cookie est ajouté si aucun n'existe). La valeur par défaut de cette option est Off. Cette option indique quand insérer un nouveau TLTUID (cookie identifiant utilisateur) dans l'en-tête de requête du cookie dans le cas où ce cookie n'est pas présent dans la requête (l'en-tête du cookie est ajouté si aucun n'existe). La valeur par défaut de cette option est Off. Cette option définit le domaine ajouté aux cookies émis. Le paramètre commence par un point et contient au moins deux parties qui fonctionnent pour tout sous-domaine du domaine spécifié. Par exemple, www.mydomain.com et www2.mydomain.com. Si cette valeur n'est pas spécifiée, le domaine est analysé par l'en-tête hôte dans la requête. Si cette valeur est réglée sur True, le domaine utilisé pour les cookies émis est analysé par l'en-tête hôte dans la requête. Cette option est utile pour les sites qui disposent de plus d'un domaine de niveau supérieur (par exemple, www.mystuff.com et www.foobar.com). Cette option est ignorée s'il existe une valeur spécifiée pour TLCookieDomain. La valeur par défaut de cette option est On. 12 IBM Tealeaf CX - Manuel de l'injecteur de cookies