_updown inserts routes only if a sourceip is defined
[strongswan.git] / NEWS
1 strongswan-4.1.4
2 ----------------
3
4 - The pluto IKEv1 daemon now exhibits the same behaviour as its
5   IKEv2 companion charon by inserting an explicit route via the
6   _updown script only if a sourceip exists. This is admissible
7   since routing through the IPsec tunnel is handled automatically
8   by NETKEY's IPsec policies..
9   
10
11 strongswan-4.1.3
12 ----------------
13
14 - IKEv2 peer configuration selection now can be based on a given 
15   certification authority using the rightca= statement.
16
17 - IKEv2 authentication based on RSA signatures now can handle multiple
18   certificates issued for a given peer ID. This allows a smooth transition
19   in the case of a peer certificate renewal.
20
21 - IKEv2: Support for requesting a specific virtual IP using leftsourceip on the
22   client and returning requested virtual IPs using rightsourceip=%config
23   on the server. If the server does not support configuration payloads, the
24   client enforces its leftsourceip parameter.
25
26 - The ./configure options --with-uid/--with-gid allow pluto and charon
27   to drop their privileges to a minimum and change to an other UID/GID. This
28   improves the systems security, as a possible intruder may only get the
29   CAP_NET_ADMIN capability.
30
31 - Further modularization of charon: Pluggable control interface and 
32   configuration backend modules provide extensibility. The control interface
33   for stroke is included, and further interfaces using DBUS (NetworkManager)
34   or XML are on the way. A backend for storing configurations in the daemon
35   is provided and more advanced backends (using e.g. a database) are trivial 
36   to implement.
37
38  - Fixed a compilation failure in libfreeswan occuring with Linux kernel
39    headers > 2.6.17.
40
41
42 strongswan-4.1.2
43 ----------------
44
45 - Support for an additional Diffie-Hellman exchange when creating/rekeying
46   a CHILD_SA in IKEv2 (PFS). PFS is enabled when the proposal contains a
47   DH group (e.g. "esp=aes128-sha1-modp1536"). Further, DH group negotiation
48   is implemented properly for rekeying.
49
50 - Support for the AES-XCBC-96 MAC algorithm for IPsec SAs when using IKEv2
51   (requires linux >= 2.6.20). It is enabled using e.g. "esp=aes256-aesxcbc".
52
53 - Working IPv4-in-IPv6 and IPv6-in-IPv4 tunnels for linux >= 2.6.21.
54
55 - Added support for EAP modules which do not establish an MSK.
56
57 - Removed the dependencies from the /usr/include/linux/ headers by
58   including xfrm.h, ipsec.h, and pfkeyv2.h in the distribution.
59   
60 - crlNumber is now listed by ipsec listcrls
61
62 - The xauth_modules.verify_secret() function now passes the
63   connection name.
64
65
66 strongswan-4.1.1
67 ----------------
68
69 - Server side cookie support. If to may IKE_SAs are in CONNECTING state,
70   cookies are enabled and protect against DoS attacks with faked source
71   addresses. Number of IKE_SAs in CONNECTING state is also limited per
72   peer address to avoid resource exhaustion. IKE_SA_INIT messages are
73   compared to properly detect retransmissions and incoming retransmits are
74   detected even if the IKE_SA is blocked (e.g. doing OCSP fetches).
75
76 - The IKEv2 daemon charon now supports dynamic http- and ldap-based CRL
77   fetching enabled by crlcheckinterval > 0 and caching fetched CRLs
78   enabled by cachecrls=yes.
79
80 - Added the configuration options --enable-nat-transport which enables
81   the potentially insecure NAT traversal for IPsec transport mode and
82   --disable-vendor-id which disables the sending of the strongSwan
83   vendor ID.
84
85 - Fixed a long-standing bug in the pluto IKEv1 daemon which caused
86   a segmentation fault if a malformed payload was detected in the
87   IKE MR2 message and pluto tried to send an encrypted notification
88   message.
89
90 - Added the NATT_IETF_02_N Vendor ID in order to support IKEv1 connections
91   with Windows 2003 Server which uses a wrong VID hash.
92
93
94 strongswan-4.1.0
95 ----------------
96
97 - Support of SHA2_384 hash function for protecting IKEv1
98   negotiations and support of SHA2 signatures in X.509 certificates.
99
100 - Fixed a serious bug in the computation of the SHA2-512 HMAC
101   function. Introduced automatic self-test of all IKEv1 hash
102   and hmac functions during pluto startup. Failure of a self-test
103   currently issues a warning only but does not exit pluto [yet].
104
105 - Support for SHA2-256/384/512 PRF and HMAC functions in IKEv2.
106
107 - Full support of CA information sections. ipsec listcainfos
108   now shows all collected crlDistributionPoints and OCSP 
109   accessLocations.
110
111 - Support of the Online Certificate Status Protocol (OCSP) for IKEv2.
112   This feature requires the HTTP fetching capabilities of the libcurl
113   library which must be enabled by setting the --enable-http configure
114   option.
115
116 - Refactored core of the IKEv2 message processing code, allowing better
117   code reuse and separation.
118
119 - Virtual IP support in IKEv2 using INTERNAL_IP4/6_ADDRESS configuration
120   payload. Additionally, the INTERNAL_IP4/6_DNS attribute is interpreted
121   by the requestor and installed in a resolv.conf file.
122
123 - The IKEv2 daemon charon installs a route for each IPsec policy to use
124   the correct source address even if an application does not explicitly
125   specify it.
126
127 - Integrated the EAP framework into charon which loads pluggable EAP library
128   modules. The ipsec.conf parameter authby=eap initiates EAP authentication
129   on the client side, while the "eap" parameter on the server side defines
130   the EAP method to use for client authentication.
131   A generic client side EAP-Identity module and an EAP-SIM authentication
132   module using a third party card reader implementation are included.
133
134 - Added client side support for cookies.
135
136 - Integrated the fixes done at the IKEv2 interoperability bakeoff, including
137   strict payload order, correct INVALID_KE_PAYLOAD rejection and other minor
138   fixes to enhance interoperability with other implementations.
139
140
141 strongswan-4.0.7
142 ----------------
143
144 - strongSwan now interoperates with the NCP Secure Entry Client,
145   the Shrew Soft VPN Client, and the Cisco VPN client, doing both
146   XAUTH and Mode Config.
147
148 - UNITY attributes are now recognized and UNITY_BANNER is set
149   to a default string.
150
151
152 strongswan-4.0.6
153 ----------------
154
155 - IKEv1: Support for extended authentication (XAUTH) in combination
156   with ISAKMP Main Mode RSA or PSK authentication. Both client and
157   server side were implemented. Handling of user credentials can
158   be done by a run-time loadable XAUTH module. By default user
159   credentials are stored in ipsec.secrets. 
160           
161 - IKEv2: Support for reauthentication when rekeying
162
163 - IKEv2: Support for transport mode
164
165 - fixed a lot of bugs related to byte order
166
167 - various other bugfixes
168
169
170 strongswan-4.0.5
171 ----------------
172
173 - IKEv1: Implementation of ModeConfig push mode via the new connection
174   keyword modeconfig=push allows interoperability with Cisco VPN gateways.
175
176 - IKEv1: The command ipsec statusall now shows "DPD active" for all
177   ISAKMP SAs that are under active Dead Peer Detection control.
178
179 - IKEv2: Charon's logging and debugging framework has been completely rewritten.
180   Instead of logger, special printf() functions are used to directly
181   print objects like hosts (%H) identifications (%D), certificates (%Q),
182   etc. The number of debugging levels have been reduced to:
183
184     0 (audit), 1 (control), 2 (controlmore),  3 (raw), 4 (private)
185
186   The debugging levels can either be specified statically in ipsec.conf as
187
188     config setup
189            charondebug="lib 1, cfg 3, net 2"
190
191   or changed at runtime via stroke as
192
193     ipsec stroke loglevel cfg 2
194
195
196 strongswan-4.0.4
197 ----------------
198
199 - Implemented full support for IPv6-in-IPv6 tunnels.
200
201 - Added configuration options for dead peer detection in IKEv2. dpd_action
202   types "clear", "hold" and "restart" are supported. The dpd_timeout
203   value is not used, as the normal retransmission policy applies to
204   detect dead peers. The dpd_delay parameter enables sending of empty
205   informational message to detect dead peers in case of inactivity.
206
207 - Added support for preshared keys in IKEv2. PSK keys configured in
208   ipsec.secrets are loaded. The authby parameter specifies the authentication
209   method to authentificate ourself, the other peer may use PSK or RSA.
210
211 - Changed retransmission policy to respect the keyingtries parameter.
212
213 - Added private key decryption. PEM keys encrypted with AES-128/192/256
214   or 3DES are supported.
215
216 - Implemented DES/3DES algorithms in libstrongswan. 3DES can be used to
217   encrypt IKE traffic.
218
219 - Implemented SHA-256/384/512 in libstrongswan, allows usage of certificates
220   signed with such a hash algorithm.
221
222 - Added initial support for updown scripts. The actions up-host/client and
223   down-host/client are executed. The leftfirewall=yes parameter
224   uses the default updown script to insert dynamic firewall rules, a custom
225   updown script may be specified with the leftupdown parameter.
226
227
228 strongswan-4.0.3
229 ----------------
230
231 - Added support for the auto=route ipsec.conf parameter and the
232   ipsec route/unroute commands for IKEv2. This allows to set up IKE_SAs and 
233   CHILD_SAs dynamically on demand when traffic is detected by the 
234   kernel.
235
236 - Added support for rekeying IKE_SAs in IKEv2 using the ikelifetime parameter.
237   As specified in IKEv2, no reauthentication is done (unlike in IKEv1), only
238   new keys are generated using perfect forward secrecy. An optional flag
239   which enforces reauthentication will be implemented later.
240
241 - "sha" and "sha1" are now treated as synonyms in the ike= and esp=
242   algorithm configuration statements.
243
244
245 strongswan-4.0.2
246 ----------------
247
248 - Full X.509 certificate trust chain verification has been implemented.
249   End entity certificates can be exchanged via CERT payloads. The current
250   default is leftsendcert=always, since CERTREQ payloads are not supported
251   yet. Optional CRLs must be imported locally into /etc/ipsec.d/crls.
252
253 - Added support for leftprotoport/rightprotoport parameters in IKEv2. IKEv2 
254   would offer more possibilities for traffic selection, but the Linux kernel
255   currently does not support it. That's why we stick with these simple 
256   ipsec.conf rules for now.
257
258 - Added Dead Peer Detection (DPD) which checks liveliness of remote peer if no
259   IKE or ESP traffic is received. DPD is currently hardcoded (dpdaction=clear,
260   dpddelay=60s).
261
262 - Initial NAT traversal support in IKEv2. Charon includes NAT detection
263   notify payloads to detect NAT routers between the peers. It switches
264   to port 4500, uses UDP encapsulated ESP packets, handles peer address
265   changes gracefully and sends keep alive message periodically.
266
267 - Reimplemented IKE_SA state machine for charon, which allows simultaneous 
268   rekeying, more shared code, cleaner design, proper retransmission 
269   and a more extensible code base.
270
271 - The mixed PSK/RSA roadwarrior detection capability introduced by the
272   strongswan-2.7.0 release necessitated the pre-parsing of the IKE proposal
273   payloads by the responder right before any defined IKE Main Mode state had
274   been established. Although any form of bad proposal syntax was being correctly
275   detected by the payload parser, the subsequent error handler didn't check
276   the state pointer before logging current state information, causing an
277   immediate crash of the pluto keying daemon due to a NULL pointer.
278
279
280 strongswan-4.0.1
281 ----------------
282
283 - Added algorithm selection to charon: New default algorithms for 
284   ike=aes128-sha-modp2048, as both daemons support it. The default
285   for IPsec SAs is now esp=aes128-sha,3des-md5. charon handles
286   the ike/esp parameter the same way as pluto. As this syntax does
287   not allow specification of a pseudo random function, the same 
288   algorithm as for integrity is used (currently sha/md5). Supported
289   algorithms for IKE:
290     Encryption: aes128, aes192, aes256
291     Integrity/PRF: md5, sha (using hmac)
292     DH-Groups: modp768, 1024, 1536, 2048, 4096, 8192
293   and for ESP:
294     Encryption: aes128, aes192, aes256, 3des, blowfish128, 
295                 blowfish192, blowfish256
296     Integrity: md5, sha1
297   More IKE encryption algorithms will come after porting libcrypto into
298   libstrongswan. 
299
300 - initial support for rekeying CHILD_SAs using IKEv2. Currently no
301   perfect forward secrecy is used. The rekeying parameters rekey,
302   rekeymargin, rekeyfuzz and keylife from ipsec.conf are now supported
303   when using IKEv2. WARNING: charon currently is unable to handle
304   simultaneous rekeying. To avoid such a situation, use a large
305   rekeyfuzz, or even better, set rekey=no on one peer.
306
307 - support for host2host, net2net, host2net (roadwarrior) tunnels
308   using predefined RSA certificates (see uml scenarios for
309   configuration examples).
310
311 - new build environment featuring autotools. Features such
312   as HTTP, LDAP and smartcard support may be enabled using
313   the ./configure script. Changing install directories 
314   is possible, too. See ./configure --help for more details.
315
316 - better integration of charon with ipsec starter, which allows
317   (almost) transparent operation with both daemons. charon
318   handles ipsec commands up, down, status, statusall, listall,
319   listcerts and allows proper load, reload and delete of connections
320   via ipsec starter.
321
322
323 strongswan-4.0.0
324 ----------------
325
326 - initial support of the IKEv2 protocol. Connections in
327   ipsec.conf designated by keyexchange=ikev2 are negotiated 
328   by the new IKEv2 charon keying daemon whereas those marked
329   by keyexchange=ikev1 or the default keyexchange=ike are
330   handled thy the IKEv1 pluto keying daemon. Currently only
331   a limited subset of functions are available with IKEv2
332   (Default AES encryption, authentication based on locally
333   imported X.509 certificates, unencrypted private RSA keys
334   in PKCS#1 file format, limited functionality of the ipsec
335   status command).
336
337
338 strongswan-2.7.0
339 ----------------
340
341 - the dynamic iptables rules from the _updown_x509 template
342   for KLIPS and the _updown_policy template for NETKEY have
343   been merged into the default _updown script. The existing
344   left|rightfirewall keyword causes the automatic insertion
345   and deletion of ACCEPT rules for tunneled traffic upon
346   the successful setup and teardown of an IPsec SA, respectively.
347   left|rightfirwall can be used with KLIPS under any Linux 2.4
348   kernel or with NETKEY under a Linux kernel version >= 2.6.16
349   in conjuction with iptables >= 1.3.5. For NETKEY under a Linux
350   kernel version < 2.6.16 which does not support IPsec policy
351   matching yet, please continue to use a copy of the _updown_espmark
352   template loaded via the left|rightupdown keyword.
353
354 - a new left|righthostaccess keyword has been introduced which
355   can be used in conjunction with left|rightfirewall and the
356   default _updown script. By default leftfirewall=yes inserts
357   a bi-directional iptables FORWARD rule for a local client network
358   with a netmask different from 255.255.255.255 (single host).
359   This does not allow to access the VPN gateway host via its
360   internal network interface which is part of the client subnet
361   because an iptables INPUT and OUTPUT rule would be required.
362   lefthostaccess=yes will cause this additional ACCEPT rules to
363   be inserted. 
364
365 - mixed PSK|RSA roadwarriors are now supported. The ISAKMP proposal
366   payload is preparsed in order to find out whether the roadwarrior
367   requests PSK or RSA so that a matching connection candidate can
368   be found.
369
370
371 strongswan-2.6.4
372 ----------------
373
374 - the new _updown_policy template allows ipsec policy based
375   iptables firewall rules. Required are iptables version
376   >= 1.3.5 and linux kernel >= 2.6.16. This script obsoletes
377   the _updown_espmark template, so that no INPUT mangle rules 
378   are required any more.
379
380 - added support of DPD restart mode
381
382 - ipsec starter now allows the use of wildcards in include
383   statements as e.g. in "include /etc/my_ipsec/*.conf".
384   Patch courtesy of Matthias Haas.
385
386 - the Netscape OID 'employeeNumber' is now recognized and can be
387   used as a Relative Distinguished Name in certificates.
388
389
390 strongswan-2.6.3
391 ----------------
392
393 - /etc/init.d/ipsec or /etc/rc.d/ipsec is now a copy of the ipsec 
394   command and not of ipsec setup any more.
395
396 - ipsec starter now supports AH authentication in conjunction with
397   ESP encryption. AH authentication is configured in ipsec.conf
398   via the auth=ah parameter.
399   
400 - The command ipsec scencrypt|scdecrypt <args> is now an alias for
401   ipsec whack --scencrypt|scdecrypt <args>.
402
403 - get_sa_info() now determines for the native netkey IPsec stack
404   the exact time of the last use of an active eroute. This information
405   is used by the Dead Peer Detection algorithm and is also displayed by
406   the ipsec status command.
407   
408
409 strongswan-2.6.2
410 ----------------
411
412 - running under the native Linux 2.6 IPsec stack, the function
413   get_sa_info() is called by ipsec auto --status to display the current
414   number of transmitted bytes per IPsec SA.
415
416 - get_sa_info() is also used  by the Dead Peer Detection process to detect
417   recent ESP activity. If ESP traffic was received from the peer within
418   the last dpd_delay interval then no R_Y_THERE notification must be sent.
419
420 - strongSwan now supports the Relative Distinguished Name "unstructuredName"
421   in ID_DER_ASN1_DN identities. The following notations are possible:
422
423     rightid="unstructuredName=John Doe"
424     rightid="UN=John Doe"
425
426 - fixed a long-standing bug which caused PSK-based roadwarrior connections
427   to segfault in the function id.c:same_id() called by keys.c:get_secret()
428   if an FQDN, USER_FQDN, or Key ID was defined, as in the following example.
429
430   conn rw
431        right=%any
432        rightid=@foo.bar
433        authby=secret
434
435 - the ipsec command now supports most ipsec auto commands (e.g. ipsec listall).
436
437 - ipsec starter didn't set host_addr and client.addr ports in whack msg.
438
439 - in order to guarantee backwards-compatibility with the script-based
440   auto function (e.g. auto --replace), the ipsec starter scripts stores
441   the defaultroute information in the temporary file /var/run/ipsec.info.
442
443 - The compile-time option USE_XAUTH_VID enables the sending of the XAUTH
444   Vendor ID which is expected by Cisco PIX 7 boxes that act as IKE Mode Config
445   servers.
446
447 - the ipsec starter now also recognizes the parameters authby=never and
448   type=passthrough|pass|drop|reject.
449
450
451 strongswan-2.6.1
452 ----------------
453
454 - ipsec starter now supports the also parameter which allows
455   a modular structure of the connection definitions. Thus
456   "ipsec start" is now ready to replace "ipsec setup".
457
458
459 strongswan-2.6.0
460 ----------------
461
462 - Mathieu Lafon's popular ipsec starter tool has been added to the
463   strongSwan distribution. Many thanks go to Stephan Scholz from astaro
464   for his integration work. ipsec starter is a C program which is going
465   to replace the various shell and awk starter scripts (setup, _plutoload,
466   _plutostart, _realsetup, _startklips, _confread, and auto). Since
467   ipsec.conf is now parsed only once, the starting of multiple tunnels is
468   accelerated tremedously.
469
470 - Added support of %defaultroute to the ipsec starter. If the IP address
471   changes, a HUP signal to the ipsec starter will automatically 
472   reload pluto's connections.
473
474 - moved most compile time configurations from pluto/Makefile to
475   Makefile.inc by defining the options USE_LIBCURL, USE_LDAP,
476   USE_SMARTCARD, and USE_NAT_TRAVERSAL_TRANSPORT_MODE.
477
478 - removed the ipsec verify and ipsec newhostkey commands
479
480 - fixed some 64-bit issues in formatted print statements
481
482 - The scepclient functionality implementing the Simple Certificate
483   Enrollment Protocol (SCEP) is nearly complete but hasn't been
484   documented yet.
485
486
487 strongswan-2.5.7
488 ----------------
489
490 - CA certicates are now automatically loaded from a smartcard
491   or USB crypto token and appear in the ipsec auto --listcacerts
492   listing.
493
494
495 strongswan-2.5.6
496 ----------------
497
498 - when using "ipsec whack --scencrypt <data>" with  a PKCS#11
499   library that does not support the C_Encrypt() Cryptoki
500   function (e.g. OpenSC), the RSA encryption is done in
501   software using the public key fetched from the smartcard.
502
503 - The scepclient function now allows to define the 
504   validity of a self-signed certificate using the --days,
505   --startdate, and --enddate options. The default validity
506   has been changed from one year to five years.
507
508
509 strongswan-2.5.5
510 ----------------
511
512 - the config setup parameter pkcs11proxy=yes opens pluto's PKCS#11
513   interface to other applications for RSA encryption and decryption
514   via the whack interface. Notation:
515
516   ipsec whack --scencrypt <data>
517              [--inbase  16|hex|64|base64|256|text|ascii]
518              [--outbase 16|hex|64|base64|256|text|ascii]
519              [--keyid <keyid>]
520
521   ipsec whack --scdecrypt <data>
522              [--inbase  16|hex|64|base64|256|text|ascii]
523              [--outbase 16|hex|64|base64|256|text|ascii]
524              [--keyid <keyid>]
525
526   The default setting for inbase and outbase is hex. 
527
528   The new proxy interface can be used for securing symmetric
529   encryption keys required by the cryptoloop or dm-crypt
530   disk encryption schemes, especially in the case when
531   pkcs11keepstate=yes causes pluto to lock the pkcs11 slot
532   permanently.
533
534 - if the file /etc/ipsec.secrets is lacking during the startup of
535   pluto then the root-readable file /etc/ipsec.d/private/myKey.der
536   containing a 2048 bit RSA private key and a matching self-signed
537   certificate stored in the file /etc/ipsec.d/certs/selfCert.der
538   is automatically generated by calling the function
539
540   ipsec scepclient --out pkcs1 --out cert-self
541
542   scepclient was written by Jan Hutter and Martin Willi, students
543   at the University of Applied Sciences in Rapperswil, Switzerland.
544
545
546 strongswan-2.5.4
547 ----------------
548
549 - the current extension of the PKCS#7 framework introduced
550   a parsing error in PKCS#7 wrapped X.509 certificates that are
551   e.g. transmitted by Windows XP when multi-level CAs are used.
552   the parsing syntax has been fixed.
553
554 - added a patch by Gerald Richter which tolerates multiple occurrences
555   of the ipsec0 interface when using KLIPS.
556
557
558 strongswan-2.5.3
559 ----------------
560
561 - with gawk-3.1.4 the word "default2 has become a protected
562   keyword for use in switch statements and cannot be used any
563   more in the strongSwan scripts. This problem has been
564   solved by renaming "default" to "defaults" and "setdefault"
565   in the scripts _confread and auto, respectively.
566
567 - introduced the parameter leftsendcert with the values
568
569   always|yes (the default, always send a cert)
570   ifasked    (send the cert only upon a cert request)
571   never|no   (never send a cert, used for raw RSA keys and
572               self-signed certs) 
573
574 - fixed the initialization of the ESP key length to a default of
575   128 bits in the case that the peer does not send a key length
576    attribute for AES encryption.
577
578 - applied Herbert Xu's uniqueIDs patch
579
580 - applied Herbert Xu's CLOEXEC patches
581
582
583 strongswan-2.5.2
584 ----------------
585
586 - CRLs can now be cached also in the case when the issuer's
587   certificate does not contain a subjectKeyIdentifier field.
588   In that case the subjectKeyIdentifier is computed by pluto as the
589   160 bit SHA-1 hash of the issuer's public key in compliance
590   with section 4.2.1.2 of RFC 3280.
591
592 - Fixed a bug introduced by strongswan-2.5.1 which eliminated
593   not only multiple Quick Modes of a given connection but also
594   multiple connections between two security gateways.
595
596
597 strongswan-2.5.1
598 ----------------
599
600 - Under the native IPsec of the Linux 2.6 kernel, a %trap eroute
601   installed either by setting auto=route in ipsec.conf or by
602   a connection put into hold, generates an XFRM_AQUIRE event
603   for each packet that wants to use the not-yet exisiting
604   tunnel. Up to now each XFRM_AQUIRE event led to an entry in
605   the Quick Mode queue, causing multiple IPsec SA to be
606   established in rapid succession. Starting with strongswan-2.5.1
607   only a single IPsec SA is established per host-pair connection.
608
609 - Right after loading the PKCS#11 module, all smartcard slots are
610   searched for certificates. The result can be viewed using
611   the command
612
613     ipsec auto --listcards
614
615   The certificate objects found in the slots are numbered
616   starting with #1, #2, etc. This position number can be used to address
617   certificates (leftcert=%smartcard) and keys (: PIN %smartcard)
618   in ipsec.conf and ipsec.secrets, respectively:
619
620     %smartcard      (selects object #1)
621     %smartcard#1    (selects object #1)
622     %smartcard#3    (selects object #3)
623
624   As an alternative the existing retrieval scheme can be used:
625
626     %smartcard:45   (selects object with id=45)
627     %smartcard0     (selects first object in slot 0)
628     %smartcard4:45  (selects object in slot 4 with id=45)
629
630 - Depending on the settings of CKA_SIGN and CKA_DECRYPT
631   private key flags either C_Sign() or C_Decrypt() is used
632   to generate a signature.
633
634 - The output buffer length parameter siglen in C_Sign()
635   is now initialized to the actual size of the output
636   buffer prior to the function call. This fixes the
637   CKR_BUFFER_TOO_SMALL error that could occur when using
638   the OpenSC PKCS#11 module.
639
640 - Changed the initialization of the PKCS#11 CK_MECHANISM in
641   C_SignInit() to mech  = { CKM_RSA_PKCS, NULL_PTR, 0 }.
642
643 - Refactored the RSA public/private key code and transferred it
644   from keys.c to the new pkcs1.c file as a preparatory step
645   towards the release of the SCEP client.
646
647
648 strongswan-2.5.0
649 ----------------
650
651 - The loading of a PKCS#11 smartcard library module during
652   runtime does not require OpenSC library functions any more
653   because the corresponding code has been integrated into
654   smartcard.c. Also the RSAREF pkcs11 header files have been
655   included in a newly created pluto/rsaref directory so that
656   no external include path has to be defined any longer.
657
658 - A long-awaited feature has been implemented at last:
659   The local caching of CRLs fetched via HTTP or LDAP, activated
660   by the parameter cachecrls=yes in the config setup section
661   of ipsec.conf. The dynamically fetched CRLs are stored under
662   a unique file name containing the issuer's subjectKeyID
663   in /etc/ipsec.d/crls.
664   
665 - Applied a one-line patch courtesy of Michael Richardson
666   from the Openswan project which fixes the kernel-oops
667   in KLIPS when an snmp daemon is running on the same box.
668
669
670 strongswan-2.4.4
671 ----------------
672
673 - Eliminated null length CRL distribution point strings.
674
675 - Fixed a trust path evaluation bug introduced with 2.4.3
676
677
678 strongswan-2.4.3
679 ----------------
680
681 - Improved the joint OCSP / CRL revocation policy.
682   OCSP responses have precedence over CRL entries.
683
684 - Introduced support of CRLv2 reason codes.
685
686 - Fixed a bug with key-pad equipped readers which caused
687   pluto to prompt for the pin via the console when the first
688   occasion to enter the pin via the key-pad was missed.
689
690 - When pluto is built with LDAP_V3 enabled, the library
691   liblber required by newer versions of openldap is now
692   included.
693
694
695 strongswan-2.4.2
696 ----------------
697
698 - Added the _updown_espmark template which requires all
699   incoming ESP traffic to be marked with a default mark
700   value of 50.
701   
702 - Introduced the pkcs11keepstate parameter in the config setup
703   section of ipsec.conf. With pkcs11keepstate=yes the PKCS#11
704   session and login states are kept as long as possible during 
705   the lifetime of pluto. This means that a PIN entry via a key
706   pad has to be done only once.
707
708 - Introduced the pkcs11module parameter in the config setup
709   section of ipsec.conf which specifies the PKCS#11 module
710   to be used with smart cards. Example:
711   
712     pkcs11module=/usr/lib/pkcs11/opensc-pkcs11.lo
713   
714 - Added support of smartcard readers equipped with a PIN pad.
715
716 - Added patch by Jay Pfeifer which detects when netkey
717   modules have been statically built into the Linux 2.6 kernel.
718
719 - Added two patches by Herbert Xu. The first uses ip xfrm
720   instead of setkey to flush the IPsec policy database. The
721   second sets the optional flag in inbound IPComp SAs only.
722     
723 - Applied Ulrich Weber's patch which fixes an interoperability
724   problem between native IPsec and KLIPS systems caused by
725   setting the replay window to 32 instead of 0 for ipcomp.
726
727
728 strongswan-2.4.1
729 ----------------
730
731 - Fixed a bug which caused an unwanted Mode Config request
732   to be initiated in the case where "right" was used to denote
733   the local side in ipsec.conf and "left" the remote side,
734   contrary to the recommendation that "right" be remote and
735   "left" be"local".
736
737
738 strongswan-2.4.0a
739 -----------------
740
741 - updated Vendor ID to strongSwan-2.4.0
742
743 - updated copyright statement to include David Buechi and
744   Michael Meier
745   
746   
747 strongswan-2.4.0
748 ----------------
749
750 - strongSwan now communicates with attached smartcards and
751   USB crypto tokens via the standardized PKCS #11 interface.
752   By default the OpenSC library from www.opensc.org is used
753   but any other PKCS#11 library could be dynamically linked.
754   strongSwan's PKCS#11 API was implemented by David Buechi
755   and Michael Meier, both graduates of the Zurich University
756   of Applied Sciences in Winterthur, Switzerland.
757
758 - When a %trap eroute is triggered by an outgoing IP packet
759   then the native IPsec stack of the Linux 2.6 kernel [often/
760   always?] returns an XFRM_ACQUIRE message with an undefined
761   protocol family field and the connection setup fails.
762   As a workaround IPv4 (AF_INET) is now assumed.
763   
764 - the results of the UML test scenarios are now enhanced 
765   with block diagrams of the virtual network topology used
766   in a particular test. 
767
768
769 strongswan-2.3.2
770 ----------------
771
772 - fixed IV used to decrypt informational messages.
773   This bug was introduced with Mode Config functionality.
774  
775 - fixed NCP Vendor ID.
776
777 - undid one of Ulrich Weber's maximum udp size patches
778   because it caused a segmentation fault with NAT-ed
779   Delete SA messages.
780   
781 - added UML scenarios wildcards and attr-cert which
782   demonstrate the implementation of IPsec policies based
783   on wildcard parameters contained in Distinguished Names and
784   on X.509 attribute certificates, respectively.
785
786
787 strongswan-2.3.1
788 ----------------
789
790 - Added basic Mode Config functionality
791
792 - Added Mathieu Lafon's patch which upgrades the status of
793   the NAT-Traversal implementation to RFC 3947.
794  
795 - The _startklips script now also loads the xfrm4_tunnel
796   module.
797   
798 - Added Ulrich Weber's netlink replay window size and
799   maximum udp size patches.
800
801 - UML testing now uses the Linux 2.6.10 UML kernel by default.
802    
803
804 strongswan-2.3.0
805 ----------------
806
807 - Eric Marchionni and Patrik Rayo, both recent graduates from
808   the Zuercher Hochschule Winterthur in Switzerland, created a
809   User-Mode-Linux test setup for strongSwan. For more details
810   please read the INSTALL and README documents in the testing
811   subdirectory.
812
813 - Full support of group attributes based on X.509 attribute
814   certificates. Attribute certificates can be generated 
815   using the openac facility. For more details see
816    
817   man ipsec_openac.
818  
819   The group attributes can be used in connection definitions
820   in order to give IPsec access to specific user groups.
821   This is done with the new parameter left|rightgroups as in
822   
823   rightgroups="Research, Sales"
824
825   giving access to users possessing the group attributes
826   Research or Sales, only.
827
828 - In Quick Mode clients with subnet mask /32 are now
829   coded as IP_V4_ADDRESS or IP_V6_ADDRESS. This should 
830   fix rekeying problems with the SafeNet/SoftRemote and NCP
831   Secure Entry Clients.
832
833 - Changed the defaults of the ikelifetime and keylife parameters
834   to 3h and 1h, respectively. The maximum allowable values are
835   now both set to 24 h.
836
837 - Suppressed notification wars between two IPsec peers that
838   could e.g. be triggered by incorrect ISAKMP encryption.
839
840 - Public RSA keys can now have identical IDs if either the
841   issuing CA or the serial number is different. The serial
842   number of a certificate is now shown by the command
843   
844   ipsec auto --listpubkeys
845
846
847 strongswan-2.2.2
848 ----------------
849
850 - Added Tuomo Soini's sourceip feature which allows a strongSwan
851   roadwarrior to use a fixed Virtual IP (see README section 2.6)
852   and reduces the well-known four tunnel case on VPN gateways to
853   a single tunnel definition (see README section 2.4).
854
855 - Fixed a bug occuring with NAT-Traversal enabled when the responder
856   suddenly turns initiator and the initiator cannot find a matching
857   connection because of the floated IKE port 4500.
858   
859 - Removed misleading ipsec verify command from barf.
860
861 - Running under the native IP stack, ipsec --version now shows
862   the Linux kernel version (courtesy to the Openswan project).
863
864
865 strongswan-2.2.1
866 ----------------
867
868 - Introduced the ipsec auto --listalgs monitoring command which lists
869   all currently registered IKE and ESP algorithms.
870
871 - Fixed a bug in the ESP algorithm selection occuring when the strict flag
872   is set and the first proposed transform does not match.
873   
874 - Fixed another deadlock in the use of the lock_certs_and_keys() mutex,
875   occuring when a smartcard is present.
876
877 - Prevented that a superseded Phase1 state can trigger a DPD_TIMEOUT event.
878   
879 - Fixed the printing of the notification names (null)
880
881 - Applied another of Herbert Xu's Netlink patches.
882
883
884 strongswan-2.2.0
885 ----------------
886
887 - Support of Dead Peer Detection. The connection parameter
888
889     dpdaction=clear|hold
890      
891   activates DPD for the given connection.
892
893 - The default Opportunistic Encryption (OE) policy groups are not
894   automatically included anymore. Those wishing to activate OE can include
895   the policy group with the following statement in ipsec.conf:
896   
897     include /etc/ipsec.d/examples/oe.conf
898   
899   The default for [right|left]rsasigkey is now set to %cert.
900
901 - strongSwan now has a Vendor ID of its own which can be activated
902   using the compile option VENDORID
903
904 - Applied Herbert Xu's patch which sets the compression algorithm correctly.
905
906 - Applied Herbert Xu's patch fixing an ESPINUDP problem
907
908 - Applied Herbert Xu's patch setting source/destination port numbers.
909
910 - Reapplied one of Herbert Xu's NAT-Traversal patches which got
911   lost during the migration from SuperFreeS/WAN.
912   
913 - Fixed a deadlock in the use of the lock_certs_and_keys() mutex.
914
915 - Fixed the unsharing of alg parameters when instantiating group
916   connection.
917   
918
919 strongswan-2.1.5
920 ----------------
921
922 - Thomas Walpuski made me aware of a potential DoS attack via
923   a PKCS#7-wrapped certificate bundle which could overwrite valid CA
924   certificates in Pluto's authority certificate store. This vulnerability
925   was fixed by establishing trust in CA candidate certificates up to a
926   trusted root CA prior to insertion into Pluto's chained list.
927
928 - replaced the --assign option by the -v option in the auto awk script
929   in order to make it run with mawk under debian/woody.
930
931
932 strongswan-2.1.4
933 ----------------
934
935 - Split of the status information between ipsec auto  --status (concise)
936   and ipsec auto --statusall (verbose). Both commands can be used with
937   an optional connection selector:
938
939     ipsec auto --status[all] <connection_name>
940
941 - Added the description of X.509 related features to the ipsec_auto(8)
942   man page.
943
944 - Hardened the ASN.1 parser in debug mode, especially the printing
945   of malformed distinguished names.
946
947 - The size of an RSA public key received in a certificate is now restricted to
948
949     512 bits <= modulus length <= 8192 bits.
950
951 - Fixed the debug mode enumeration.
952
953
954 strongswan-2.1.3
955 ----------------
956
957 - Fixed another PKCS#7 vulnerability which could lead to an
958   endless loop while following the X.509 trust chain.
959   
960
961 strongswan-2.1.2
962 ----------------
963
964 - Fixed the PKCS#7 vulnerability discovered by Thomas Walpuski
965   that accepted end certificates having identical issuer and subject
966   distinguished names in a multi-tier X.509 trust chain.
967   
968
969 strongswan-2.1.1
970 ----------------
971
972 - Removed all remaining references to ipsec_netlink.h in KLIPS.
973
974
975 strongswan-2.1.0
976 ----------------
977
978 - The new "ca" section allows to define the following parameters:
979
980   ca kool
981      cacert=koolCA.pem                   # cacert of kool CA
982      ocspuri=http://ocsp.kool.net:8001   # ocsp server
983      ldapserver=ldap.kool.net            # default ldap server
984      crluri=http://www.kool.net/kool.crl # crl distribution point
985      crluri2="ldap:///O=Kool, C= .."     # crl distribution point #2
986      auto=add                            # add, ignore
987      
988   The ca definitions can be monitored via the command
989   
990      ipsec auto --listcainfos
991
992 - Fixed cosmetic corruption of /proc filesystem by integrating
993   D. Hugh Redelmeier's freeswan-2.06 kernel fixes.
994
995
996 strongswan-2.0.2
997 ----------------
998
999 - Added support for the 818043 NAT-Traversal update of Microsoft's
1000   Windows 2000/XP IPsec client which sends an ID_FQDN during Quick Mode.
1001   
1002 - A symbolic link to libcrypto is now added in the kernel sources 
1003   during kernel compilation
1004   
1005 - Fixed a couple of 64 bit issues (mostly casts to int).
1006   Thanks to Ken Bantoft who checked my sources on a 64 bit platform.
1007
1008 - Replaced s[n]printf() statements in the kernel by ipsec_snprintf().
1009   Credits go to D. Hugh Redelmeier, Michael Richardson, and Sam Sgro
1010   of the FreeS/WAN team who solved this problem with the 2.4.25 kernel.
1011
1012
1013 strongswan-2.0.1
1014 ----------------
1015
1016 - an empty ASN.1 SEQUENCE OF or SET OF object (e.g. a subjectAltName
1017   certificate extension which contains no generalName item)  can cause
1018   a pluto crash. This bug has been fixed. Additionally the ASN.1 parser has
1019   been hardened to make it more robust against malformed ASN.1 objects.
1020
1021 - applied Herbert Xu's NAT-T patches which fixes NAT-T under the native
1022   Linux 2.6 IPsec stack.
1023   
1024   
1025 strongswan-2.0.0
1026 ----------------
1027
1028 - based on freeswan-2.04, x509-1.5.3, nat-0.6c, alg-0.8.1rc12