ipsec.conf: config setup Reference » History » Version 10
Tobias Brunner, 05.05.2009 16:17
trac conversion errors fixed
1 | 9 | Tobias Brunner | h1. config setup |
---|---|---|---|
2 | 1 | Martin Willi | |
3 | 10 | Tobias Brunner | h2. both daemons |
4 | 9 | Tobias Brunner | |
5 | 10 | Tobias Brunner | _cachecrls = yes | *no*_ |
6 | 10 | Tobias Brunner | p((. certificate revocation lists (CRLs) fetched via http or ldap will be cached in _/etc/ipsec.d/crls/_ |
7 | 1 | Martin Willi | under a unique file name derived from the certification authority's public key. |
8 | 3 | Martin Willi | |
9 | 10 | Tobias Brunner | _charonstart = *yes* | no_ |
10 | 10 | Tobias Brunner | p((. starts the IKEv2 charon daemon. |
11 | 1 | Martin Willi | |
12 | 10 | Tobias Brunner | _plutostart = *yes* | no_ |
13 | 10 | Tobias Brunner | p((. starts the IKEv1 pluto daemon. |
14 | 1 | Martin Willi | |
15 | 10 | Tobias Brunner | _strictcrlpolicy = yes | ifuri | *no*_ |
16 | 10 | Tobias Brunner | p((. defines if a fresh CRL must be available in order for the peer authentication based on RSA |
17 | 9 | Tobias Brunner | signatures to succeed. IKEv2 additionally recognizes _ifuri_ which reverts to _yes_ if |
18 | 9 | Tobias Brunner | at least one CRL URI is defined and to _no_ if no URI is known. |
19 | 8 | Tobias Brunner | |
20 | 10 | Tobias Brunner | _uniqueids = *yes* | no | replace | keep_ |
21 | 10 | Tobias Brunner | p((. whether a particular participant ID should be kept unique, with any new (automatically keyed) |
22 | 1 | Martin Willi | connection using an ID from a different IP address deemed to replace all old ones using that ID. |
23 | 8 | Tobias Brunner | Participant IDs normally _are_ unique, so a new (automatically-keyed) connection using the same ID |
24 | 9 | Tobias Brunner | is almost invariably intended to replace an old one. The IKEv2 daemon also accepts the value _replace_ |
25 | 9 | Tobias Brunner | which is identical to _yes_ and the value _keep_ to reject new IKE_SA setups and keep the duplicate |
26 | 1 | Martin Willi | established earlier. |
27 | 1 | Martin Willi | |
28 | 10 | Tobias Brunner | h2. IKEv1 pluto daemon only |
29 | 8 | Tobias Brunner | |
30 | 10 | Tobias Brunner | _crlcheckinterval = *0s* | <time>_ |
31 | 10 | Tobias Brunner | p((. interval in seconds. CRL fetching is enabled if the value is greater than zero. |
32 | 1 | Martin Willi | Asynchronous, periodic checking for fresh CRLs is currently done by the IKEv1 Pluto daemon only. |
33 | 3 | Martin Willi | |
34 | 10 | Tobias Brunner | _keep_alive = *20s* | <time>_ |
35 | 10 | Tobias Brunner | p((. interval in seconds between NAT keep alive packets. |
36 | 1 | Martin Willi | |
37 | 10 | Tobias Brunner | _nat_traversal = yes | *no*_ |
38 | 10 | Tobias Brunner | p((. activates NAT traversal by accepting source ISAKMP ports different from udp/500 and being able |
39 | 10 | Tobias Brunner | of floating to udp/4500 if a NAT situation is detected. Used by IKEv1 only, NAT traversal is |
40 | 1 | Martin Willi | always being active in IKEv2. |
41 | 3 | Martin Willi | |
42 | 10 | Tobias Brunner | _nocrsend = yes | *no*_ |
43 | 10 | Tobias Brunner | p((. no certificate request payloads will be sent. |
44 | 1 | Martin Willi | |
45 | 10 | Tobias Brunner | _pkcs11initargs = <args>_ |
46 | 10 | Tobias Brunner | p((. non-standard argument string for PKCS#11 C_Initialize() function; required by NSS softoken. |
47 | 1 | Martin Willi | |
48 | 10 | Tobias Brunner | _pkcs11module = <lib>_ |
49 | 10 | Tobias Brunner | p((. defines the path during run-time to a dynamically loadable PKCS#11 library. Overrides any |
50 | 10 | Tobias Brunner | path defined during compile-time using the --pkcs11-module configure option. |
51 | 9 | Tobias Brunner | |
52 | 10 | Tobias Brunner | _pkcs11keepstate = yes | *no*_ |
53 | 10 | Tobias Brunner | p((. PKCS#11 login sessions will be kept during the whole lifetime of the keying daemon. |
54 | 1 | Martin Willi | Useful with pin-pad smart card readers where PINs cannot be cached. |
55 | 6 | Martin Willi | |
56 | 10 | Tobias Brunner | _pkcs11proxy = yes | *no*_ |
57 | 10 | Tobias Brunner | p((. Pluto will act as a PKCS#11 proxy accessible via the whack interface. |
58 | 3 | Martin Willi | |
59 | 10 | Tobias Brunner | _plutodebug = *none_* | <debug list> | _all_ |
60 | 10 | Tobias Brunner | p((. how much Pluto debugging output should be logged. _none_ means no debugging output |
61 | 9 | Tobias Brunner | while _all_ means full output. Otherwise only the specified types of output separated by white space) are enabled; |
62 | 9 | Tobias Brunner | Available debugging types are _control controlmore crypt dns emitting klips lifecycle natt oppo parsing private raw_. |
63 | 9 | Tobias Brunner | Recommended setting is _plutodebug=control_. |
64 | 9 | Tobias Brunner | |
65 | 10 | Tobias Brunner | _plutostderrlog = <file>_ |
66 | 10 | Tobias Brunner | p((. Pluto will not use syslog, but rather log to stderr, and redirect stderr to <file>. |
67 | 3 | Martin Willi | |
68 | 10 | Tobias Brunner | _postpluto = <command>_ |
69 | 10 | Tobias Brunner | p((. shell command to run after starting Pluto (e.g., to remove a decrypted copy of the [[IpsecSecrets|ipsec.secrets]] file). |
70 | 9 | Tobias Brunner | It's run in a very simple way; complexities like I/O redirection are best hidden within a script. |
71 | 5 | Martin Willi | Any output is redirected for logging, so running interactive commands is difficult unless they use |
72 | 1 | Martin Willi | _/dev/tty_ or equivalent for their interaction. |
73 | 9 | Tobias Brunner | |
74 | 10 | Tobias Brunner | _prepluto = <command>_ |
75 | 10 | Tobias Brunner | p((. shell command to run before starting Pluto (e.g., to decrypt an encrypted copy of the [[IpsecSecrets|ipsec.secrets]] file). |
76 | 9 | Tobias Brunner | It's run in a very simple way; complexities like I/O redirection are best hidden within a script. |
77 | 3 | Martin Willi | Any output is redirected for logging, so running interactive commands is difficult unless they use |
78 | 3 | Martin Willi | _/dev/tty_ or equivalent for their interaction. |
79 | 9 | Tobias Brunner | |
80 | 10 | Tobias Brunner | _virtual_private = <networks>_ |
81 | 10 | Tobias Brunner | p((. defines private networks using a wildcard notation. |
82 | 1 | Martin Willi | |
83 | 10 | Tobias Brunner | h2. IKEv2 charon daemon only |
84 | 9 | Tobias Brunner | |
85 | 10 | Tobias Brunner | _charondebug = <debug list>_ |
86 | 10 | Tobias Brunner | p((. how much Charon debugging output should be logged. A comma-separated list containing |
87 | 3 | Martin Willi | _type level_ pairs may be specified, e.g: _dmn 3, ike 1, net -1_. Acceptable values for |
88 | 9 | Tobias Brunner | types are _dmn, mgr, ike, chd, job, cfg, knl, net, enc, lib_ and the level is one of |
89 | 10 | Tobias Brunner | _[-1, 0, 1, 2, 3, 4]_ (for silent, audit, control, controlmore, raw, private). |
90 | 10 | Tobias Brunner | For more flexibility see [[LoggerConfiguration]]. |