acec79ac43dd662a4012d286a373108e43368778
[freeradius.git] / doc / ChangeLog
1 FreeRADIUS 2.1.7 Mon Sept 14 11:20:00 CEST 2009;  , urgency=medium
2         Feature improvements
3         * Full support for CoA and Disconnect packets as per RFC 3576
4           and RFC 5176.  Both receiving and proxying CoA is supported.
5         * Added "src_ipaddr" configuration to "home_server".  See
6           proxy.conf for details.
7         * radsniff now accepts -I, to read from a filename instead of
8           a device.
9         * radsniff also prints matching requests and any responses to those
10           requests when '-r' is used.
11         * Added example of attr_filter for Access-Challenge packets
12         * Added support for udpfromto in DHCP code
13         * radmin can now selectively mark modules alive/dead.
14           See "set module state".
15         * Added customizable messages on login success/fail.
16           See msg_goodpass && msg_badpass in log{} section of radiusd.conf
17         * Document "chase_referrals" and "rebind" in raddb/modules/ldap
18         * Preliminary implementation of DHCP relay.
19         * Made thread pool section optional.  If it doesn't exist,
20           the server will run single-threaded.
21         * Added sample radrelay.conf for people upgrading from 1.x
22         * Made proxying more stable by failing over, rather than
23           rejecting the first request.  See "response_window" in proxy.conf
24         * Allow home_server_pools to exist without realms.
25         * Add dictionary.iea (closes bug #7)
26         * Added support for RFC 5580
27         * Added experimental sql_freetds module from Gabriel Blanchard.
28         * Updated dictionary.foundry
29         * Added sample configuration for MySQL cluster in raddb/sql/ndb
30           See the README file for explanations.
31
32         Bug fixes
33         * Fixed corner case where proxied packets could have extra
34           character in User-Password attribute.  Fix from Niko Tyni.
35         * Extended size of "attribute" field in SQL to 64.
36         * Fixes to ruby module to be more careful about when it builds.
37         * Updated Perl module "configure" script to check for broken
38           Perl installations.
39         * Fix "status_check = none".  It would still send packets
40           in some cases.
41         * Set recursive flag on the proxy mutex, which enables safer
42           cleanup on some platforms.
43         * Copy the EAP username verbatim, rather than escaping it.
44         * Update handling so that robust-proxy-accounting works when
45           all home servers are down for extended periods of time.
46         * Look for DHCP option 53 anywhere in the packet, not just 
47           at the start.
48         * Fix processing of proxy fail handler with virtual servers.
49         * DHCP code now prints out correct src/dst IP addresses
50           when sending packets.
51         * Removed requirement for DHCP to have clients
52         * Fixed handling of DHCP packets with message-type buried in the packet
53         * Fixed corner case with negation in unlang.
54         * Minor fixes to default MySQL & PostgreSQL schemas
55         * Suppress MSCHAP complaints in debugging mode.
56         * Fix SQL module for multiple instance, and possible crash on HUP
57         * Fix permissions for radius.log for sites that change user/group,
58           but which don't create the file before starting radiusd.
59         * Fix double counting of packets when proxying
60         * Make %l work
61         * Fix pthread keys in rlm_perl
62         * Log reasons for EAP failure (closes bug #8)
63         * Load home servers and pools that aren't referenced from a realm.
64         * Handle return codes from virtual attributes in "unlang"
65           (e.g. LDAP-Group).  This makes "!(expr)" work for them.
66         * Enable VMPS to see contents of virtual server again
67         * Fix WiMAX module to be consistent with examples.  (closes bug #10)
68         * Fixed crash with policies dependent on NAS-Port comparisons
69         * Allowed vendor IDs to be be higher than 32767.
70         * Fix crash on startup with certain regexes in "hints" file.
71         * Fix crash in attr_filter module when packets don't exist
72         * Allow detail file reader to be faster when "load_factor = 100"
73         * Add work-around for build failures with errors related to
74           lt__PROGRAM__LTX_preloaded_symbols.  libltdl / libtool are horrible.
75         * Made ldap module "rebind" option aware of older, incompatible
76           versions of OpenLDAP.
77         * Check value of Fall-Through in attr_filter module.
78
79 FreeRADIUS 2.1.6 Mon May 18 10:00:00 CEST 2009;   urgency=medium
80         Feature improvements
81         * radclient exits with 0 on successful (accept / ack), and 1
82           otherwise (no response / reject)
83         * Added support for %{sql:UPDATE ..}, and insert/delete
84           Patch from Arran Cudbard-Bell
85         * Added sample "do not respond" policy.  See raddb/policy.conf
86           and raddb/sites-available/do_not_respond
87         * Cleanups to Suse spec file from Norbert Wegener
88         * New VSAs for Juniper from Bjorn Mork
89         * Include more RFC dictionaries in the default install
90         * More documentation for the WiMAX module
91         * Added "chase_referrals" and "rebind" configuration to rlm_ldap.
92           This helps with Active Directory.  See raddb/modules/ldap
93         * Don't load pre/post-proxy if proxying is disabled.
94         * Added %{md5:...}, which returns MD5 hash in hex.
95         * Added configurable "retry_interval" and "poll_interval"
96           for "detail" listeners.
97         * Added "delete_mppe_keys" configuration option to rlm_wimax.
98           Apparently some WiMAX clients misbehave when they see those keys.
99         * Added experimental rlm_ruby from
100           http://github.com/Antti/freeradius-server/tree/master
101         * Add Tunnel attributes to ldap.attrmap
102         * Enable virtual servers to be reloaded on HUP.  For now, only
103           the "authorize", "authenticate", etc. processing sections are
104           reloaded.  Clients and "listen" sections are NOT reloaded.
105         * Updated "radwatch" script to be more robust.  See scripts/radwatch
106         * Added certificate compatibility notes in raddb/certs/README,
107           for compatibility with different operating systems. (i.e. Windows)
108
109         Bug fixes
110         * Minor changes to allow building without VQP.
111         * Minor fixes from John Center
112         * Fixed raddebug example
113         * Don't crash when deleting attributes via unlang
114         * Be friendlier to very fast clients
115         * Updated the "detail" listener so that it only polls once,
116           and not many times in a row, leaking memory each time...
117         * Update comparison for Packet-Src-IP-Address (etc.) so that
118           the operators other than '==' work.
119         * Did autoconf magic to work around weird libtool bug
120         * Make rlm_perl keep tags for tagged attributes in more situations
121         * Update UID checking for radmin
122         * Added "include_length" field for TTLS.  It's needed for RFC
123           compliance, but not (apparently) for interoperability.
124
125 FreeRADIUS 2.1.5 Sun Jan 1 1:1:00 CEST 2009;  , urgency=medium
126         * Release number skipped due to procedural issues.
127         
128 FreeRADIUS 2.1.4 Tue Mar 10 17:05:00 CEST 2009;  , urgency=medium
129         Feature improvements
130         * Permit multiple "-e" in radmin.
131         * Add support for originating CoA-Request and Disconnect-Request.
132           See raddb/sites-available/originate-coa.
133         * Added "lifetime" and "max_queries" to raddb/sql.conf.
134           This helps address the problem of hung SQL sockets.
135         * Allow packets to be injected via radmin.  See "inject help"
136           in radmin.
137         * Answer VMPS reconfirmation request.  Patch from Hermann Lauer.
138         * Sample logrotate script in scripts/logrotate.freeradius
139         * Add configurable poll interval for "detail" listeners
140         * New "raddebug" command.  This prints debugging information from
141           a running server.  See "man raddebug.
142         * Add "require_message_authenticator" configuration to home_server
143           configuration.  This makes the server add Message-Authenticator
144           to all outgoing Access-Request packets.
145         * Added smsotp module, as contributed by Siemens.
146         * Enabled the administration socket in the default install.
147           See raddb/sites-available/control-socket, and "man radmin"
148         * Handle duplicate clients, such as with replicated or
149           load-balanced SQL servers and "readclients = yes"
150
151         Bug fixes
152         * Clean up control sockets when they are closed, so that we don't
153           leak memory.
154         * Define SUN_LEN for systems that don't have it.
155         * Correct some boundary conditions in the conditional checker ("if")
156           in "unlang".  Bug noted by Arran Cudbard-Bell.
157         * Work around minor building issues in gmake.  This should only
158           have affected developers.
159         * Change how we manage unprivileged user/group, so that we do not
160           create control sockets owned by root.
161         * Fixed more minor issues found by Coverity.
162         * Allow raddb/certs/bootstrap to run when there is no "make"
163           command installed.
164         * In radiusd.conf, run_dir depends on the name of the program,
165           and isn't hard-coded to "..../radiusd"
166         * Check for EOF in more places in the "detail" file reader.
167         * Added Freeswitch dictionary.
168         * Chop ethernet frames in VMPS, rather than droppping packets.
169         * Fix EAP-TLS bug.  Patch from Arnaud Ebalard
170         * Don't lose string for regex-compares in the "users" file.
171         * Expose more functions in rlm_sql to rlm_sqlippool, which 
172           helps on systems where RTLD_GLOBAL is off.
173         * Fix typos in MySQL schemas for ippools.
174         * Remove macro that was causing build issues on some platforms.
175         * Fixed issues with dead home servers.  Bug noted by Chris Moules.
176         * Fixed "access after free" with some dynamic clients.
177
178 FreeRADIUS 2.1.3 Fri Dec 5 17:40:00 CEST 2008;  , urgency=medium
179         Feature improvements
180         * Allow running with "user=radiusd" and binding to secure
181           sockets.
182         * Start sending Status-Server "are you alive" messages earlier,
183           which helps with proxying multiple realms to a home server.
184         * Removed thread pool code from rlm_perl.  It's not necessary.
185         * Added example Perl configuration to raddb/modules/perl
186         * Force OpenSSL to support certificates with SHA256.
187           This seems to be necessary for WiMAX certs.
188
189         Bug fixes
190         * Fix Debian patch to allow it to build.
191         * Fix potential NULL dereference in debugging mode on certain
192           platforms for TTLS and PEAP inner tunnels.
193         * Fix uninitialized memory in handling of vendor definitions
194         * Fix parsing of quoted (but non-string) attributes in the "users"
195           file.
196         * Initialize uknown NAS IP to 255.255.255.255, rather than 0.0.0.0
197         * use SUN_LEN in control socket, to avoid truncation on some
198           platforms.
199         * Correct internal handling of "debug condition" to prevent it
200           from being over-written.
201         * Check return code of regcomp in "unlang", so that invalid
202           regular expressions are caught rather than mishandled.
203         * Make rlm_sql use <ltdl.h>.  Addresses bug #610.
204         * Document list "type = status" better.  Closes bug #580.
205         * Set "default days" for certificates, because OpenSSL won't
206           do it.  This closes bug #615.
207         * Reference correct list in example raddb/modules/ldap.
208           Closes #596.
209         * Increase default schema size for Acct-Session-Id to 64.
210           Closes #540.
211         * Fix use of temporary files in dialup-admin.  Closes #605
212           and addresses CVE-2008-4474.
213         * Addressed a number of minor issues found by Coverity.
214         * Added DHCP option 150 to the dictionary.  Closes #618.
215
216 FreeRADIUS 2.1.2 Thurs Dec 3 10:47:00 CEST 2008;  , urgency=medium
217         Due to packaging issues, 2.1.2 has been pulled from the net.
218
219 FreeRADIUS 2.1.1 Thu Sep 25 11:03:00 CEST 2008;  , urgency=medium
220         Feature improvements
221         * Many more options and features in radmin.  See "man radmin" and
222           raddb/sites-available/control-socket
223         * Many more commands available via the control socket.  Connect
224           via "radmin", and type "help" for more information.
225         * Added dictionary.networkphysics and dictionary.lancom.
226         * Calculate WiMAX MIP keys, and added sample WiMAX SQL tables.
227
228         Bug fixes
229         * Fixed bug that made radmin not work
230         * Fixed Suse && Debian package scripts
231         * Fixed issues with dynamic clients
232         * Fixed configure checks for -lreadline
233         * rlm_sqlippool no longer needs to be linked to rlm_sql.
234         * Add statistics for detail file listeners.  This closes bug #593.
235         * Fixed printing of some WiMAX attributes.
236         * Fix double free on exit() in rlm_attr_filter
237         * Fixed build issues on Solaris.
238         * Fixed fast session resumption for EAP-TLS
239
240 FreeRADIUS 2.1.0 Fri Sep  5 13:20:01 CEST 2008;  , urgency=medium
241         Feature improvements
242         * Clients may now be defined dynamically, based on IP address.
243           See raddb/sites-available/dynamic-clients.
244         * SNMP support is now available through an experimental Perl script.
245           See scripts/snmp-proxy/README
246         * SNMP statistics are available through Status-Server packets.
247           See raddb/sites-available/status
248         * Added more Microsoft attributes from bug #568.
249         * The "linelog" module has more functionality and flexibility.
250           See raddb/modules/linelog.
251         * The debugging output has been sanitized.  It should be much
252           more readable.
253         * Debug logs can now be turned on/off while the server is running, for
254           a user, group, realm, etc.  See the "log" section of radiusd.conf.
255         * Added support for WiMAX Forum attributes.  The dynamic keys
256           are not yet calculated.  See share/dictionary.wimax
257         * Added session resumption for PEAP and TTLS.
258           See raddb/eap.conf, "cache" sub-section.
259         * Added "radmin" command-line tool for administering a running server.
260           See "man radmin" and raddb/sites-available/control-socket.
261
262         Bug fixes
263         * Double escaping of '\\' in the "users" (and some other) files
264           has been fixed.  If you have '\\' in the "users" file, your
265           configuration WILL NEED TO BE CHECKED, AND FIXED!
266         * Parse "security" section in radiusd.conf.  This was accidentally
267           deleted in 2.0.5.  Closes bug #566.
268         * Bind to interface before IP, which allows DHCP sockets to
269           listen on "*" for multiple interfaces.
270         * Fix handling of giaddr in DHCP responses.
271         * Corrected parsing of status_check in home_server so that it works.
272         * Fix hints so that "Puser" works again.
273         * Removed length restrictions on attribute names in the dictionaries.
274         * Update socket code to avoid C compiler optimizations.
275
276 FreeRADIUS 2.0.5 ; Date: 2008/06/07 17:17:00 , urgency=medium
277         Feature improvements
278         * Permit SQL authorize_reply_query to be empty.
279         * Allow setting response packet type in Post-Proxy-Type Fail
280           handler.
281         * Added install-chown target to set correct permission and ownership
282           make RADMIN=radmin RGROUP=radius install-chown
283         * Support for LDAP-Group and other dynamic comparison attributes
284           in unlang.  Developed from a patch by Jason Alderfer.
285         * Added chroot support.  See radiusd.conf for comments.
286         * Allow clients of 0/0.  We do not recommend using this, though.
287         * Moved many module configurations into raddb/modules/*
288         
289         Bug fixes
290         * Allow proxying to virtual servers for accounting packets, too.
291         * Added "num fields" function to PostgreSQL client.
292         * Updated proxy fallback mechanism to validate fallback servers,
293           and to process fallback requests in a child thread.
294         * rlm_realm returns "ok" for LOCAL realms, not "noop".
295         * Fixed some DHCP code handling.  The examples should now work.
296
297 FreeRADIUS 2.0.4 ; Date: 2008/04/30 08:56:40  , urgency=medium
298         Feature improvements
299         * Allow "virtual_server" in "realm" and "home_server" sections.
300           See raddb/proxy.conf and raddb/sites-available/virtual.example.com.
301         * Allow "passwd" module to be listed in "accounting" and "post-auth".
302         * Added "fallback" to "home_server_pool" configuration, to handle
303           the case of all home servers being dead.  See raddb/proxy.conf.
304         * Added sample text to raddb/sites-available/inner-tunnel which
305           can simplify debugging of inner tunnel configurations.
306         * Added regular expression matching in realm names.  See
307           raddb/proxy.conf for examples.
308         * Added simple DHCP server functionality.  For comments, see
309           raddb/sites-available/dhcp.
310         * Added file globbing capabilities to detail file reader
311         * Added sample raddb/sites-available/robust-proxy-accounting
312         * Clients in SQL can now refer to a virtual server.
313           Patch from Michael Bretterklieber.
314         * Added some examples of creating RADIUS administrator in SQL,
315           and assigning appropriate access rights.
316         
317         Bug fixes
318         * Install all files in raddb/sites-available
319         * Allow non-threaded builds.
320         * Don't treat '0x' as special for known attributes that are not
321           of type "octets".
322         * Fix log error in rlm_pap.
323         * Remove documentation about non-existent functionality.
324         * Updated warning messages in debug output.
325         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
326           This fix was supposed to go into 2.0.3, but did not make it.
327         * Fix event handling in debug mode for failed proxy requests.
328         * Fix memleak in fifos.  Closes #537.
329         * Fix memleak on blocked threads.  Closes #538.
330         * Perform additional checks on NULL realms.  Closes #541.
331         * Fix handling of "clients" in "listen" section.
332         * When detail file cannot process a packet, sleep for longer
333           to let the rest of the server do something.
334         * Add missing table to raddb/sql/mssql/schema.sql.  Closes #545.
335         * Updated rlm_sql_postgresql to build with PostgreSQL 7.x. 
336           Closes #533.
337         * Fix "postauth" of rlm_ldap to look for LDAP-UserDn in the
338           correct place.
339         * Update rlm_attr_filter for some corner cases.  Closes #543.
340         * Fixed memory leak in libfreeradius event handler.
341         * In the SQL Accounting on/off queries, remove the restriction
342           that the session time had to be zero.
343         
344 FreeRADIUS 2.0.3 ; Date: 2008/03/17 09:22:17  , urgency=medium
345         Feature improvements
346         * Updated raddb/certs/ca.cnf with extensions to allow ca.der
347           to be imported as a CA on Symbian and Windows Mobile devices.
348           Closes bug #524
349         * Enable multiple matches in "hints" via Fall-Through = Yes.
350           Closes bug #477
351         * Added preliminary SQLite driver, contibuted by Apple.
352           Untested, with no sample configuration.  This address bug #470.
353         * Updated logging sub-system so that log messages from libfreeradius
354           can go to the log file, and not stdout.
355         * Added dictionary.rfc5176
356         * EAP module now checks for instance name, and uses that for
357           authentication.  This avoids the need to set Auth-Type when
358           there are multiple instances of the EAP module.
359         * Added Module-Return-Code attribute, which contains the value
360           returned by the previous module (ok/fail/update/etc.)
361
362         Bug fixes
363         * Corrected typos in rlm_dbm.  Closes bugs #521 and #522.
364         * Detail file "listen" sections now work much better.
365         * Don't allow old "log_*" to over-ride new format.  Closes bug #525
366         * Initialize allocated memory in Oracle SQL driver.  This fixes
367           occasional crashes on some systems.  Closes bug #518
368         * Call correct function in rlm_protocol_filter.  This enables the
369           module to build.  Closes bug #512.
370         * Added deprecated flag to build for rlm_krb5.  This allows it to
371           run on 64-bit systems.  Closes bug #491
372         * Corrected error message when parsing invalid configurations
373           so it doesn't crash.  Closes bug #527
374         * Fix handling of timeouts in rlm_ldap that affected 64-bit systems.
375         * Handle $INCLUDE's in "instantiate" section.  Closes #528.
376         * Format updates to "man" pages from Stephen Gran.
377
378 FreeRADIUS 2.0.2 ; Date: 2008/02/14 11:13:48  , urgency=medium
379         Feature improvements
380         * Added notes on how to debug the server in radiusd.conf
381         * Moved all "log_*" in radiusd.conf to log{} section.
382           The old configurations are still accepted, though.
383         * Added ca.der target in raddb/certs/Makefile.  This is
384           needed for importing CA certs into Windows.
385         * Added ability send raw attributes via "Raw-Attribute = 0x0102..."
386           This is available only debug builds.  It can be used
387           to create invalid packets! Use it with care.
388         * Permit "unlang" policies inside of Auth-Type{} sub-sections
389           of the authenticate{} section.  This makes some policies easier
390           to implement.
391         * "listen" sections can now have "type = proxy".  This lets you
392           control which IP is used for sending proxied requests.
393         * Added note on SSL performance to raddb/certs/README
394
395         Bug fixes
396         * Fixed reading of "detail" files.
397         * Allow inner EAP tunneled sessions to be proxied.
398         * Corrected MySQL schemas
399         * syslog now works in log{} section.
400         * Corrected typo in raddb/certs/client.cnf
401         * Updated raddb/sites-available/proxy-inner-tunnel to
402           permit authentication to work.
403         * Ignore zero-length attributes in received packets.
404         * Correct memcpy when dealing with unknown attributes.
405         * Corrected debugging messages in attr_rewrite.
406         * Corrected generation of State attribute in EAP.  This
407           fixes the "failed to remember handler" issues.
408         * Fall back to DEFAULT realm if no realm was found.
409           Based on a patch from Vincent Magnin.
410         * Updated example raddb/sites-available/proxy-inner-tunnel
411         * Corrected behavior of attr_filter to match documentation.
412           This is NOT backwards compatible with previous versions!
413           See "man rlm_attr_filter" for details.
414
415 FreeRADIUS 2.0.1 ; Date: 2008/01/22 13:29:37  , urgency=low
416         Feature improvements
417         * "unlang" has been expanded to do less run-time expansion,
418           and to have better handling of typed data.  See "man unlang"
419           for documentation and new examples.
420         
421         Bug fixes
422         * The 'acct_unique' module has been updated to understand
423           the deprecated (but still used) Client-IP-Address attribute.
424         * The EAP-MSCHAPv2 module no longer leaks MS-CHAP2-Success in
425           packets.
426         * Fixed crash in rlm_dbm.
427         * Fixed parsing of syslog configuration.
428
429 FreeRADIUS 2.0.0 ; Date: 2007/11/24 08:33:09 , urgency=low
430         Feature improvements
431         * Debugging mode is much clearer and easier to read.
432         * A new policy language makes many configurations trivial.
433           See "man unlang" for a complete description.
434         * Virtual servers are now supported.  This permits clear separation
435           of policies.  See raddb/sites-available/README
436         * EAP-TLS (PEAP, EAP-TTLS) and OpenSSL certificates "just work".
437           See raddb/certs/README for details.
438         * Proxying is much more configurable than before.
439           See proxy.conf for documentation on pools, and new config items.
440         * Full support for IPv6.
441         * Much more complete support for the RADIUS SNMP MIBs.
442         * HUP now works.  Only some modules are re-loaded,
443           and the server configuation is *not* reloaded.
444         * "check config" option now works.  See "man radiusd"
445         * radrelay functionality is now included in the server core.
446           See raddb/sites-available/copy-acct-to-home-server
447         * VMPS support.  It is minimal, but functional.
448         * Cleaned up internal API's and names, including library names.
449         
450         Bug fixes
451         * Many.