4 - Added algorithm selection to charon: New default algorithms for
5 ike=aes128-sha-modp2048, as both daemons support it. The default
6 for IPsec SAs is now esp=aes128-sha,3des-md5. charon handles
7 the ike/esp parameter the same way as pluto. As this syntax does
8 not allow specification of a pseudo random function, the same
9 algorithm as for integrity is used (currently sha/md5). Supported
11 Encryption: aes128, aes192, aes256
12 Integrity/PRF: md5, sha (using hmac)
13 DH-Groups: modp768, 1024, 1536, 2048, 4096, 8192
15 Encryption: aes128, aes192, aes256, 3des, blowfish128,
16 blowfish192, blowfish256
18 More IKE encryption algorithms will come after porting libcrypto into
21 - initial support for rekeying CHILD_SAs using IKEv2. Currently no
22 perfect forward secrecy is used. The rekeying parameters rekey,
23 rekeymargin, rekeyfuzz and keylife from ipsec.conf are now supported
24 when using IKEv2. WARNING: charon currently is unable to handle
25 simultaneous rekeying. To avoid such a situation, use a large
26 rekeyfuzz, or even better, set rekey=no on one peer.
28 - support for host2host, net2net, host2net (roadwarrior) tunnels
29 using predefined RSA certificates (see uml scenarios for
30 configuration examples).
32 - new build environment featuring autotools. Features such
33 as HTTP, LDAP and smartcard support may be enabled using
34 the ./configure script. Changing install directories
35 is possible, too. See ./configure --help for more details.
37 - better integration of charon with ipsec starter, which allows
38 (almost) transparent operation with both daemons. charon
39 handles ipsec commands up, down, status, statusall, listall,
40 listcerts and allows proper load, reload and delete of connections
46 - initial support of the IKEv2 protocol. Connections in
47 ipsec.conf designated by keyexchange=ikev2 are negotiated
48 by the new IKEv2 charon keying daemon whereas those marked
49 by keyexchange=ikev1 or the default keyexchange=ike are
50 handled thy the IKEv1 pluto keying daemon. Currently only
51 a limited subset of functions are available with IKEv2
52 (Default AES encryption, authentication based on locally
53 imported X.509 certificates, unencrypted private RSA keys
54 in PKCS#1 file format, limited functionality of the ipsec
61 - the dynamic iptables rules from the _updown_x509 template
62 for KLIPS and the _updown_policy template for NETKEY have
63 been merged into the default _updown script. The existing
64 left|rightfirewall keyword causes the automatic insertion
65 and deletion of ACCEPT rules for tunneled traffic upon
66 the successful setup and teardown of an IPsec SA, respectively.
67 left|rightfirwall can be used with KLIPS under any Linux 2.4
68 kernel or with NETKEY under a Linux kernel version >= 2.6.16
69 in conjuction with iptables >= 1.3.5. For NETKEY under a Linux
70 kernel version < 2.6.16 which does not support IPsec policy
71 matching yet, please continue to use a copy of the _updown_espmark
72 template loaded via the left|rightupdown keyword.
74 - a new left|righthostaccess keyword has been introduced which
75 can be used in conjunction with left|rightfirewall and the
76 default _updown script. By default leftfirewall=yes inserts
77 a bi-directional iptables FORWARD rule for a local client network
78 with a netmask different from 255.255.255.255 (single host).
79 This does not allow to access the VPN gateway host via its
80 internal network interface which is part of the client subnet
81 because an iptables INPUT and OUTPUT rule would be required.
82 lefthostaccess=yes will cause this additional ACCEPT rules to
85 - mixed PSK|RSA roadwarriors are now supported. The ISAKMP proposal
86 payload is preparsed in order to find out whether the roadwarrior
87 requests PSK or RSA so that a matching connection candidate can
94 - the new _updown_policy template allows ipsec policy based
95 iptables firewall rules. Required are iptables version
96 >= 1.3.5 and linux kernel >= 2.6.16. This script obsoletes
97 the _updown_espmark template, so that no INPUT mangle rules
98 are required any more.
100 - added support of DPD restart mode
102 - ipsec starter now allows the use of wildcards in include
103 statements as e.g. in "include /etc/my_ipsec/*.conf".
104 Patch courtesy of Matthias Haas.
106 - the Netscape OID 'employeeNumber' is now recognized and can be
107 used as a Relative Distinguished Name in certificates.
113 - /etc/init.d/ipsec or /etc/rc.d/ipsec is now a copy of the ipsec
114 command and not of ipsec setup any more.
116 - ipsec starter now supports AH authentication in conjunction with
117 ESP encryption. AH authentication is configured in ipsec.conf
118 via the auth=ah parameter.
120 - The command ipsec scencrypt|scdecrypt <args> is now an alias for
121 ipsec whack --scencrypt|scdecrypt <args>.
123 - get_sa_info() now determines for the native netkey IPsec stack
124 the exact time of the last use of an active eroute. This information
125 is used by the Dead Peer Detection algorithm and is also displayed by
126 the ipsec status command.
132 - running under the native Linux 2.6 IPsec stack, the function
133 get_sa_info() is called by ipsec auto --status to display the current
134 number of transmitted bytes per IPsec SA.
136 - get_sa_info() is also used by the Dead Peer Detection process to detect
137 recent ESP activity. If ESP traffic was received from the peer within
138 the last dpd_delay interval then no R_Y_THERE notification must be sent.
140 - strongSwan now supports the Relative Distinguished Name "unstructuredName"
141 in ID_DER_ASN1_DN identities. The following notations are possible:
143 rightid="unstructuredName=John Doe"
144 rightid="UN=John Doe"
146 - fixed a long-standing bug which caused PSK-based roadwarrior connections
147 to segfault in the function id.c:same_id() called by keys.c:get_secret()
148 if an FQDN, USER_FQDN, or Key ID was defined, as in the following example.
155 - the ipsec command now supports most ipsec auto commands (e.g. ipsec listall).
157 - ipsec starter didn't set host_addr and client.addr ports in whack msg.
159 - in order to guarantee backwards-compatibility with the script-based
160 auto function (e.g. auto --replace), the ipsec starter scripts stores
161 the defaultroute information in the temporary file /var/run/ipsec.info.
163 - The compile-time option USE_XAUTH_VID enables the sending of the XAUTH
164 Vendor ID which is expected by Cisco PIX 7 boxes that act as IKE Mode Config
167 - the ipsec starter now also recognizes the parameters authby=never and
168 type=passthrough|pass|drop|reject.
174 - ipsec starter now supports the also parameter which allows
175 a modular structure of the connection definitions. Thus
176 "ipsec start" is now ready to replace "ipsec setup".
182 - Mathieu Lafon's popular ipsec starter tool has been added to the
183 strongSwan distribution. Many thanks go to Stephan Scholz from astaro
184 for his integration work. ipsec starter is a C program which is going
185 to replace the various shell and awk starter scripts (setup, _plutoload,
186 _plutostart, _realsetup, _startklips, _confread, and auto). Since
187 ipsec.conf is now parsed only once, the starting of multiple tunnels is
188 accelerated tremedously.
190 - Added support of %defaultroute to the ipsec starter. If the IP address
191 changes, a HUP signal to the ipsec starter will automatically
192 reload pluto's connections.
194 - moved most compile time configurations from pluto/Makefile to
195 Makefile.inc by defining the options USE_LIBCURL, USE_LDAP,
196 USE_SMARTCARD, and USE_NAT_TRAVERSAL_TRANSPORT_MODE.
198 - removed the ipsec verify and ipsec newhostkey commands
200 - fixed some 64-bit issues in formatted print statements
202 - The scepclient functionality implementing the Simple Certificate
203 Enrollment Protocol (SCEP) is nearly complete but hasn't been
210 - CA certicates are now automatically loaded from a smartcard
211 or USB crypto token and appear in the ipsec auto --listcacerts
218 - when using "ipsec whack --scencrypt <data>" with a PKCS#11
219 library that does not support the C_Encrypt() Cryptoki
220 function (e.g. OpenSC), the RSA encryption is done in
221 software using the public key fetched from the smartcard.
223 - The scepclient function now allows to define the
224 validity of a self-signed certificate using the --days,
225 --startdate, and --enddate options. The default validity
226 has been changed from one year to five years.
232 - the config setup parameter pkcs11proxy=yes opens pluto's PKCS#11
233 interface to other applications for RSA encryption and decryption
234 via the whack interface. Notation:
236 ipsec whack --scencrypt <data>
237 [--inbase 16|hex|64|base64|256|text|ascii]
238 [--outbase 16|hex|64|base64|256|text|ascii]
241 ipsec whack --scdecrypt <data>
242 [--inbase 16|hex|64|base64|256|text|ascii]
243 [--outbase 16|hex|64|base64|256|text|ascii]
246 The default setting for inbase and outbase is hex.
248 The new proxy interface can be used for securing symmetric
249 encryption keys required by the cryptoloop or dm-crypt
250 disk encryption schemes, especially in the case when
251 pkcs11keepstate=yes causes pluto to lock the pkcs11 slot
254 - if the file /etc/ipsec.secrets is lacking during the startup of
255 pluto then the root-readable file /etc/ipsec.d/private/myKey.der
256 containing a 2048 bit RSA private key and a matching self-signed
257 certificate stored in the file /etc/ipsec.d/certs/selfCert.der
258 is automatically generated by calling the function
260 ipsec scepclient --out pkcs1 --out cert-self
262 scepclient was written by Jan Hutter and Martin Willi, students
263 at the University of Applied Sciences in Rapperswil, Switzerland.
269 - the current extension of the PKCS#7 framework introduced
270 a parsing error in PKCS#7 wrapped X.509 certificates that are
271 e.g. transmitted by Windows XP when multi-level CAs are used.
272 the parsing syntax has been fixed.
274 - added a patch by Gerald Richter which tolerates multiple occurrences
275 of the ipsec0 interface when using KLIPS.
281 - with gawk-3.1.4 the word "default2 has become a protected
282 keyword for use in switch statements and cannot be used any
283 more in the strongSwan scripts. This problem has been
284 solved by renaming "default" to "defaults" and "setdefault"
285 in the scripts _confread and auto, respectively.
287 - introduced the parameter leftsendcert with the values
289 always|yes (the default, always send a cert)
290 ifasked (send the cert only upon a cert request)
291 never|no (never send a cert, used for raw RSA keys and
294 - fixed the initialization of the ESP key length to a default of
295 128 bits in the case that the peer does not send a key length
296 attribute for AES encryption.
298 - applied Herbert Xu's uniqueIDs patch
300 - applied Herbert Xu's CLOEXEC patches
306 - CRLs can now be cached also in the case when the issuer's
307 certificate does not contain a subjectKeyIdentifier field.
308 In that case the subjectKeyIdentifier is computed by pluto as the
309 160 bit SHA-1 hash of the issuer's public key in compliance
310 with section 4.2.1.2 of RFC 3280.
312 - Fixed a bug introduced by strongswan-2.5.1 which eliminated
313 not only multiple Quick Modes of a given connection but also
314 multiple connections between two security gateways.
320 - Under the native IPsec of the Linux 2.6 kernel, a %trap eroute
321 installed either by setting auto=route in ipsec.conf or by
322 a connection put into hold, generates an XFRM_AQUIRE event
323 for each packet that wants to use the not-yet exisiting
324 tunnel. Up to now each XFRM_AQUIRE event led to an entry in
325 the Quick Mode queue, causing multiple IPsec SA to be
326 established in rapid succession. Starting with strongswan-2.5.1
327 only a single IPsec SA is established per host-pair connection.
329 - Right after loading the PKCS#11 module, all smartcard slots are
330 searched for certificates. The result can be viewed using
333 ipsec auto --listcards
335 The certificate objects found in the slots are numbered
336 starting with #1, #2, etc. This position number can be used to address
337 certificates (leftcert=%smartcard) and keys (: PIN %smartcard)
338 in ipsec.conf and ipsec.secrets, respectively:
340 %smartcard (selects object #1)
341 %smartcard#1 (selects object #1)
342 %smartcard#3 (selects object #3)
344 As an alternative the existing retrieval scheme can be used:
346 %smartcard:45 (selects object with id=45)
347 %smartcard0 (selects first object in slot 0)
348 %smartcard4:45 (selects object in slot 4 with id=45)
350 - Depending on the settings of CKA_SIGN and CKA_DECRYPT
351 private key flags either C_Sign() or C_Decrypt() is used
352 to generate a signature.
354 - The output buffer length parameter siglen in C_Sign()
355 is now initialized to the actual size of the output
356 buffer prior to the function call. This fixes the
357 CKR_BUFFER_TOO_SMALL error that could occur when using
358 the OpenSC PKCS#11 module.
360 - Changed the initialization of the PKCS#11 CK_MECHANISM in
361 C_SignInit() to mech = { CKM_RSA_PKCS, NULL_PTR, 0 }.
363 - Refactored the RSA public/private key code and transferred it
364 from keys.c to the new pkcs1.c file as a preparatory step
365 towards the release of the SCEP client.
371 - The loading of a PKCS#11 smartcard library module during
372 runtime does not require OpenSC library functions any more
373 because the corresponding code has been integrated into
374 smartcard.c. Also the RSAREF pkcs11 header files have been
375 included in a newly created pluto/rsaref directory so that
376 no external include path has to be defined any longer.
378 - A long-awaited feature has been implemented at last:
379 The local caching of CRLs fetched via HTTP or LDAP, activated
380 by the parameter cachecrls=yes in the config setup section
381 of ipsec.conf. The dynamically fetched CRLs are stored under
382 a unique file name containing the issuer's subjectKeyID
383 in /etc/ipsec.d/crls.
385 - Applied a one-line patch courtesy of Michael Richardson
386 from the Openswan project which fixes the kernel-oops
387 in KLIPS when an snmp daemon is running on the same box.
393 - Eliminated null length CRL distribution point strings.
395 - Fixed a trust path evaluation bug introduced with 2.4.3
401 - Improved the joint OCSP / CRL revocation policy.
402 OCSP responses have precedence over CRL entries.
404 - Introduced support of CRLv2 reason codes.
406 - Fixed a bug with key-pad equipped readers which caused
407 pluto to prompt for the pin via the console when the first
408 occasion to enter the pin via the key-pad was missed.
410 - When pluto is built with LDAP_V3 enabled, the library
411 liblber required by newer versions of openldap is now
418 - Added the _updown_espmark template which requires all
419 incoming ESP traffic to be marked with a default mark
422 - Introduced the pkcs11keepstate parameter in the config setup
423 section of ipsec.conf. With pkcs11keepstate=yes the PKCS#11
424 session and login states are kept as long as possible during
425 the lifetime of pluto. This means that a PIN entry via a key
426 pad has to be done only once.
428 - Introduced the pkcs11module parameter in the config setup
429 section of ipsec.conf which specifies the PKCS#11 module
430 to be used with smart cards. Example:
432 pkcs11module=/usr/lib/pkcs11/opensc-pkcs11.lo
434 - Added support of smartcard readers equipped with a PIN pad.
436 - Added patch by Jay Pfeifer which detects when netkey
437 modules have been statically built into the Linux 2.6 kernel.
439 - Added two patches by Herbert Xu. The first uses ip xfrm
440 instead of setkey to flush the IPsec policy database. The
441 second sets the optional flag in inbound IPComp SAs only.
443 - Applied Ulrich Weber's patch which fixes an interoperability
444 problem between native IPsec and KLIPS systems caused by
445 setting the replay window to 32 instead of 0 for ipcomp.
451 - Fixed a bug which caused an unwanted Mode Config request
452 to be initiated in the case where "right" was used to denote
453 the local side in ipsec.conf and "left" the remote side,
454 contrary to the recommendation that "right" be remote and
461 - updated Vendor ID to strongSwan-2.4.0
463 - updated copyright statement to include David Buechi and
470 - strongSwan now communicates with attached smartcards and
471 USB crypto tokens via the standardized PKCS #11 interface.
472 By default the OpenSC library from www.opensc.org is used
473 but any other PKCS#11 library could be dynamically linked.
474 strongSwan's PKCS#11 API was implemented by David Buechi
475 and Michael Meier, both graduates of the Zurich University
476 of Applied Sciences in Winterthur, Switzerland.
478 - When a %trap eroute is triggered by an outgoing IP packet
479 then the native IPsec stack of the Linux 2.6 kernel [often/
480 always?] returns an XFRM_ACQUIRE message with an undefined
481 protocol family field and the connection setup fails.
482 As a workaround IPv4 (AF_INET) is now assumed.
484 - the results of the UML test scenarios are now enhanced
485 with block diagrams of the virtual network topology used
486 in a particular test.
492 - fixed IV used to decrypt informational messages.
493 This bug was introduced with Mode Config functionality.
495 - fixed NCP Vendor ID.
497 - undid one of Ulrich Weber's maximum udp size patches
498 because it caused a segmentation fault with NAT-ed
501 - added UML scenarios wildcards and attr-cert which
502 demonstrate the implementation of IPsec policies based
503 on wildcard parameters contained in Distinguished Names and
504 on X.509 attribute certificates, respectively.
510 - Added basic Mode Config functionality
512 - Added Mathieu Lafon's patch which upgrades the status of
513 the NAT-Traversal implementation to RFC 3947.
515 - The _startklips script now also loads the xfrm4_tunnel
518 - Added Ulrich Weber's netlink replay window size and
519 maximum udp size patches.
521 - UML testing now uses the Linux 2.6.10 UML kernel by default.
527 - Eric Marchionni and Patrik Rayo, both recent graduates from
528 the Zuercher Hochschule Winterthur in Switzerland, created a
529 User-Mode-Linux test setup for strongSwan. For more details
530 please read the INSTALL and README documents in the testing
533 - Full support of group attributes based on X.509 attribute
534 certificates. Attribute certificates can be generated
535 using the openac facility. For more details see
539 The group attributes can be used in connection definitions
540 in order to give IPsec access to specific user groups.
541 This is done with the new parameter left|rightgroups as in
543 rightgroups="Research, Sales"
545 giving access to users possessing the group attributes
546 Research or Sales, only.
548 - In Quick Mode clients with subnet mask /32 are now
549 coded as IP_V4_ADDRESS or IP_V6_ADDRESS. This should
550 fix rekeying problems with the SafeNet/SoftRemote and NCP
551 Secure Entry Clients.
553 - Changed the defaults of the ikelifetime and keylife parameters
554 to 3h and 1h, respectively. The maximum allowable values are
555 now both set to 24 h.
557 - Suppressed notification wars between two IPsec peers that
558 could e.g. be triggered by incorrect ISAKMP encryption.
560 - Public RSA keys can now have identical IDs if either the
561 issuing CA or the serial number is different. The serial
562 number of a certificate is now shown by the command
564 ipsec auto --listpubkeys
570 - Added Tuomo Soini's sourceip feature which allows a strongSwan
571 roadwarrior to use a fixed Virtual IP (see README section 2.6)
572 and reduces the well-known four tunnel case on VPN gateways to
573 a single tunnel definition (see README section 2.4).
575 - Fixed a bug occuring with NAT-Traversal enabled when the responder
576 suddenly turns initiator and the initiator cannot find a matching
577 connection because of the floated IKE port 4500.
579 - Removed misleading ipsec verify command from barf.
581 - Running under the native IP stack, ipsec --version now shows
582 the Linux kernel version (courtesy to the Openswan project).
588 - Introduced the ipsec auto --listalgs monitoring command which lists
589 all currently registered IKE and ESP algorithms.
591 - Fixed a bug in the ESP algorithm selection occuring when the strict flag
592 is set and the first proposed transform does not match.
594 - Fixed another deadlock in the use of the lock_certs_and_keys() mutex,
595 occuring when a smartcard is present.
597 - Prevented that a superseded Phase1 state can trigger a DPD_TIMEOUT event.
599 - Fixed the printing of the notification names (null)
601 - Applied another of Herbert Xu's Netlink patches.
607 - Support of Dead Peer Detection. The connection parameter
611 activates DPD for the given connection.
613 - The default Opportunistic Encryption (OE) policy groups are not
614 automatically included anymore. Those wishing to activate OE can include
615 the policy group with the following statement in ipsec.conf:
617 include /etc/ipsec.d/examples/oe.conf
619 The default for [right|left]rsasigkey is now set to %cert.
621 - strongSwan now has a Vendor ID of its own which can be activated
622 using the compile option VENDORID
624 - Applied Herbert Xu's patch which sets the compression algorithm correctly.
626 - Applied Herbert Xu's patch fixing an ESPINUDP problem
628 - Applied Herbert Xu's patch setting source/destination port numbers.
630 - Reapplied one of Herbert Xu's NAT-Traversal patches which got
631 lost during the migration from SuperFreeS/WAN.
633 - Fixed a deadlock in the use of the lock_certs_and_keys() mutex.
635 - Fixed the unsharing of alg parameters when instantiating group
642 - Thomas Walpuski made me aware of a potential DoS attack via
643 a PKCS#7-wrapped certificate bundle which could overwrite valid CA
644 certificates in Pluto's authority certificate store. This vulnerability
645 was fixed by establishing trust in CA candidate certificates up to a
646 trusted root CA prior to insertion into Pluto's chained list.
648 - replaced the --assign option by the -v option in the auto awk script
649 in order to make it run with mawk under debian/woody.
655 - Split of the status information between ipsec auto --status (concise)
656 and ipsec auto --statusall (verbose). Both commands can be used with
657 an optional connection selector:
659 ipsec auto --status[all] <connection_name>
661 - Added the description of X.509 related features to the ipsec_auto(8)
664 - Hardened the ASN.1 parser in debug mode, especially the printing
665 of malformed distinguished names.
667 - The size of an RSA public key received in a certificate is now restricted to
669 512 bits <= modulus length <= 8192 bits.
671 - Fixed the debug mode enumeration.
677 - Fixed another PKCS#7 vulnerability which could lead to an
678 endless loop while following the X.509 trust chain.
684 - Fixed the PKCS#7 vulnerability discovered by Thomas Walpuski
685 that accepted end certificates having identical issuer and subject
686 distinguished names in a multi-tier X.509 trust chain.
692 - Removed all remaining references to ipsec_netlink.h in KLIPS.
698 - The new "ca" section allows to define the following parameters:
701 cacert=koolCA.pem # cacert of kool CA
702 ocspuri=http://ocsp.kool.net:8001 # ocsp server
703 ldapserver=ldap.kool.net # default ldap server
704 crluri=http://www.kool.net/kool.crl # crl distribution point
705 crluri2="ldap:///O=Kool, C= .." # crl distribution point #2
706 auto=add # add, ignore
708 The ca definitions can be monitored via the command
710 ipsec auto --listcainfos
712 - Fixed cosmetic corruption of /proc filesystem by integrating
713 D. Hugh Redelmeier's freeswan-2.06 kernel fixes.
719 - Added support for the 818043 NAT-Traversal update of Microsoft's
720 Windows 2000/XP IPsec client which sends an ID_FQDN during Quick Mode.
722 - A symbolic link to libcrypto is now added in the kernel sources
723 during kernel compilation
725 - Fixed a couple of 64 bit issues (mostly casts to int).
726 Thanks to Ken Bantoft who checked my sources on a 64 bit platform.
728 - Replaced s[n]printf() statements in the kernel by ipsec_snprintf().
729 Credits go to D. Hugh Redelmeier, Michael Richardson, and Sam Sgro
730 of the FreeS/WAN team who solved this problem with the 2.4.25 kernel.
736 - an empty ASN.1 SEQUENCE OF or SET OF object (e.g. a subjectAltName
737 certificate extension which contains no generalName item) can cause
738 a pluto crash. This bug has been fixed. Additionally the ASN.1 parser has
739 been hardened to make it more robust against malformed ASN.1 objects.
741 - applied Herbert Xu's NAT-T patches which fixes NAT-T under the native
742 Linux 2.6 IPsec stack.
748 - based on freeswan-2.04, x509-1.5.3, nat-0.6c, alg-0.8.1rc12