Project

General

Profile

strongswan.conf Reference » History » Version 122

Tobias Brunner, 25.09.2012 12:18
Options updated for 5.0.1

1 101 Tobias Brunner
{{title(strongswan.conf Reference)}}
2 101 Tobias Brunner
3 29 Andreas Steffen
h1. strongswan.conf
4 1 Martin Willi
5 118 Tobias Brunner
bq. *Please note:* This page documents the configuration options of the most current release. Therefore, you should always consult the strongswan.conf(5) man page that comes with the release you are using to confirm which options are actually available.
6 110 Tobias Brunner
7 1 Martin Willi
h2. Overview
8 1 Martin Willi
9 49 Andreas Steffen
While the [[IpsecConf|ipsec.conf]] configuration file is well suited to define IPsec related configuration parameters, it is not useful for other strongSwan applications to read options from this file. The file is hard to parse and only [[IpsecStarter|ipsec starter]] is capable of doing so. As the number of components of the strongSwan project is continually growing, we needed a more flexible configuration file that is easy to extend and can be used by all components. The new configuration format consists of hierarchical sections and a list of key/value pairs in each section. Starting with the strongSwan 4.2.1 release, a default strongswan.conf file is installed in your sysconfdir, e.g. _/etc/strongswan.conf_.
10 1 Martin Willi
11 1 Martin Willi
h2. Syntax
12 1 Martin Willi
13 49 Andreas Steffen
Each section has a name, followed by C-Style curly brackets defining the sections body. Each section body contains a set of subsections and key/value pairs:
14 1 Martin Willi
15 1 Martin Willi
<pre>
16 30 Martin Willi
settings := (section|keyvalue)*
17 30 Martin Willi
section  := name { settings }
18 1 Martin Willi
keyvalue := key = value\n
19 29 Andreas Steffen
</pre>
20 49 Andreas Steffen
21 86 Tobias Brunner
Values must be terminated by a newline. Comments are possible using the #-character, but be careful: The parser implementation is currently limited and does not like braces in comments. Section names and keys may contain any printable character except:
22 49 Andreas Steffen
23 30 Martin Willi
<pre>
24 30 Martin Willi
. { } # \n \t space
25 29 Andreas Steffen
</pre>
26 49 Andreas Steffen
27 29 Andreas Steffen
An example might look like this:
28 49 Andreas Steffen
29 29 Andreas Steffen
<pre>
30 1 Martin Willi
a = b
31 1 Martin Willi
section-one {
32 1 Martin Willi
  somevalue = asdf
33 1 Martin Willi
  subsection {
34 1 Martin Willi
    othervalue = xxx
35 1 Martin Willi
  }
36 1 Martin Willi
  # yei, a comment 
37 1 Martin Willi
  yetanother = zz
38 1 Martin Willi
}
39 1 Martin Willi
section-two {
40 1 Martin Willi
  x = 12
41 1 Martin Willi
}
42 1 Martin Willi
</pre>
43 29 Andreas Steffen
44 1 Martin Willi
Indentation is optional, you may use tabs or spaces.
45 30 Martin Willi
46 30 Martin Willi
47 78 Tobias Brunner
h2. Including files
48 78 Tobias Brunner
49 86 Tobias Brunner
[[451|Version 4.5.1]] introduced the *include* statement which allows to include other files into strongswan.conf, e.g.
50 78 Tobias Brunner
<pre>
51 78 Tobias Brunner
include /some/path/*.conf
52 78 Tobias Brunner
</pre>
53 78 Tobias Brunner
If the file name is not an absolute path, it is considered to be relative to the directory of the file containing the
54 81 Martin Willi
include statement. The file name may include shell wildcards. Also, such inclusions can be nested.
55 78 Tobias Brunner
56 78 Tobias Brunner
Sections loaded from the included files *extend* previously loaded sections; already existing values are *replaced*.
57 78 Tobias Brunner
It is important to note that settings are added relative to the section the include statement is in.
58 78 Tobias Brunner
59 78 Tobias Brunner
As an example, the following three files result in the same final config as the one given above:
60 78 Tobias Brunner
<pre>
61 78 Tobias Brunner
a = b
62 78 Tobias Brunner
section-one {
63 78 Tobias Brunner
    somevalue = before include
64 78 Tobias Brunner
    include include.conf
65 78 Tobias Brunner
}
66 78 Tobias Brunner
include other.conf
67 78 Tobias Brunner
</pre>
68 78 Tobias Brunner
include.conf:
69 78 Tobias Brunner
<pre>
70 78 Tobias Brunner
# settings loaded from this file are added to section-one
71 78 Tobias Brunner
# the following replaces the previous value
72 78 Tobias Brunner
somevalue = asdf
73 78 Tobias Brunner
subsection {
74 78 Tobias Brunner
    othervalue = yyy
75 78 Tobias Brunner
}
76 78 Tobias Brunner
yetanother = zz
77 78 Tobias Brunner
</pre>
78 78 Tobias Brunner
other.conf:
79 78 Tobias Brunner
<pre>
80 78 Tobias Brunner
# this extends section-one and subsection
81 78 Tobias Brunner
section-one {
82 78 Tobias Brunner
    subsection {
83 78 Tobias Brunner
        # this replaces the previous value
84 78 Tobias Brunner
        othervalue = xxx
85 78 Tobias Brunner
    }
86 78 Tobias Brunner
}
87 78 Tobias Brunner
section-two {
88 78 Tobias Brunner
    x = 12
89 78 Tobias Brunner
}
90 78 Tobias Brunner
</pre>
91 78 Tobias Brunner
92 78 Tobias Brunner
93 29 Andreas Steffen
h2. Reading values
94 49 Andreas Steffen
95 1 Martin Willi
The config file is read by libstrongswan during library initialization. Values are accessed using a dot-separated section list and a key: 
96 78 Tobias Brunner
Accessing *section-one.subsection.othervalue* will return *xxx*.
97 78 Tobias Brunner
98 78 Tobias Brunner
Have a look at the settings interface (source:src/libstrongswan/settings.h) to learn about the details.
99 78 Tobias Brunner
100 78 Tobias Brunner
101 27 Andreas Steffen
102 29 Andreas Steffen
h2. Defined keys
103 1 Martin Willi
104 1 Martin Willi
The following keys are currently defined (using dot notation).
105 1 Martin Willi
106 30 Martin Willi
|Key                                                |Default   |Description|
107 122 Tobias Brunner
|\3. *attest section*                               |
108 107 Andreas Steffen
|attest.database                                    |          |Path to database with file measurement information|
109 107 Andreas Steffen
|attest.load                                        |          |Plugins to load in ipsec attest tool|
110 40 Tobias Brunner
|\3. *charon section*                               |
111 44 Andreas Steffen
|charon.block_threshold                             |5         |Maximum number of half-open IKE_SAs for a single peer IP|
112 119 Andreas Steffen
|charon.cisco_unity                                 |no        |Send Cisco Unity vendor ID payload (IKEv1 only)|
113 30 Martin Willi
|charon.close_ike_on_child_failure                  |no        |Close the IKE_SA if setup of the CHILD_SA along with IKE_AUTH failed|
114 44 Andreas Steffen
|charon.cookie_threshold                            |10        |Number of half-open IKE_SAs that activate the cookie mechanism| 
115 87 Tobias Brunner
|charon.dns1                                        |          |DNS server 1 assigned to peer via configuration payload (CP), see [[AttrPlugin|attr plugin]]|
116 30 Martin Willi
|charon.dns2                                        |          |DNS server 2 assigned to peer via configuration payload (CP)|
117 30 Martin Willi
|charon.dos_protection                              |yes       |Enable Denial of Service protection using cookies and aggressiveness checks|
118 72 Tobias Brunner
|charon.filelog                                     |          |Section to define file loggers, see [[LoggerConfiguration]]|
119 122 Tobias Brunner
|charon.flush_auth_cfg                              |no        |If enabled objects used during authentication (certificates, identities etc.) are released to free memory once an IKE_SA is established. Enabling this might conflict with plugins that later need access to e.g. the used certificates.|
120 1 Martin Willi
|charon.half_open_timeout                           |30        |Timeout in seconds for connecting IKE_SAs, also see [[JobPriority#IKE_SA_INIT-dropping|IKE_SA_INIT dropping]]|
121 97 Tobias Brunner
|charon.hash_and_url                                |no        |Enable hash and URL support|
122 122 Tobias Brunner
|charon.i_dont_care_about_security_and_use_aggressive_mode_psk|no|If enabled _responders_ are allowed to use IKEv1 Aggressive Mode with pre-shared keys, which is discouraged due to security concerns (offline attacks on the openly transmitted hash of the PSK)|
123 122 Tobias Brunner
|charon.ignore_routing_tables                       |          |A space-separated list of routing tables to be excluded from route lookup|
124 111 Tobias Brunner
|charon.ikesa_table_segments                        |1         |Number of exclusively locked segments in the hash table, see [[IkeSaTable|IKE_SA lookup tuning]]|
125 111 Tobias Brunner
|charon.ikesa_table_size                            |1         |Size of the IKE_SA hash table, see [[IkeSaTable|IKE_SA lookup tuning]]|
126 59 Andreas Steffen
|charon.inactivity_close_ike                        |no        |Whether to close IKE_SA if the only CHILD_SA closed due to inactivity|
127 97 Tobias Brunner
|charon.init_limit_half_open                        |0         |Limit new connections based on the current number of half open IKE_SAs, see [[JobPriority#IKE_SA_INIT-dropping|IKE_SA_INIT dropping]]|
128 1 Martin Willi
|charon.init_limit_job_load                         |0         |Limit new connections based on the number of jobs currently queued for processing, see [[JobPriority#IKE_SA_INIT-dropping|IKE_SA_INIT dropping]]|
129 1 Martin Willi
|charon.install_routes                              |yes       |Install routes into a separate routing table for established IPsec tunnels|
130 1 Martin Willi
|charon.install_virtual_ip                          |yes       |Install virtual IP addresses|
131 122 Tobias Brunner
|charon.install_virtual_ip_on                       |          |The name of the interface on which virtual IP addresses should be installed. If not specified the addresses will be installed on the outbound interface.|
132 122 Tobias Brunner
|charon.interfaces_ignore                           |          |A comma-separated list of network interfaces that should be ignored, if _charon.interfaces_use_ is specified this option has no effect.|
133 122 Tobias Brunner
|charon.interfaces_use                              |          |A comma-separated list of network interfaces that should be used by charon. All other interfaces are ignored.|
134 70 Tobias Brunner
|charon.keep_alive                                  |20s       |NAT keep alive interval|
135 72 Tobias Brunner
|charon.load                                        |          |Plugins to load in IKEv2 charon daemon, see [[PluginLoad]]|
136 30 Martin Willi
|charon.max_packet                                  |10000     |Maximum packet size accepted by charon|
137 1 Martin Willi
|charon.multiple_authentication                     |yes       |Enable multiple authentication exchanges (RFC 4739)|
138 1 Martin Willi
|charon.nbns1                                       |          |WINS server 1 assigned to peer via configuration payload (CP), see [[AttrPlugin|attr plugin]]|
139 1 Martin Willi
|charon.nbns2                                       |          |WINS server 2 assigned to peer via configuration payload (CP)|
140 122 Tobias Brunner
|charon.port                                        |500       |UDP port used locally. If set to 0 a random port will be allocated.|
141 122 Tobias Brunner
|charon.port_nat_t                                  |4500      |UDP port used locally in case of NAT-T. If set to 0 a random port will be allocated. Has to be different from _charon.port_, otherwise a random port will be allocated.|
142 30 Martin Willi
|charon.process_route                               |yes       |Process RTM_NEWROUTE and RTM_DELROUTE events|
143 122 Tobias Brunner
|charon.receive_delay                               |0         |Delay in ms for receiving packets, to simulate larger RTT|
144 72 Tobias Brunner
|charon.receive_delay_response                      |yes       |Delay response messages|
145 72 Tobias Brunner
|charon.receive_delay_request                       |yes       |Delay request messages|
146 116 Tobias Brunner
|charon.receive_delay_type                          |0         |Specific IKEv2 message type to delay, 0 for any|
147 59 Andreas Steffen
|charon.replay_window                               |32        |Size of the AH/ESP replay window, in packets.|
148 59 Andreas Steffen
|charon.retransmit_base                             |1.8       |Base to use for calculating exponential back off, see [[Retransmission]]|
149 1 Martin Willi
|charon.retransmit_timeout                          |4.0       |Timeout in seconds before sending first retransmit|
150 1 Martin Willi
|charon.retransmit_tries                            |5         |Number of times to retransmit a packet before giving up|
151 118 Tobias Brunner
|charon.retry_initiate_interval                     |0         |Interval to use when retrying to initiate an IKE_SA (e.g. if DNS resolution failed), 0 to disable retries|
152 47 Martin Willi
|charon.reuse_ikesa                                 |yes       |Initiate CHILD_SA within existing IKE_SAs|
153 47 Martin Willi
|charon.routing_table                               |          |Numerical routing table to install routes to|
154 72 Tobias Brunner
|charon.routing_table_prio                          |          |Priority of the routing table|
155 122 Tobias Brunner
|charon.send_delay                                  |0         |Delay in ms for sending packets, to simulate larger RTT|
156 72 Tobias Brunner
|charon.send_delay_response                         |yes       |Delay response messages|
157 1 Martin Willi
|charon.send_delay_request                          |yes       |Delay request messages|
158 59 Andreas Steffen
|charon.send_delay_type                             |0         |Specific IKEv2 message type to delay, 0 for any|
159 1 Martin Willi
|charon.send_vendor_id                              |no        |Send strongSwan vendor ID payload|
160 1 Martin Willi
|charon.syslog                                      |          |Section to define syslog loggers, see [[LoggerConfiguration]]|
161 1 Martin Willi
|charon.threads                                     |16        |Number of worker threads in charon|
162 1 Martin Willi
|\3. *charon plugins subsection*                    |
163 122 Tobias Brunner
|charon.plugins.android_log.loglevel                |1         |Loglevel for logging to Android specific logger|
164 1 Martin Willi
|charon.plugins.attr                                |          |Section to specify arbitrary attributes that are assigned to a peer via configuration payload, see [[AttrPlugin|attr plugin]]|
165 122 Tobias Brunner
|charon.plugins.certexpire.csv.cron                 |          |Cron style string specifying CSV export times, see [[certexpire]] for details.|
166 122 Tobias Brunner
|charon.plugins.certexpire.csv.local                |          |strftime(3) format string for the CSV file name to export local certificates to|
167 122 Tobias Brunner
|charon.plugins.certexpire.csv.remote               |          |strftime(3) format string for the CSV file name to export remote certificates to|
168 122 Tobias Brunner
|charon.plugins.certexpire.csv.separator            |,         |CSV field separator|
169 122 Tobias Brunner
|charon.plugins.certexpire.csv.empty_string         |          |String to use in empty intermediate CA fields|
170 122 Tobias Brunner
|charon.plugins.certexpire.csv.format               |%d:%m:%Y  |strftime(3) format string to export expiration dates as|
171 122 Tobias Brunner
|charon.plugins.certexpire.csv.fixed_fields         |yes       |Use a fixed intermediate CA field count|
172 122 Tobias Brunner
|charon.plugins.coupling.file                       |          |File to store coupling list to, see [[CertCoupling|certcoupling plugin]] for details.|
173 122 Tobias Brunner
|charon.plugins.coupling.hash                       |sha1      |Hashing algorithm to fingerprint coupled certificates|
174 122 Tobias Brunner
|charon.plugins.coupling.max                        |1         |Maximum number of coupling entries to create|
175 122 Tobias Brunner
|charon.plugins.dhcp.force_server_address           |no        |Always  use the configured server address, see [[DHCPPlugin|DHCP plugin]] for details.|
176 1 Martin Willi
|charon.plugins.dhcp.identity_lease                 |no        |Derive user-defined MAC address from hash of IKEv2 identity|
177 122 Tobias Brunner
|charon.plugins.dhcp.server                         |255.255.255.255|DHCP server unicast or broadcast IP address|
178 122 Tobias Brunner
|charon.plugins.duplicheck.enable                   |yes       |Enable [[duplicheck]] plugin (if loaded)|
179 84 Andreas Steffen
|charon.plugins.eap-aka.request_identity            |yes       ||
180 1 Martin Willi
|charon.plugins.eap-aka-3ggp2.seq_check             |          ||
181 122 Tobias Brunner
|charon.plugins.eap-dynamic.preferred               |          |The preferred EAP method(s) to be used. If it is not given the first registered method will be used initially. If a comma separated list is given the methods are tried in the given order before trying the rest of the registered methods.|
182 122 Tobias Brunner
|charon.plugins.eap-dynamic.prefer_user             |no        |If enabled the EAP methods proposed in an EAP-Nak message sent by the peer are preferred over the methods registered locally.|
183 122 Tobias Brunner
|charon.plugins.eap-gtc.backend                     |pam       |XAuth backend to be used for credential verification, see [[EapGtc|EAP-GTC]]|
184 1 Martin Willi
|charon.plugins.eap-peap.fragment_size              |1024      |Maximum size of an EAP-PEAP packet|
185 1 Martin Willi
|charon.plugins.eap-peap.max_message_count          |32        |Maximum number of processed EAP-PEAP packets|
186 1 Martin Willi
|charon.plugins.eap-peap.include_length             |no        |Include length in non-fragmented EAP-PEAP packets|
187 1 Martin Willi
|charon.plugins.eap-peap.phase2_method              |mschapv2  |Phase2 EAP client authentication method|
188 84 Andreas Steffen
|charon.plugins.eap-peap.phase2_piggyback           |no        |Phase2 EAP Identity request piggybacked by server onto TLS Finished message|
189 122 Tobias Brunner
|charon.plugins.eap-peap.phase2_tnc                 |no        |Start phase2 EAP-TNC protocol after successful client authentication|
190 1 Martin Willi
|charon.plugins.eap-peap.request_peer_auth          |no        |Request peer authentication based on a client certificate|
191 1 Martin Willi
|charon.plugins.eap-radius.accounting               |no        |Enable EAP-RADIUS accounting|
192 104 Martin Willi
|charon.plugins.eap-radius.class_group              |no        |Use the class attribute sent in the RADIUS-Accept message as group membership information, see [[EapRadius]]|
193 122 Tobias Brunner
|charon.plugins.eap-radius.dae.enable               |no        |Enables support for the Dynamic Authorization Extension (RFC 5176)|
194 122 Tobias Brunner
|charon.plugins.eap-radius.dae.listen               |0.0.0.0   |Address to listen for DAE messages from the RADIUS server|
195 122 Tobias Brunner
|charon.plugins.eap-radius.dae.port                 |3799      |Port to listen for DAE requests|
196 122 Tobias Brunner
|charon.plugins.eap-radius.dae.secret               |          |Shared secret used to verify/sign DAE messages|
197 1 Martin Willi
|charon.plugins.eap-radius.eap_start                |no        |Send EAP-Start instead of EAP-Identity to start RADIUS conversation|
198 1 Martin Willi
|charon.plugins.eap-radius.filter_id                |no        |Use the filter_id attribute sent in the RADIUS-Accept message as group membership if the RADIUS tunnel_type attribute is set to ESP|
199 122 Tobias Brunner
|charon.plugins.eap-radius.forward.ike_to_radius    |          |RADIUS attributes to be forwarded from IKEv2 to RADIUS (can be defined by name or attribute number, a colon can be used to specify vendor-specific attributes, e.g. Reply-Message, or 11, or 36906:12).|
200 122 Tobias Brunner
|charon.plugins.eap-radius.forward.radius_to_ike    |          |Same as above but from RADIUS to IKEv2, a strongSwan specific private notify (40969) is used to transmit the attributes.|
201 104 Martin Willi
|charon.plugins.eap-radius.id_prefix                |          |Prefix to EAP-Identity, some AAA servers use a IMSI prefix to select the EAP method|
202 73 Tobias Brunner
|charon.plugins.eap-radius.nas_identifier           |strongSwan|NAS-Identifier to include in RADIUS messages|
203 122 Tobias Brunner
|charon.plugins.eap-radius.port                     |1812      |Port of RADIUS server (authentication)|
204 73 Tobias Brunner
|charon.plugins.eap-radius.secret                   |          |Shared secret between RADIUS and NAS|
205 73 Tobias Brunner
|charon.plugins.eap-radius.server                   |          |IP/Hostname of RADIUS server|
206 122 Tobias Brunner
|charon.plugins.eap-radius.servers                  |          |Section to specify multiple RADIUS servers, see [[EapRadius]]. The _nas_identifier_, _secret_, _sockets_ and _port_ (or _auth_port_) options can be specified for each server. A server's IP/Hostname can be configured using the _address_ option. The _acct_port_ [1813] option can be used to specify the port used for RADIUS accounting. For each server a priority can be specified using the _preference_ [0] option.|
207 73 Tobias Brunner
|charon.plugins.eap-radius.sockets                  |1         |Number of sockets (ports) to use, increase for high load|
208 73 Tobias Brunner
|charon.plugins.eap-sim.request_identity            |yes       ||
209 66 Andreas Steffen
|charon.plugins.eap-simaka-sql.database             |          ||
210 68 Andreas Steffen
|charon.plugins.eap-simaka-sql.remove_used          |          ||
211 85 Andreas Steffen
|charon.plugins.eap-tls.fragment_size               |1024      |Maximum size of an EAP-TLS packet|
212 1 Martin Willi
|charon.plugins.eap-tls.max_message_count           |32        |Maximum number of processed EAP-TLS packets|
213 120 Andreas Steffen
|charon.plugins.eap-tls.include_length              |yes       |Include length in non-fragmented EAP-TLS packets|
214 66 Andreas Steffen
|charon.plugins.eap-tnc.max_message_count           |10        |Maximum number of processed EAP-TNC packets|
215 1 Martin Willi
|charon.plugins.eap-tnc.protocol                    |tnccs-1.1 |IF-TNCCS protocol version to be used (tnccs-1.1, tnccs-2.0, tnccs-dynamic)|
216 85 Andreas Steffen
|charon.plugins.eap-ttls.fragment_size              |1024      |Maximum size of an EAP-TTLS packet|
217 1 Martin Willi
|charon.plugins.eap-ttls.max_message_count          |32        |Maximum number of processed EAP-TTLS packets|
218 1 Martin Willi
|charon.plugins.eap-ttls.include_length             |yes       |Include length in non-fragmented EAP-TTLS packets|
219 76 Andreas Steffen
|charon.plugins.eap-ttls.phase2_method              |md5       |Phase2 EAP client authentication method|
220 64 Andreas Steffen
|charon.plugins.eap-ttls.phase2_piggyback           |no        |Phase2 EAP Identity request piggybacked by server onto TLS Finished message|
221 1 Martin Willi
|charon.plugins.eap-ttls.phase2_tnc                 |no        |Start phase2 EAP TNC protocol after successful client authentication|
222 73 Tobias Brunner
|charon.plugins.eap-ttls.request_peer_auth          |no        |Request peer authentication based on a client certificate|
223 73 Tobias Brunner
|charon.plugins.ha.fifo_interface                   |yes       ||
224 41 Martin Willi
|charon.plugins.ha.heartbeat_delay                  |1000      ||
225 41 Martin Willi
|charon.plugins.ha.heartbeat_timeout                |2100      ||
226 73 Tobias Brunner
|charon.plugins.ha.local                            |          ||
227 1 Martin Willi
|charon.plugins.ha.monitor                          |yes       ||
228 1 Martin Willi
|charon.plugins.ha.pools                            |          ||
229 1 Martin Willi
|charon.plugins.ha.remote                           |          ||
230 1 Martin Willi
|charon.plugins.ha.resync                           |yes       ||
231 73 Tobias Brunner
|charon.plugins.ha.secret                           |          ||
232 73 Tobias Brunner
|charon.plugins.ha.segment_count                    |1         ||
233 73 Tobias Brunner
|charon.plugins.led.activity_led                    |          ||
234 1 Martin Willi
|charon.plugins.led.blink_time                      |50        ||
235 73 Tobias Brunner
|charon.plugins.kernel-klips.ipsec_dev_count        |4         |Number of ipsecN devices|
236 73 Tobias Brunner
|charon.plugins.kernel-klips.ipsec_dev_mtu          |0         |Set MTU of ipsecN device|
237 73 Tobias Brunner
|charon.plugins.load-tester.child_rekey             |600       |Seconds to start CHILD_SA rekeying after setup|
238 94 Tobias Brunner
|charon.plugins.load-tester.delay                   |0         |Delay between initiatons for each thread|
239 1 Martin Willi
|charon.plugins.load-tester.delete_after_established|no        |Delete an IKE_SA as soon as it has been established|
240 73 Tobias Brunner
|charon.plugins.load-tester.dpd_delay               |0         |DPD delay to use in load test|
241 73 Tobias Brunner
|charon.plugins.load-tester.dynamic_port            |0         |Base port to be used for requests (each client uses a different port)|
242 94 Tobias Brunner
|charon.plugins.load-tester.eap_password            |default-pwd|EAP secret to use in load test|
243 1 Martin Willi
|charon.plugins.load-tester.enable                  |no        |Enable the load testing plugin. Read [[LoadTests]] first!|
244 73 Tobias Brunner
|charon.plugins.load-tester.fake_kernel             |no        |Fake the kernel interface to allow load-testing against self|
245 94 Tobias Brunner
|charon.plugins.load-tester.ike_rekey               |0         |Seconds to start IKE_SA rekeying after setup|
246 41 Martin Willi
|charon.plugins.load-tester.init_limit              |0         |Global limit of concurrently established SAs during load test|
247 73 Tobias Brunner
|charon.plugins.load-tester.initiators              |0         |Number of concurrent initiator threads to use in load test|
248 94 Tobias Brunner
|charon.plugins.load-tester.initiator_auth          |pubkey    |Authentication method(s) the intiator uses|
249 74 Tobias Brunner
|charon.plugins.load-tester.initiator_id            |          |Initiator ID to use in load test|
250 73 Tobias Brunner
|charon.plugins.load-tester.iterations              |1         |Number of IKE_SAs to initate to self by each initiator in load test|
251 41 Martin Willi
|charon.plugins.load-tester.pool                    |          |Provide INTERNAL_IPV4_ADDRs from a named pool|
252 94 Tobias Brunner
|charon.plugins.load-tester.preshared_key           |default-psk|Preshared key to use in load test|
253 41 Martin Willi
|charon.plugins.load-tester.proposal                |aes128-sha1-modp768|IKE proposal to use in load test|
254 1 Martin Willi
|charon.plugins.load-tester.remote                  |127.0.0.1 |Address to initiation connections to|
255 1 Martin Willi
|charon.plugins.load-tester.responder_auth          |pubkey    |Authentication method(s) the responder uses|
256 1 Martin Willi
|charon.plugins.load-tester.responder_id            |          |Responder ID to use in load test|
257 73 Tobias Brunner
|charon.plugins.load-tester.request_virtual_ip      |no        |Request an INTERNAL_IPV4_ADDR from the server|
258 117 Tobias Brunner
|charon.plugins.load-tester.shutdown_when_complete  |no        |Shutdown the daemon after all IKE_SAs have been established|
259 117 Tobias Brunner
|charon.plugins.radattr.dir                         |          |Directory where RADIUS attributes are stored in client-ID specific files, see [[RadAttrPlugin|radattr]]|
260 114 Tobias Brunner
|charon.plugins.radattr.message_id                  |-1        |RADIUS attributes are added to all IKE_AUTH messages by default (-1), or only to the IKE_AUTH message with the given IKEv2 message ID|
261 114 Tobias Brunner
|charon.plugins.resolve.file                        |/etc/resolv.conf|File used by the [[resolveplugin|resolve plugin]] to write DNS server entries to|
262 1 Martin Willi
|charon.plugins.resolve.resolvconf.iface_prefix     |lo.inet.ipsec.|Prefix used by the [[resolveplugin|resolve plugin]] for interface names sent to resolvconf(8). The name server address is appended to this prefix to make it unique. The result has to be a valid interface name according to the rules defined by resolvconf. Also, it should have a high priority according to the order defined in interface-order(5).|
263 1 Martin Willi
|charon.plugins.sql.database                        |          |Database URI for charons [[SQL]] plugin|
264 105 Tobias Brunner
|charon.plugins.sql.loglevel                        |-1        |Loglevel for logging to [[SQL]] database|
265 103 Tobias Brunner
|charon.plugins.stroke.ignore_missing_ca_basic_constraint|no   |Treat certificates in [[IpsecDirectoryCacerts|ipsec.d/cacerts]] and ipsec.conf [[CASection|ca sections]] as CA certificates even if they don't contain a CA basic constraint.|
266 1 Martin Willi
|charon.plugins.stroke.max_concurrent               |4         |Maximum number of stroke messages handled concurrently|
267 122 Tobias Brunner
|charon.plugins.tnccs-11.max_message_size           |45000     |Maximum size of a PA-TNC message (XML & Base64 encoding)|
268 122 Tobias Brunner
|charon.plugins.tnccs-20.max_batch_size             |65522     |Maximum size of a PB-TNC batch (upper limit via PT-EAP = 65529)|
269 122 Tobias Brunner
|charon.plugins.tnccs-20.max_message_size           |65490     |Maximum size of a PA-TNC message (upper limit via PT-EAP = 65497)|
270 99 Andreas Steffen
|charon.plugins.tnc-ifmap.device_name               |          |Unique name as a PEP and/or PDP device|
271 1 Martin Willi
|charon.plugins.tnc-ifmap.key_file                  |          |Concatenated client certificate and private key|
272 98 Andreas Steffen
|charon.plugins.tnc-ifmap.password                  |          |Authentication password of MAP client|
273 1 Martin Willi
|charon.plugins.tnc-ifmap.server_cert               |          |Certificate of MAP server|
274 99 Andreas Steffen
|charon.plugins.tnc-ifmap.ssl_passphrase            |          |Passphrase protecting private key|
275 98 Andreas Steffen
|charon.plugins.tnc-ifmap.username                  |          |Authentication usernameof of MAP client|
276 1 Martin Willi
|charon.plugins.tnc_imc.preferred_language          |en        |Preferred language for TNC recommendations|  
277 98 Andreas Steffen
|charon.plugins.tnc-pdp.method                      |ttls      |EAP tunnel method to be used|
278 98 Andreas Steffen
|charon.plugins.tnc-pdp.port                        |1812      |RADIUS server port the strongSwan PDP is listening on|
279 115 Andreas Steffen
|charon.plugins.tnc-pdp.secret                      |          |Shared RADIUS secret between strongSwan PDP and NAS|
280 115 Andreas Steffen
|charon.plugins.tnc-pdp.server                      |          |Name of the strongSwan PDP as contained in the AAA certificate|
281 122 Tobias Brunner
|charon.plugins.updown.dns_handler                  |no        |Whether the updown script should handle DNS servers assigned via IKEv1 Mode Config or IKEv2 Config Payloads (if enabled they can't be handled by other plugins, like [[resolveplugin|resolve]])|
282 115 Andreas Steffen
|charon.plugins.whitelist.enable                    |yes       |Enable loaded [[whitelist]] plugin|
283 122 Tobias Brunner
|charon.plugins.xauth-eap.backend                   |radius    |EAP plugin to be used as backend for XAuth credential verification, see [[XAuthEAP]]|
284 122 Tobias Brunner
|charon.plugins.xauth-pam.pam_service               |login     |PAM service to be used for authentication, see [[XAuthPAM]]|
285 73 Tobias Brunner
|\3. *libstrongswan section*                        |
286 122 Tobias Brunner
|libstrongswan.cert_cache                           |yes       |Whether relations in validated certificate chains should be cached in memory|
287 73 Tobias Brunner
|libstrongswan.crypto_test.bench                    |no        ||
288 1 Martin Willi
|libstrongswan.crypto_test.bench_size               |1024      ||
289 40 Tobias Brunner
|libstrongswan.crypto_test.bench_time               |50        ||
290 32 Andreas Steffen
|libstrongswan.crypto_test.on_add                   |no        |Test crypto algorithms during registration|
291 73 Tobias Brunner
|libstrongswan.crypto_test.on_create                |no        |Test crypto algorithms on each crypto primitive instantiation|
292 36 Martin Willi
|libstrongswan.crypto_test.required                 |no        |Strictly require at least one test vector to enable an algorithm|
293 1 Martin Willi
|libstrongswan.crypto_test.rng_true                 |no        |Whether to test RNG with TRUE quality; requires a lot of entropy|
294 57 Andreas Steffen
|libstrongswan.dh_exponent_ansi_x9_42               |yes       |Use ANSI X9.42 DH exponent size or optimum size matched to cryptographical strength|
295 88 Tobias Brunner
|libstrongswan.ecp_x_coordinate_only                |yes       |Compliance with the errata for RFC 4753 | 
296 1 Martin Willi
|libstrongswan.integrity_test                       |no        |Check daemon, libstrongswan and plugin integrity at startup|
297 40 Tobias Brunner
|libstrongswan.leak_detective.detailed              |yes       |Includes source file names and line numbers in leak detective output|
298 71 Andreas Steffen
|libstrongswan.processor.priority_threads           |          |Subsection to configure the number of reserved threads per priority class (see [[JobPriority]])|
299 80 Tobias Brunner
|libstrongswan.x509.enforce_critical                |yes       |Discard certificates with unsupported or unknown critical extensions|
300 80 Tobias Brunner
|\3. *libstrongswan plugins subsection*             |
301 102 Tobias Brunner
|libstrongswan.plugins.attr-sql.database            |          |Database URI for the [[attrsql|attr-sql plugin]] used by charon and pluto |
302 102 Tobias Brunner
|libstrongswan.plugins.attr-sql.lease_history       |yes       |Enable logging of [[SQL]] IP pool leases|
303 1 Martin Willi
|libstrongswan.plugins.gcrypt.quick_random          |no        |Use faster random numbers in gcrypt; for testing only, produces weak keys!|
304 1 Martin Willi
|libstrongswan.plugins.openssl.engine_id            |pkcs11    |ENGINE ID to use in the OpenSSL plugin|
305 30 Martin Willi
|libstrongswan.plugins.pkcs11.modules               |          |List of available PKCS#11 modules, see [[SmartCardsIKEv2]]|
306 1 Martin Willi
|libstrongswan.plugins.pkcs11.use_dh                |no        |Whether the PKCS#11 modules should be used for DH and ECDH|
307 102 Tobias Brunner
|libstrongswan.plugins.pkcs11.use_ecc               |no        |Whether the PKCS#11 modules should be used for ECDH and ECDSA public key operations. ECDSA private keys are used regardless of this option|
308 102 Tobias Brunner
|libstrongswan.plugins.pkcs11.use_hasher            |no        |Whether the PKCS#11 modules should be used to hash data|
309 121 Martin Willi
|libstrongswan.plugins.pkcs11.use_pubkey            |no        |Whether the PKCS#11 modules should be used for public key operations, even for keys not stored on tokens|
310 121 Martin Willi
|libstrongswan.plugins.pkcs11.use_rng               |no        |Whether the PKCS#11 modules should be used as RNG|
311 30 Martin Willi
|libstrongswan.plugins.random.random                |/dev/random|File to read random bytes from|
312 30 Martin Willi
|libstrongswan.plugins.random.urandom               |/dev/urandom|File to read pseudo random bytes from|
313 30 Martin Willi
|\3. *libtls section*                               |
314 30 Martin Willi
|libtls.cipher                                      |          |List of TLS encryption ciphers| 
315 91 Andreas Steffen
|libtls.key_exchange                                |          |List of TLS key exchange methods| 
316 92 Andreas Steffen
|libtls.mac                                         |          |List of TLS MAC algorithms| 
317 92 Andreas Steffen
|libtls.suites                                      |          |List of TLS cipher suites| 
318 122 Tobias Brunner
|\3. *libtnccs section*                             |
319 122 Tobias Brunner
|libtnccs.tnc_config                                |/etc/tnc_config|TNC IMC/IMV configuration directory|
320 106 Andreas Steffen
|\3. *libimcv section*                              |
321 122 Tobias Brunner
|libimcv.assessment_result                          |yes       |Whether IMVs send a standard IETF Assessment Result attribute|
322 1 Martin Willi
|libimcv.debug_level                                |1         |Debug level for a standalone libimcv library|
323 1 Martin Willi
|libimcv.stderr_quiet                               |no        |Disable the output to stderr in a standalone libimcv library|
324 1 Martin Willi
|\3. *libimcv plugins subsection*                   |
325 1 Martin Willi
|libimcv.plugins.imc-attestation.platform_info      |          |Information on PTS IMC operating system and hardware platform|
326 106 Andreas Steffen
|libimcv.plugins.imc-attestation.aik_blob           |          |AIK encrypted private key blob file|
327 1 Martin Willi
|libimcv.plugins.imc-attestation.aik_cert           |          |AIK certificate file|
328 106 Andreas Steffen
|libimcv.plugins.imc-attestation.aik_key            |          |AIK public key file|
329 106 Andreas Steffen
|libimcv.plugins.imc-attestation.nonce_len          |20        |DH nonce length|
330 106 Andreas Steffen
|libimcv.plugins.imc-attestation.use_quote2         |yes       |Use Quote2 AIK signature instead of Quote signature|
331 106 Andreas Steffen
|libimcv.plugins.imv-attestation.cadir              |          |Path to directory with AIK cacerts|
332 106 Andreas Steffen
|libimcv.plugins.imv-attestation.database           |          |Path to database with file measurement information|
333 30 Martin Willi
|libimcv.plugins.imv-attestation.dh_group           |ecp256    |Preferred Diffie-Hellman group|
334 30 Martin Willi
|libimcv.plugins.imv-attestation.hash_algorithm     |sha256    |Preferred measurement hash algorithm|
335 30 Martin Willi
|libimcv.plugins.imv-attestation.min_nonce_len      |0         |DH minimum nonce length|
336 40 Tobias Brunner
|libimcv.plugins.imv-attestation.platform_info      |          |Information on PTS IMC operating system and hardware platform|
337 122 Tobias Brunner
|libimcv.plugins.imv-scanner.closed_port_policy     |yes       |By default all ports must be closed (yes) or can be open (no)|
338 122 Tobias Brunner
|libimcv.plugins.imv-scanner.tcp_ports              |          |List of TCP ports that can be open or must be closed|
339 122 Tobias Brunner
|libimcv.plugins.imv-scanner.udp_ports              |          |List of UDP ports that can be open or must be closed|
340 122 Tobias Brunner
|libimcv.plugins.imc-test.additional_ids            |0         |Number of additional IMC IDs|
341 1 Martin Willi
|libimcv.plugins.imc-test.command                   |none      |Command to be sent to the IMV Test|
342 122 Tobias Brunner
|libimcv.plugins.imc-test.dummy_size                |0         |Size of dummy attribute to be sent to the Test IMV (0 = disabled)|
343 1 Martin Willi
|libimcv.plugins.imc-test.retry                     |no        |Do a handshake retry|
344 1 Martin Willi
|libimcv.plugins.imc-test.retry_command             |          |Command to be sent to the IMV Test in the handshake retry|
345 1 Martin Willi
|libimcv.plugins.imv-test.rounds                    |0         |Number of IMC-IMV retry rounds|
346 1 Martin Willi
|\3. *manager section*                              |
347 1 Martin Willi
|manager.database                                   |          |Credential database URI for manager|
348 30 Martin Willi
|manager.debug                                      |no        |Enable debugging in manager|
349 30 Martin Willi
|manager.load                                       |          |Plugins to load in manager|
350 30 Martin Willi
|manager.socket                                     |          |FastCGI socket of manager, to run it statically|
351 30 Martin Willi
|manager.threads                                    |10        |Threads to use for request handling|
352 30 Martin Willi
|manager.timeout                                    |15m       |Session timeout for manager|
353 30 Martin Willi
|\3. *mediation client section*                     |
354 30 Martin Willi
|medcli.database                                    |          |Mediation client database URI|
355 73 Tobias Brunner
|medcli.dpd                                         |5m        |DPD timeout to use in mediation client plugin|
356 30 Martin Willi
|medcli.rekey                                       |20m       |Rekeying time on mediation connections in mediation client plugin|
357 40 Tobias Brunner
|\3. *mediation server section*                     |
358 87 Tobias Brunner
|medsrv.database                                    |          |Mediation server database URI|
359 73 Tobias Brunner
|medsrv.debug                                       |no        |Debugging in mediation server web application|
360 30 Martin Willi
|medsrv.dpd                                         |5m        |DPD timeout to use in mediation server plugin|
361 87 Tobias Brunner
|medsrv.load                                        |          |Plugins to load in mediation server plugin|
362 73 Tobias Brunner
|medsrv.password_length                             |6         |Minimum password length required for mediation server user accounts|
363 73 Tobias Brunner
|medsrv.rekey                                       |20m       |Rekeying time on mediation connections in mediation server plugin|
364 73 Tobias Brunner
|medsrv.socket                                      |          |Run Mediation server web application statically on socket|
365 87 Tobias Brunner
|medsrv.threads                                     |5         |Number of thread for mediation service web application|
366 73 Tobias Brunner
|medsrv.timeout                                     |15m       |Session timeout for mediation service|
367 73 Tobias Brunner
|\3. *openac section*                               |
368 30 Martin Willi
|openac.load                                        |          |Plugins to load in ipsec openac tool|
369 1 Martin Willi
|\3. *pki section*                                  |
370 61 Andreas Steffen
|pki.load                                           |          |Plugins to load in ipsec pki tool|
371 61 Andreas Steffen
|\3. *pool section*                                 |
372 1 Martin Willi
|pool.load                                          |          |Plugins to load in ipsec pool tool|
373 1 Martin Willi
|\3. *scepclient section*                           |
374 100 Tobias Brunner
|scepclient.load                                    |          |Plugins to load in ipsec scepclient tool|
375 1 Martin Willi
|\3. *starter section*                              |
376 1 Martin Willi
|starter.load                                       |          |Plugins to load in starter|
377 1 Martin Willi
|starter.load_warning                               |yes       |Disable charon/pluto plugin load option warning|