man/man5/rlm_acct_unique.5

   1 .TH rlm_acct_unique 5 "3 February 2004" "" "FreeRADIUS Module"
   2 .SH NAME
   3 rlm_acct_unique \- FreeRADIUS Module
   4 .SH DESCRIPTION
   5 The \fIrlm_acct_unique\fP module creates a unique accounting session
   6 Id.
   7 .PP
   8 Many NAS vendors have their equipment supply an Acct-Session-Id
   9 attribute which is not unique over reboots.  This makes accounting
  10 difficult, as there will be many independent sessions with the same
  11 Acct-Session-Id attribute.  This module uses the Acct-Session-Id
  12 attribute, along with other attributes in the request, to create a
  13 more unique session ID, called Acct-Unique-Session-Id.
  14 .PP
  15 The main configuration items to be aware of are:
  16 .IP key
  17 A list of the attributes used in calculating an MD5 hash which is used
  18 as the value for the unique session id.
  19 .SH CONFIGURATION
  20 .DS
  21 modules {
  22   ...
  23 .br
  24   acct_unique {
  25 .br
  26         key = "User-Name, Acct-Session-Id, NAS-IP-Address, NAS-Port"
  27 .br
  28   }
  29 .br
  30   ...
  31 .br
  32 }
  33 .br
  34  ...
  35 .br
  36 preacct {
  37   ...
  38 .br
  39   acct_unique
  40   ...
  41 .br
  42 }
  43 .DE
  44 .PP
  45 After generating the MD5 hash, the module adds it to the accounting
  46 request packet received from the client.  It will look something like
  47 this in your detail file:
  48 .PP
  49 .DS
  50         Acct-Unique-Session-Id = "c66ef57e480b9d26"
  51 .DE
  52 .PP
  53 NOTE:  Any attribute you specify that is not found in the 'dictionary'
  54 file will cause the server to fail and exit with an error.
  55 .PP
  56 NOTE:  If you want the Acct-Unique-Session-Id of the Start and the
  57 Stop packet of a particular session to match, you must use values for
  58 the key that will stay the same for the Start and Stop.  The above
  59 example is a good start.  Adding 'Acct-Session-Time', for example, would
  60 cause a mismatch because that value is not the same on the Start and
  61 Stop accounting packets.
  62 .PP
  63 .SH SECTIONS
  64 .BR authorization,
  65 .BR pre-accounting,
  66 .BR accounting
  67 .PP
  68 .SH FILES
  69 .I /etc/raddb/radiusd.conf
  70 .PP
  71 .SH "SEE ALSO"
  72 .BR radiusd (8),
  73 .BR radiusd.conf (5)
  74 .SH AUTHORS
  75 Chris Parker, cparker@segv.org