squid_session(8)

1squid_session(8)            System Manager's Manual           squid_session(8)
2
3
4

NAME

6       squid_session - Squid session tracking external acl group helper
7

SYNOPSIS

9       squid_session [-t idle_timeout] [-b dbpath] [-a]
10

DESCRIPTION

12       This  helper maintains a concept of sessions by monitoring requests and
13       timing out sessions if no requests have been seen for the idle  timeout
14       timer.
15
16       Intended use is for displaying "terms of use" pages, ad popups etc.
17
18       -t idletimeout (default 3600)
19              Specifies the session idle timeout timer.
20
21       -b dbpath
22              Path  to  persistent  database.  If  not  specified  the session
23              details will be kept in memory only and all sessions will  reset
24              each time Squid restarts it's helpers (Squid restart or rotation
25              of logs).
26
27       -a     Active mode. In this mode sessions are started by evaluating  an
28              acl  with  the  argument  LOGIN,  or  terminated by the argument
29              LOGOUT.
30
31       Without this flag the helper automatically starts the session after the
32       first request.
33

EXAMPLE

35       Configuration example using the default automatic mode
36
37              external_acl_type session ttl=300 negative_ttl=0 children=1 con‐
38              currency=200 %LOGIN /usr/local/squid/libexec/squid_session
39
40              acl session external session
41
42              http_access deny !session
43
44              deny_info http://your.server/bannerpage?url=%s session
45
46       Then set up http://your.server/bannerpage to display a session  startup
47       page  and then redirect the user back to the requested URL given in the
48       url query parameter.
49

AUTHOR

51       This helper and documentation was written  by  Henrik  Nordstrom  <hen‐
52       rik@henriknordstrom.net>
53

QUESTIONS

55       Any  questions  on usage can be sent to Squid Users <squid-users@squid-
56       cache.org>.
57

REPORTING BUGS

59       Report bugs or bug-fixes to Squid Bugs <squid-bugs@squid-cache.org>  or
60       ideas  for  new  improvements  to  Squid  Developers  <squid-dev@squid-
61       cache.org>
62