Модуль Apache mod_usertrack
| Описание: | Регистрация последовательности переходов пользователя по сайту |
|---|---|
| Статус: | Расширение |
| Идентификатор модуля: | usertrack_module |
| Исходный файл: | mod_usertrack.c |
Краткое описание
Отслеживает перемещения пользователя по вашему сайту с помощью файлов cookie браузера.
Регистрация событий
mod_usertrack устанавливает файл cookie, события с которым можно регистрировать с помощью настраиваемых форматов журналов mod_log_config:
LogFormat "%{Apache}n %r %t" usertrack
CustomLog "logs/clickstream.log" usertrack Директива CookieDomain
| Описание: | Домен, к которому применяется файл cookie отслеживания |
|---|---|
| Синтаксис: | CookieDomain domain |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
Эта директива задает домен, к которому применяется файл cookie отслеживания. Если директива не указана, поле заголовка cookie не содержит домен.
Строка домена должна начинаться с точки и должна содержать как минимум одну точку внутри. То есть .example.com допустимо, а www.example.com и .com — нет.
.co.uk, хотя формально такой домен соответствует приведенным выше требованиям.Такие домены эквивалентны доменам верхнего уровня, например
.com, и разрешение таких файлов cookie может представлять угрозу безопасности. Поэтому, если ваш домен верхнего уровня состоит из двух частей, все равно следует указывать фактический домен, как и для любого другого домена верхнего уровня (например, .example.co.uk). CookieDomain .example.com
Директива CookieExpires
| Описание: | Срок действия файла cookie отслеживания |
|---|---|
| Синтаксис: | CookieExpires expiry-period |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
При использовании эта директива задает срок действия файла cookie, создаваемого модулем usertrack. Период действия можно указать числом секунд либо в формате, например «2 weeks 3 days 7 hours». Допустимые единицы: годы, месяцы, недели, дни, часы, минуты и секунды. Если срок действия задан не одним числом секунд, его необходимо заключить в двойные кавычки.
Если директива не используется, файлы cookie действуют только в течение текущего сеанса браузера.
CookieExpires "3 weeks"
Директива CookieHTTPOnly
| Описание: | Добавляет к файлу cookie атрибут 'HTTPOnly' |
|---|---|
| Синтаксис: | CookieHTTPOnly on|off |
| Значение по умолчанию: | CookieHTTPOnly off |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
| Совместимость: | 2.4.42 и более поздние версии |
Если задать значение 'ON', к файлу cookie отслеживания этого модуля будет добавлен атрибут 'HTTPOnly'. Этот атрибут указывает браузерам блокировать доступ JavaScript к значению файла cookie.
Директива CookieName
| Описание: | Имя файла cookie отслеживания |
|---|---|
| Синтаксис: | CookieName token |
| Значение по умолчанию: | CookieName Apache |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
Эта директива позволяет изменить имя файла cookie, который модуль использует для отслеживания. По умолчанию файл cookie называется "Apache".
Необходимо указать допустимое имя файла cookie; при использовании имени с необычными символами результат непредсказуем. Допустимые символы: A-Z, a-z, 0-9, "_" и "-".
CookieName clicktrack
Директива CookieSameSite
| Описание: | Добавляет к файлу cookie атрибут 'SameSite' |
|---|---|
| Синтаксис: | CookieSameSite None|Lax|Strict |
| Значение по умолчанию: | unset |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
| Совместимость: | 2.4.42 и более поздние версии |
Если задать значение 'None', 'Lax' или 'Strict', к файлу cookie отслеживания этого модуля будет добавлен атрибут 'SameSite' с соответствующим значением. Этот атрибут указывает браузеру, как обрабатывать файл cookie при запросе в межсайтовом контексте.
Значение 'None' задает 'SameSite=None' — наиболее разрешительный режим. Чтобы не добавлять этот атрибут, не указывайте директиву.
Директива CookieSecure
| Описание: | Добавляет к файлу cookie атрибут 'Secure' |
|---|---|
| Синтаксис: | CookieSecure on|off |
| Значение по умолчанию: | CookieSecure off |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
| Совместимость: | 2.4.42 и более поздние версии |
Если задать значение 'ON', к файлу cookie отслеживания этого модуля будет добавлен атрибут 'Secure'. Этот атрибут указывает браузерам передавать файл cookie только по HTTPS.
Директива CookieStyle
| Описание: | Формат поля заголовка cookie |
|---|---|
| Синтаксис: | CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 |
| Значение по умолчанию: | CookieStyle Netscape |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
Эта директива задает формат поля заголовка cookie. Допускаются три формата:
- Netscape — исходный, но ныне устаревший синтаксис. Используется по умолчанию; именно этот синтаксис Apache применял исторически.
- Cookie или RFC2109 — синтаксис, пришедший на смену синтаксису Netscape.
- Cookie2 или RFC2965 — наиболее современный синтаксис cookie.
Не все клиенты поддерживают все эти форматы, однако следует использовать самый новый формат, совместимый с браузерами ваших пользователей. На момент написания документации большинство браузеров поддерживают все три формата, при этом предпочтительным является Cookie2.
CookieStyle Cookie2
Директива CookieTracking
| Описание: | Включает файл cookie отслеживания |
|---|---|
| Синтаксис: | CookieTracking on|off |
| Значение по умолчанию: | CookieTracking off |
| Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
Когда загружен mod_usertrack и задан CookieTracking on, Apache будет отправлять файл cookie для отслеживания пользователя при каждом новом запросе. С помощью этой директивы поведение можно включить или отключить на уровне сервера или каталога. По умолчанию включение mod_usertrack не активирует файлы cookie.
CookieTracking on
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_usertrack.html
