User Tracking Module¶

• Table of contents
• User Tracking Module
  • Description
  • Installation
  • Options

Module mod_usertrack

Description¶

Clickstream is the series of page visits and associated clicks executed by a website visitor when navigating through the site. Usertrack module sets a cookie on the user's side in order to enable clickstream logging to track user activity.

Installation¶

In order to use mod_usertrack, you need to load it first. Make sure you have following line inside your configuration file:

server.modules = {
    ...,
    "mod_usertrack",
    ...
}

Options¶

usertrack.cookie-name
This option allows the setting of the name of the cookie. The default is 'TRACKID'. Currently it only allows a-z.
e.g.: usertrack.cookie-name = "mycookie"

usertrack.cookie-attrs
(since lighttpd 1.4.46)
This option allows the setting all of the attributes of the cookie, including Path, Domain, Max-Age, Secure, HttpOnly, SameSite, and more. Setting this will cause usertrack.cookie-domain and usertrack.cookie-max-age to be ignored. This string is included verbatim in the response Cookie header and values should be properly URL-encoded.
e.g.: usertrack.cookie-attrs = "; Path=/; Version=1; Domain=.mydom.com; Max-Age=86400; Secure; HttpOnly, SameSite"

references:
https://en.wikipedia.org/wiki/HTTP_cookie
Secure: http://www.faqs.org/rfcs/rfc2965.html
HttpOnly: https://blog.codinghorror.com/protecting-your-cookies-httponly/
SameSite: https://scotthelme.co.uk/csrf-is-dead/)

usertrack.cookie-domain
(deprecated; subsumed by usertrack.cookie-attrs since lighttpd 1.4.46)
Sets the domain name to which this cookie applies.
e.g.: usertrack.cookie-domain = ".example.com"

usertrack.cookie-max-age
(deprecated; subsumed by usertrack.cookie-attrs since lighttpd 1.4.46)
Sets the maximum duration in seconds of the cookie. If not specified it will not add a 'max-age' to the cookie, meaning it will not expire.
e.g.: usertrack.cookie-max-age = 60