Apache 模組 mod_usertrack

可提供的語言： en | fr

說明	通過瀏覽器 cookie 記錄使用者在網站上的點擊串流活動。
狀態	擴充套件
模組識別碼	usertrack_module
原始檔	mod_usertrack.c

摘要

通過瀏覽器 cookie 來追蹤使用者在您網站中的活動。

主題

記錄

指令

CookieDomain
CookieExpires
CookieHTTPOnly
CookieName
CookieSameSite
CookieSecure
CookieStyle
CookieTracking

漏洞修正清單

另請參閱

意見回饋

記錄

mod_usertrack 會設定 cookie，該 cookie 可以透過 mod_log_config 中的可變更記錄格式來記錄

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

CookieDomain 指令

說明	追蹤 cookie 套用的網域
語法	`CookieDomain 網域`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack

此指令控制要將追蹤 cookie 套用於哪個網域的設定。若未指定，則 cookie 標頭欄位中不會包含網域。

網域字串必須以句點開頭，且必須包含至少一個內嵌句點。也就是說，.example.com 是合法的，但 www.example.com 和 .com 則不是。

目前大多數瀏覽器不允許為二部分頂層網域（例如 .co.uk）設定 cookie，即使此類網域表面上符合上述需求也是如此。
這些網域等同於頂層網域，例如 .com，而且允許這種 Cookie 可能有安全風險。因此，如果您隸屬於兩部分的頂層網域，您仍應使用您的實際網域，就像使用任何其他頂層網域一樣（例如 .example.co.uk）。

CookieDomain .example.com

CookieExpires 指令

說明	追蹤 Cookie 的過期時間
語法	`CookieExpires 過期期間`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack

使用此指令時，會為 usertrack 模組產生的 Cookie 設定一個過期時間。過期期間可以用秒數表示，或採用「2 週 3 天 7 小時」等格式。有效的計量單位：年、月、週、日、時、分和秒。如果過期時間採用一個數字而非秒數表示的任何一種格式，則必須加雙引號。

如果沒有使用此指令，Cookie 只會持續目前的瀏覽器工作階段。

CookieExpires "3 weeks"

CookieHTTPOnly 指令

說明	將「HTTPOnly」屬性新增至 Cookie
語法	`CookieHTTPOnly 開\|關`
預設值	`CookieHTTPOnly 關`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack
相容性	2.4.42 及更新版本

若設為「開」，「HTTPOnly」Cookie 屬性會新增至此模組的追蹤 Cookie。此屬性指示瀏覽器封鎖 JavaScript 讀取 Cookie 值。

CookieName 指令

說明	追蹤 Cookie 的名稱
語法	`CookieName 代碼`
預設值	`CookieName Apache`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack

此指令讓您可以變更此模組為其追蹤目的而使用的 Cookie 名稱。根據預設值，Cookie 名稱為「Apache」。

您必須指定有效的 Cookie 名稱；如果您使用包含異常字元的 Cookie 名稱，則結果難以預測。有效的字元包括 A-Z、a-z、0-9、「_」和「-」。

CookieName clicktrack

CookieSameSite 指令

說明	將「SameSite」屬性新增至 Cookie
語法	`CookieSameSite 無\|寬鬆\|嚴格`
預設值	`未設定`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack
相容性	2.4.42 及更新版本

若設為「無」、「寬鬆」或「嚴格」，「SameSite」Cookie 屬性會連同對應值新增至此模組的追蹤 Cookie。此屬性指示瀏覽器在跨網站內容中要求 Cookie 時的處理方式。

「無」值會設定「SameSite=無」，為最寬鬆的設定。若要省略此屬性，請完全省略該指令。

CookieSecure 指令

說明	將「Secure」屬性新增至 Cookie
語法	`CookieSecure 開\|關`
預設值	`CookieSecure 關`
內容	伺服器設定、虛擬主機、目錄、.htaccess
覆寫	FileInfo
狀態	擴充套件
模組	mod_usertrack
相容性	2.4.42 及更新版本

若設為「開」，「Secure」Cookie 屬性會新增至此模組的追蹤 Cookie。此屬性指示瀏覽器僅能透過 HTTPS 傳輸 Cookie。

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