Модуль 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 недели 3 дня 7 часов». Допустимые единицы измерения: годы, месяцы, недели, дни, часы, минуты и секунды. Если срок действия задан в формате, отличном от одного числа, обозначающего количество секунд, он должен быть заключен в двойные кавычки.
Если эта директива не используется, файлы cookie действуют только в рамках текущей сессии браузера.
CookieExpires "3 weeks"
Директива CookieHTTPOnly
| Описание: | Добавляет атрибут 'HTTPOnly' к файлу cookie |
|---|---|
| Синтаксис: | 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
| Описание: | Добавляет атрибут 'SameSite' к файлу cookie |
|---|---|
| Синтаксис: | CookieSameSite None|Lax|Strict |
| Значение по умолчанию: | unset |
| Контекст: | настройки сервера, виртуальный хост, каталог, .htaccess |
| Переопределение: | FileInfo |
| Статус: | Расширение |
| Модуль: | mod_usertrack |
| Совместимость: | 2.4.42 и более поздние версии |
При установке в 'None', 'Lax' или 'Strict', атрибут 'SameSite' добавляется к файлу cookie отслеживания этого модуля с соответствующим значением. Этот атрибут дает браузеру инструкции по обработке cookie в контексте межсайтового запроса.
Значение 'None' устанавливает 'SameSite=None', что является наиболее либеральным значением. Чтобы исключить этот атрибут, полностью опустите директиву.
Директива CookieSecure
| Описание: | Добавляет атрибут 'Secure' к файлу cookie |
|---|---|
| Синтаксис: | 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
