Serveur HTTP Apache Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

# Module Apache mod_usertrack

Description: | Journalisation Clickstream des liens parcourus par un utilisateur sur un site
Statut: | Extension
Identificateur de Module: | usertrack_module
Fichier Source: | mod_usertrack.c

### Sommaire

Ce module permet de suivre le parcours d'un utilisateur à travers votre site web en faisant appel aux cookies de navigateur.

### Sujets

- Journalisation

### Directives

### Traitement des bugs

- Journal des modifications de httpd
- Problèmes connus
- Signaler un bug

## Journalisation

`mod_usertrack` définit un cookie qui peut être journalisé via les formats configurables du module `mod_log_config` :

    LogFormat "%{Apache}n %r %t" usertrack
    CustomLog "logs/clickstream.log" usertrack

## Directive CookieDomain

Description: | Le domaine auquel le cookie traceur s'applique
Syntaxe: | `CookieDomain domaine`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack

Cette directive permet de définir le domaine auquel le cookie traceur s'applique. Si elle n'est pas présente, aucun domaine n'est inclus dans le champ d'en-tête cookie.

La chaîne dommaine doit commencer par un point, et doit comporter au moins un point entouré d'autres caractères. Par exemple, `.example.com` est une chaîne valide, mais `www.example.com` et `.com` ne le sont pas.

La plupart des navigateurs utilisés actuellement n'autorisent pas la définition de cookies pour un domaine racine de deux niveaux, tel que `.co.uk`, bien qu'un tel domaine remplisse les conditions de validité décrites ci-dessus.
Ces domaines sont équivalents à des domaines racines comme `.com`, et autoriser de tels cookies peut constituer un risque en matière de sécurité. Ainsi, si vous vous situez sous un domaine racine de deux niveaux, vous devez encore utiliser votre domaine véritable, comme vous le feriez avec tout autre domaine racine (par exemple `.example.co.uk`).

    CookieDomain .example.com

## Directive CookieExpires

Description: | Durée avant expiration du cookie traceur
Syntaxe: | `CookieExpires durée`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack

Lorsqu'elle est utilisée, cette directive définit une durée avant l'expiration du cookie généré par le module usertrack. La durée peut être spécifiée sous la forme d'un nombre de secondes, ou sous une forme du style "2 weeks 3 days 7 hours". les termes valides sont : years, months, weeks, days, hours, minutes et seconds. Si la durée est spécifiée dans un format autre qu'un nombre de secondes, elle doit être entourée de guillemets.

Si cette directive est absente, la durée de vie des cookies est limitée à la session actuelle du navigateur.

    CookieExpires "3 weeks"

## Directive CookieHTTPOnly

Description: | Ajoute l'attribut 'HTTPOnly' au cookie
Syntaxe: | `CookieHTTPOnly on|off`
Défaut: | `CookieHTTPOnly off`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack
Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache

Lorsqu'elle est définie à 'ON', cette directive ajoute l'attribut 'HTTPOnly' au cookie de traçage. Cet attribut indique aux navigateurs qu'ils doivent bloquer javascript au cours de la lecture de la valeur du cookie.

## Directive CookieName

Description: | Nom du cookie traceur
Syntaxe: | `CookieName symbole`
Défaut: | `CookieName Apache`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack

Cette directive vous permet de modifier le nom du cookie que ce module utilise pour sa journalisation. Le nom par défaut du cookie est "`Apache`".

Vous devez spécifier un nom de cookie valide ; les résultats sont imprévisibles si vous utilisez un nom contenant des caractères inhabituels. Les caractères valides font partie des intervales A-Z, a-z, 0-9, "_", et "-".

    CookieName clicktrack

## Directive CookieSameSite

Description: | Ajoute l'attribut 'SameSite' au cookie
Syntaxe: | `CookieSameSite None|Lax|Strict`
Défaut: | `unset`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack
Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache

Lorsque cette directive est définie à 'None', 'Lax', ou 'Strict', l'attribut 'SameSite' est ajouté au cookie de traçage avec la valeur correspondante. Cet attribut indique aux navigateurs de quelle manière ils doivent traiter le cookie lorsqu'il est demandé dans un contexte cross-site.

'None' définit l'attribut 'SameSite' à 'None', ce qui correspond à la configuration la plus permissive. Pour ne pas ajouter cet attribut au cookie, il est donc préférable de ne pas définir du tout cette directive.

## Directive CookieSecure

Description: | Ajoute l'attribut 'Secure' au cookie
Syntaxe: | `CookieSecure on|off`
Défaut: | `CookieSecure off`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack
Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache

Lorsqu'elle est définie à 'ON', cette directive ajoute l'attribut 'Secure' au cookie de traçage. Cet attribut indique aux navigateurs qu'il ne doivent transmettre le cookie que via HTTPS.

## Directive CookieStyle

Description: | Format du champ d'en-tête cookie
Syntaxe: | `CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965`
Défaut: | `CookieStyle Netscape`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack

Cette directive permet de contrôler le format du champ d'en-tête cookie. Les trois formats autorisés sont :

- Netscape : il s'agit du format original, mais est désormais obsolète. C'est le format par défaut et il correspond à la syntaxe historique utilisée par Apache.
- Cookie ou RFC2109 : c'est la syntaxe qui remplace la syntaxe Netscape.
- Cookie2 ou RFC2965 : c'est la syntaxe de cookie la plus actuelle.

Tous les clients ne supportent pas l'ensemble de ces formats, mais il est conseillé d'utiliser le plus récent qui sera en général supporté par le navigateur utilisé par vos utilisateurs. A l'heure où ce document est écrit, la plupart des navigateurs supportent ces trois formats, `Cookie2` étant le format recommandé.

    CookieStyle Cookie2

## Directive CookieTracking

Description: | Active le cookie traceur
Syntaxe: | `CookieTracking on|off`
Défaut: | `CookieTracking off`
Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées: | FileInfo
Statut: | Extension
Module: | mod_usertrack

Lorsque le module `mod_usertrack` est chargé, et si `CookieTracking on` est définie, Apache enverra un cookie traceur pour toute nouvelle requête. Cette directive peut être utilisée pour activer ou désactiver ce comportement pour un serveur virtuel ou un répertoire. Par défaut, l'activation de `mod_usertrack` ne suffit pas pour activer les cookies.

    CookieTracking on