Project

General

Profile

strongswan.conf Reference » History » Version 110

Tobias Brunner, 17.02.2012 11:19
Note about man page added.

1 101 Tobias Brunner
{{title(strongswan.conf Reference)}}
2 101 Tobias Brunner
3 29 Andreas Steffen
h1. strongswan.conf
4 1 Martin Willi
5 110 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 coming 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 108 Andreas Steffen
|\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 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|
113 44 Andreas Steffen
|charon.cookie_threshold                            |10        |Number of half-open IKE_SAs that activate the cookie mechanism| 
114 87 Tobias Brunner
|charon.dns1                                        |          |DNS server 1 assigned to peer via configuration payload (CP), see [[AttrPlugin|attr plugin]]|
115 30 Martin Willi
|charon.dns2                                        |          |DNS server 2 assigned to peer via configuration payload (CP)|
116 30 Martin Willi
|charon.dos_protection                              |yes       |Enable Denial of Service protection using cookies and aggressiveness checks|
117 72 Tobias Brunner
|charon.filelog                                     |          |Section to define file loggers, see [[LoggerConfiguration]]|
118 72 Tobias Brunner
|charon.flush_auth_cfg                              |no        ||
119 97 Tobias Brunner
|charon.half_open_timeout                           |30        |Timeout in seconds for connecting IKE_SAs, also see [[JobPriority#IKE_SA_INIT-dropping|IKE_SA_INIT dropping]]|
120 30 Martin Willi
|charon.hash_and_url                                |no        |Enable hash and URL support|
121 72 Tobias Brunner
|charon.ignore_routing_tables                       |          |A list of routing tables to be excluded from route lookup|
122 59 Andreas Steffen
|charon.ikesa_table_segments                        |1         |Number of exclusively locked segments in the hash table|
123 59 Andreas Steffen
|charon.ikesa_table_size                            |1         |Size of the IKE_SA hash table|
124 59 Andreas Steffen
|charon.inactivity_close_ike                        |no        |Whether to close IKE_SA if the only CHILD_SA closed due to inactivity|
125 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]]|
126 97 Tobias Brunner
|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]]|
127 30 Martin Willi
|charon.install_routes                              |yes       |Install routes into a separate routing table for established IPsec tunnels|
128 72 Tobias Brunner
|charon.install_virtual_ip                          |yes       |Install virtual IP addresses|
129 30 Martin Willi
|charon.keep_alive                                  |20s       |NAT keep alive interval|
130 70 Tobias Brunner
|charon.load                                        |          |Plugins to load in IKEv2 charon daemon, see [[PluginLoad]]|
131 72 Tobias Brunner
|charon.max_packet                                  |10000     |Maximum packet size accepted by charon|
132 30 Martin Willi
|charon.multiple_authentication                     |yes       |Enable multiple authentication exchanges (RFC 4739)|
133 87 Tobias Brunner
|charon.nbns1                                       |          |WINS server 1 assigned to peer via configuration payload (CP), see [[AttrPlugin|attr plugin]]|
134 59 Andreas Steffen
|charon.nbns2                                       |          |WINS server 2 assigned to peer via configuration payload (CP)|
135 30 Martin Willi
|charon.process_route                               |yes       |Process RTM_NEWROUTE and RTM_DELROUTE events|
136 72 Tobias Brunner
|charon.receive_delay                               |0         |Delay for receiving packets, to simulate larger RTT|
137 72 Tobias Brunner
|charon.receive_delay_response                      |yes       |Delay response messages|
138 72 Tobias Brunner
|charon.receive_delay_request                       |yes       |Delay request messages|
139 72 Tobias Brunner
|charon.receive_delay_type                          |0         |Specific IKEv2 message type to delay, 0 for any|
140 59 Andreas Steffen
|charon.retransmit_base                             |1.8       |Base to use for calculating exponential back off, see [[Retransmission]]|
141 59 Andreas Steffen
|charon.retransmit_timeout                          |4.0       |Timeout in seconds before sending first retransmit|
142 30 Martin Willi
|charon.retransmit_tries                            |5         |Number of times to retransmit a packet before giving up|
143 47 Martin Willi
|charon.reuse_ikesa                                 |yes       |Initiate CHILD_SA within existing IKE_SAs|
144 47 Martin Willi
|charon.routing_table                               |          |Numerical routing table to install routes to|
145 47 Martin Willi
|charon.routing_table_prio                          |          |Priority of the routing table|
146 72 Tobias Brunner
|charon.send_delay                                  |0         |Delay for sending packets, to simulate larger RTT|
147 72 Tobias Brunner
|charon.send_delay_response                         |yes       |Delay response messages|
148 72 Tobias Brunner
|charon.send_delay_request                          |yes       |Delay request messages|
149 72 Tobias Brunner
|charon.send_delay_type                             |0         |Specific IKEv2 message type to delay, 0 for any|
150 50 Martin Willi
|charon.send_vendor_id                              |no        |Send strongSwan vendor ID payload|
151 72 Tobias Brunner
|charon.syslog                                      |          |Section to define syslog loggers, see [[LoggerConfiguration]]|
152 59 Andreas Steffen
|charon.threads                                     |16        |Number of worker threads in charon|
153 52 Andreas Steffen
|\3. *charon plugins subsection*                    |
154 73 Tobias Brunner
|charon.plugins.android.loglevel                    |1         |Loglevel for logging to Android specific logger|
155 87 Tobias Brunner
|charon.plugins.attr                                |          |Section to specify arbitrary attributes that are assigned to a peer via configuration payload, see [[AttrPlugin|attr plugin]]|
156 52 Andreas Steffen
|charon.plugins.dhcp.identity_lease                 |no        |Derive user-defined MAC address from hash of IKEv2 identity|
157 89 Tobias Brunner
|charon.plugins.dhcp.server                         |255.255.255.255|DHCP server unicast or broadcast IP address, see [[DHCPPlugin|DHCP plugin]]|
158 83 Tobias Brunner
|charon.plugins.duplicheck.enable                   |yes       |enable loaded [[duplicheck]] plugin|
159 1 Martin Willi
|charon.plugins.eap-aka.request_identity            |yes       ||
160 1 Martin Willi
|charon.plugins.eap-aka-3ggp2.seq_check             |          ||
161 90 Tobias Brunner
|charon.plugins.eap-gtc.pam_service                 |login     |PAM service to be used for authentication, see [[EapGtc|EAP-GTC]]|
162 84 Andreas Steffen
|charon.plugins.eap-peap.fragment_size              |1024      |Maximum size of an EAP-PEAP packet|
163 84 Andreas Steffen
|charon.plugins.eap-peap.max_message_count          |32        |Maximum number of processed EAP-PEAP packets|
164 85 Andreas Steffen
|charon.plugins.eap-peap.include_length             |no        |Include length in non-fragmented EAP-PEAP packets|
165 84 Andreas Steffen
|charon.plugins.eap-peap.phase2_method              |mschapv2  |Phase2 EAP client authentication method|
166 84 Andreas Steffen
|charon.plugins.eap-peap.phase2_piggyback           |no        |Phase2 EAP Identity request piggybacked by server onto TLS Finished message|
167 84 Andreas Steffen
|charon.plugins.eap-peap.request_peer_auth          |no        |Request peer authentication based on a client certificate|
168 104 Martin Willi
|charon.plugins.eap-radius.accounting               |no        |Enable EAP-RADIUS accounting|
169 77 Andreas Steffen
|charon.plugins.eap-radius.class_group              |no        |Use the class attribute sent in the RADIUS-Accept message as group membership information, see [[EapRadius]]|
170 1 Martin Willi
|charon.plugins.eap-radius.eap_start                |no        |Send EAP-Start instead of EAP-Identity to start RADIUS conversation|
171 77 Andreas Steffen
|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|
172 1 Martin Willi
|charon.plugins.eap-radius.id_prefix                |          |Prefix to EAP-Identity, some AAA servers use a IMSI prefix to select the EAP method|
173 1 Martin Willi
|charon.plugins.eap-radius.nas_identifier           |strongSwan|NAS-Identifier to include in RADIUS messages|
174 104 Martin Willi
|charon.plugins.eap-radius.auth_port                |1812      |Port of RADIUS server (authentication)|
175 104 Martin Willi
|charon.plugins.eap-radius.acct_port                |1813      |Port of RADIUS server (accounting)|
176 104 Martin Willi
|charon.plugins.eap-radius.port                     |1812      |Alias for _auth_port_|
177 73 Tobias Brunner
|charon.plugins.eap-radius.secret                   |          |Shared secret between RADIUS and NAS|
178 73 Tobias Brunner
|charon.plugins.eap-radius.server                   |          |IP/Hostname of RADIUS server|
179 73 Tobias Brunner
|charon.plugins.eap-radius.servers                  |          |Section to specify multiple RADIUS servers, see [[EapRadius]]|
180 73 Tobias Brunner
|charon.plugins.eap-radius.sockets                  |1         |Number of sockets (ports) to use, increase for high load|
181 52 Andreas Steffen
|charon.plugins.eap-sim.request_identity            |yes       ||
182 73 Tobias Brunner
|charon.plugins.eap-simaka-sql.database             |          ||
183 73 Tobias Brunner
|charon.plugins.eap-simaka-sql.remove_used          |          ||
184 66 Andreas Steffen
|charon.plugins.eap-tls.fragment_size               |1024      |Maximum size of an EAP-TLS packet|
185 68 Andreas Steffen
|charon.plugins.eap-tls.max_message_count           |32        |Maximum number of processed EAP-TLS packets|
186 85 Andreas Steffen
|charon.plugins.eap-tls.include_length              |yes       |Include length in non-fragmented EAP-TLS packets|
187 71 Andreas Steffen
|charon.plugins.eap-tnc.fragment_size               |50000     |Maximum size of an EAP-TNC packet|
188 76 Andreas Steffen
|charon.plugins.eap-tnc.max_message_count           |10        |Maximum number of processed EAP-TNC packets|
189 85 Andreas Steffen
|charon.plugins.eap-tnc.include_length              |yes       |Include length in non-fragmented EAP-TM
190 85 Andreas Steffen
NC packets|
191 66 Andreas Steffen
|charon.plugins.eap-ttls.fragment_size              |1024      |Maximum size of an EAP-TTLS packet|
192 1 Martin Willi
|charon.plugins.eap-ttls.max_message_count          |32        |Maximum number of processed EAP-TTLS packets|
193 85 Andreas Steffen
|charon.plugins.eap-ttls.include_length             |yes       |Include length in non-fragmented EAP-TTLS packets|
194 1 Martin Willi
|charon.plugins.eap-ttls.phase2_method              |md5       |Phase2 EAP client authentication method|
195 1 Martin Willi
|charon.plugins.eap-ttls.phase2_piggyback           |no        |Phase2 EAP Identity request piggybacked by server onto TLS Finished message|
196 76 Andreas Steffen
|charon.plugins.eap-ttls.phase2_tnc                 |no        |Start phase2 EAP TNC protocol after successful client authentication|
197 64 Andreas Steffen
|charon.plugins.eap-ttls.request_peer_auth          |no        |Request peer authentication based on a client certificate|
198 1 Martin Willi
|charon.plugins.ha.fifo_interface                   |yes       ||
199 73 Tobias Brunner
|charon.plugins.ha.heartbeat_delay                  |1000      ||
200 73 Tobias Brunner
|charon.plugins.ha.heartbeat_timeout                |2100      ||
201 41 Martin Willi
|charon.plugins.ha.local                            |          ||
202 41 Martin Willi
|charon.plugins.ha.monitor                          |yes       ||
203 73 Tobias Brunner
|charon.plugins.ha.pools                            |          ||
204 1 Martin Willi
|charon.plugins.ha.remote                           |          ||
205 1 Martin Willi
|charon.plugins.ha.resync                           |yes       ||
206 1 Martin Willi
|charon.plugins.ha.secret                           |          ||
207 1 Martin Willi
|charon.plugins.ha.segment_count                    |1         ||
208 73 Tobias Brunner
|charon.plugins.led.activity_led                    |          ||
209 73 Tobias Brunner
|charon.plugins.led.blink_time                      |50        ||
210 73 Tobias Brunner
|charon.plugins.kernel-klips.ipsec_dev_count        |4         |Number of ipsecN devices|
211 1 Martin Willi
|charon.plugins.kernel-klips.ipsec_dev_mtu          |0         |Set MTU of ipsecN device|
212 73 Tobias Brunner
|charon.plugins.load-tester.child_rekey             |600       |Seconds to start CHILD_SA rekeying after setup|
213 73 Tobias Brunner
|charon.plugins.load-tester.delay                   |0         |Delay between initiatons for each thread|
214 73 Tobias Brunner
|charon.plugins.load-tester.delete_after_established|no        |Delete an IKE_SA as soon as it has been established|
215 94 Tobias Brunner
|charon.plugins.load-tester.dpd_delay               |0         |DPD delay to use in load test|
216 73 Tobias Brunner
|charon.plugins.load-tester.dynamic_port            |0         |Base port to be used for requests (each client uses a different port)|
217 94 Tobias Brunner
|charon.plugins.load-tester.eap_password            |default-pwd|EAP secret to use in load test|
218 1 Martin Willi
|charon.plugins.load-tester.enable                  |no        |Enable the load testing plugin. Read [[LoadTests]] first!|
219 73 Tobias Brunner
|charon.plugins.load-tester.fake_kernel             |no        |Fake the kernel interface to allow load-testing against self|
220 73 Tobias Brunner
|charon.plugins.load-tester.ike_rekey               |0         |Seconds to start IKE_SA rekeying after setup|
221 94 Tobias Brunner
|charon.plugins.load-tester.init_limit              |0         |Global limit of concurrently established SAs during load test|
222 1 Martin Willi
|charon.plugins.load-tester.initiators              |0         |Number of concurrent initiator threads to use in load test|
223 73 Tobias Brunner
|charon.plugins.load-tester.initiator_auth          |pubkey    |Authentication method(s) the intiator uses|
224 94 Tobias Brunner
|charon.plugins.load-tester.initiator_id            |          |Initiator ID to use in load test|
225 41 Martin Willi
|charon.plugins.load-tester.iterations              |1         |Number of IKE_SAs to initate to self by each initiator in load test|
226 73 Tobias Brunner
|charon.plugins.load-tester.pool                    |          |Provide INTERNAL_IPV4_ADDRs from a named pool|
227 94 Tobias Brunner
|charon.plugins.load-tester.preshared_key           |default-psk|Preshared key to use in load test|
228 74 Tobias Brunner
|charon.plugins.load-tester.proposal                |aes128-sha1-modp768|IKE proposal to use in load test|
229 73 Tobias Brunner
|charon.plugins.load-tester.remote                  |127.0.0.1 |Address to initiation connections to|
230 41 Martin Willi
|charon.plugins.load-tester.responder_auth          |pubkey    |Authentication method(s) the responder uses|
231 94 Tobias Brunner
|charon.plugins.load-tester.responder_id            |          |Responder ID to use in load test|
232 41 Martin Willi
|charon.plugins.load-tester.request_virtual_ip      |no        |Request an INTERNAL_IPV4_ADDR from the server|
233 73 Tobias Brunner
|charon.plugins.load-tester.shutdown_when_complete  |no        |Shutdown the daemon after all IKE_SAs have been established|
234 41 Martin Willi
|charon.plugins.resolve.file                        |/etc/resolv.conf|File where to add DNS server entries|
235 1 Martin Willi
|charon.plugins.sql.database                        |          |Database URI for charons [[SQL]] plugin|
236 1 Martin Willi
|charon.plugins.sql.loglevel                        |-1        |Loglevel for logging to [[SQL]] database|
237 105 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.|
238 103 Tobias Brunner
|charon.plugins.stroke.max_concurrent               |4         |Maximum number of stroke messages handled concurrently|
239 1 Martin Willi
|charon.plugins.tnc-ifmap.device_name               |          |Unique name as a PEP and/or PDP device|
240 99 Andreas Steffen
|charon.plugins.tnc-ifmap.key_file                  |          |Concatenated client certificate and private key|
241 98 Andreas Steffen
|charon.plugins.tnc-ifmap.password                  |          |Authentication password of MAP client|
242 1 Martin Willi
|charon.plugins.tnc-ifmap.server_cert               |          |Certificate of MAP server|
243 99 Andreas Steffen
|charon.plugins.tnc-ifmap.ssl_passphrase            |          |Passphrase protecting private key|
244 98 Andreas Steffen
|charon.plugins.tnc-ifmap.username                  |          |Authentication usernameof of MAP client|
245 1 Martin Willi
|charon.plugins.tnc_imc.preferred_language          |en        |Preferred language for TNC recommendations|  
246 98 Andreas Steffen
|charon.plugins.tnc-imv.tnc_config                  |/etc/tnc_config|TNC IMC configuration directory|
247 98 Andreas Steffen
|charon.plugins.tnc-imc.tnc_config                  |/etc/tnc_config|TNC IMV configuration directory|
248 60 Andreas Steffen
|charon.plugins.whitelist.enable                    |yes       |enable loaded [[whitelist]] plugin|
249 73 Tobias Brunner
|\3. *libstrongswan section*                        |
250 73 Tobias Brunner
|libstrongswan.crypto_test.bench                    |no        ||
251 73 Tobias Brunner
|libstrongswan.crypto_test.bench_size               |1024      ||
252 73 Tobias Brunner
|libstrongswan.crypto_test.bench_time               |50        ||
253 1 Martin Willi
|libstrongswan.crypto_test.on_add                   |no        |Test crypto algorithms during registration|
254 40 Tobias Brunner
|libstrongswan.crypto_test.on_create                |no        |Test crypto algorithms on each crypto primitive instantiation|
255 32 Andreas Steffen
|libstrongswan.crypto_test.required                 |no        |Strictly require at least one test vector to enable an algorithm|
256 73 Tobias Brunner
|libstrongswan.crypto_test.rng_true                 |no        |Whether to test RNG with TRUE quality; requires a lot of entropy|
257 36 Martin Willi
|libstrongswan.dh_exponent_ansi_x9_42               |yes       |Use ANSI X9.42 DH exponent size or optimum size matched to cryptographical strength|
258 1 Martin Willi
|libstrongswan.ecp_x_coordinate_only                |yes       |Compliance with the errata for RFC 4753 | 
259 73 Tobias Brunner
|libstrongswan.integrity_test                       |no        |Check daemon, libstrongswan and plugin integrity at startup|
260 96 Tobias Brunner
|libstrongswan.leak_detective.detailed              |yes       |Includes source file names and line numbers in leak detective output|
261 79 Andreas Steffen
|libstrongswan.processor.priority_threads           |          |Subsection to configure the number of reserved threads per priority class (see [[JobPriority]])|
262 57 Andreas Steffen
|libstrongswan.x509.enforce_critical                |yes       |Discard certificates with unsupported or unknown critical extensions|
263 88 Tobias Brunner
|\3. *libstrongswan plugins subsection*             |
264 1 Martin Willi
|libstrongswan.plugins.attr-sql.database            |          |Database URI for the [[attrsql|attr-sql plugin]] used by charon and pluto |
265 40 Tobias Brunner
|libstrongswan.plugins.attr-sql.lease_history       |yes       |Enable logging of [[SQL]] IP pool leases|
266 71 Andreas Steffen
|libstrongswan.plugins.gcrypt.quick_random          |no        |Use faster random numbers in gcrypt; for testing only, produces weak keys!|
267 80 Tobias Brunner
|libstrongswan.plugins.openssl.engine_id            |pkcs11    |ENGINE ID to use in the OpenSSL plugin|
268 80 Tobias Brunner
|libstrongswan.plugins.pkcs11.modules               |          |List of available PKCS#11 modules, see [[SmartCardsIKEv2]]|
269 102 Tobias Brunner
|libstrongswan.plugins.pkcs11.use_dh                |no        |Whether the PKCS#11 modules should be used for DH and ECDH|
270 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|
271 30 Martin Willi
|libstrongswan.plugins.pkcs11.use_hasher            |no        |Whether the PKCS#11 modules should be used to hash data|
272 102 Tobias Brunner
|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|
273 102 Tobias Brunner
|libstrongswan.plugins.pkcs11.use_rng               |no        |Whether the PKCS#11 modules should be used as RNG|
274 30 Martin Willi
|\3. *libtls section*                               |
275 30 Martin Willi
|libtls.cipher                                      |          |List of TLS encryption ciphers| 
276 30 Martin Willi
|libtls.key_exchange                                |          |List of TLS key exchange methods| 
277 30 Martin Willi
|libtls.mac                                         |          |List of TLS MAC algorithms| 
278 91 Andreas Steffen
|libtls.suites                                      |          |List of TLS cipher suites| 
279 92 Andreas Steffen
|\3. *libimcv section*                              |
280 92 Andreas Steffen
|libimcv.debug_level                                |1         |Debug level for a standalone libimcv library|
281 92 Andreas Steffen
|libimcv.stderr_quiet                               |no        |Disable the output to stderr in a standalone libimcv library|
282 92 Andreas Steffen
|\3. *libimcv plugins subsection*                   |
283 106 Andreas Steffen
|libimcv.plugins.imc-attestation.platform_info      |          |Information on PTS IMC operating system and hardware platform|
284 106 Andreas Steffen
|libimcv.plugins.imc-attestation.aik_blob           |          |AIK encrypted private key blob file|
285 106 Andreas Steffen
|libimcv.plugins.imc-attestation.aik_cert           |          |AIK certificate file|
286 106 Andreas Steffen
|libimcv.plugins.imc-attestation.aik_key            |          |AIK public key file|
287 106 Andreas Steffen
|libimcv.plugins.imc-attestation.nonce_len          |20        |DH nonce length|
288 109 Andreas Steffen
|libimcv.plugins.imc-attestation.use_quote2         |yes       |Use Quote2 AIK signature instead of Quote signature|
289 106 Andreas Steffen
|libimcv.plugins.imv-attestation.cadir              |          |Path to directory with AIK cacerts|
290 106 Andreas Steffen
|libimcv.plugins.imv-attestation.database           |          |Path to database with file measurement information|
291 106 Andreas Steffen
|libimcv.plugins.imv-attestation.dh_group           |ecp256    |Preferred Diffie-Hellman group|
292 106 Andreas Steffen
|libimcv.plugins.imv-attestation.hash_algorithm     |sha256    |Preferred measurement hash algorithm|
293 109 Andreas Steffen
|libimcv.plugins.imv-attestation.min_nonce_len      |0         |DH minimum nonce length|
294 106 Andreas Steffen
|libimcv.plugins.imv-attestation.platform_info      |          |Information on PTS IMC operating system and hardware platform|
295 106 Andreas Steffen
|libimcv.plugins.imc-test.command                   |none      |Command to be sent to the IMV Test|
296 106 Andreas Steffen
|libimcv.plugins.imc-test.retry                     |no        |Do a handshake retry|
297 106 Andreas Steffen
|libimcv.plugins.imc-test.retry_command             |          |Command to be sent to the IMV Test in the handshake retry|
298 106 Andreas Steffen
|libimcv.plugins.imv-test.rounds                    |0         |Number of IMC-IMV retry rounds|
299 106 Andreas Steffen
|libimcv.plugins.imv-scanner.closed_port_policy     |yes       |By default all ports must be closed (yes) or can be open (no)|
300 106 Andreas Steffen
|libimcv.plugins.imv-scanner.tcp_ports              |          |List of TCP ports that can be open or must be closed|
301 106 Andreas Steffen
|libimcv.plugins.imv-scanner.udp_ports              |          |List of UDP ports that can be open or must be closed|
302 30 Martin Willi
|\3. *manager section*                              |
303 30 Martin Willi
|manager.database                                   |          |Credential database URI for manager|
304 30 Martin Willi
|manager.debug                                      |no        |Enable debugging in manager|
305 40 Tobias Brunner
|manager.load                                       |          |Plugins to load in manager|
306 30 Martin Willi
|manager.socket                                     |          |FastCGI socket of manager, to run it statically|
307 30 Martin Willi
|manager.threads                                    |10        |Threads to use for request handling|
308 1 Martin Willi
|manager.timeout                                    |15m       |Session timeout for manager|
309 1 Martin Willi
|\3. *mediation client section*                     |
310 1 Martin Willi
|medcli.database                                    |          |Mediation client database URI|
311 1 Martin Willi
|medcli.dpd                                         |5m        |DPD timeout to use in mediation client plugin|
312 1 Martin Willi
|medcli.rekey                                       |20m       |Rekeying time on mediation connections in mediation client plugin|
313 1 Martin Willi
|\3. *mediation server section*                     |
314 1 Martin Willi
|medsrv.database                                    |          |Mediation server database URI|
315 1 Martin Willi
|medsrv.debug                                       |no        |Debugging in mediation server web application|
316 1 Martin Willi
|medsrv.dpd                                         |5m        |DPD timeout to use in mediation server plugin|
317 30 Martin Willi
|medsrv.load                                        |          |Plugins to load in mediation server plugin|
318 30 Martin Willi
|medsrv.password_length                             |6         |Minimum password length required for mediation server user accounts|
319 30 Martin Willi
|medsrv.rekey                                       |20m       |Rekeying time on mediation connections in mediation server plugin|
320 30 Martin Willi
|medsrv.socket                                      |          |Run Mediation server web application statically on socket|
321 30 Martin Willi
|medsrv.threads                                     |5         |Number of thread for mediation service web application|
322 30 Martin Willi
|medsrv.timeout                                     |15m       |Session timeout for mediation service|
323 30 Martin Willi
|\3. *openac section*                               |
324 73 Tobias Brunner
|openac.load                                        |          |Plugins to load in ipsec openac tool|
325 30 Martin Willi
|\3. *pki section*                                  |
326 40 Tobias Brunner
|pki.load                                           |          |Plugins to load in ipsec pki tool|
327 87 Tobias Brunner
|\3. *pluto section*                                |
328 73 Tobias Brunner
|pluto.dns1                                         |          |DNS server 1 assigned to peer via Mode Config, see [[AttrPlugin|attr plugin]]|
329 30 Martin Willi
|pluto.dns2                                         |          |DNS server 2 assigned to peer via Mode Config|
330 87 Tobias Brunner
|pluto.load                                         |          |Plugins to load in IKEv1 pluto daemon, also see [[PluginLoad]]|
331 73 Tobias Brunner
|pluto.nbns1                                        |          |WINS server 1 assigned to peer via Mode Config, see [[AttrPlugin|attr plugin]]|
332 73 Tobias Brunner
|pluto.nbns2                                        |          |WINS server 2 assigned to peer via Mode Config|
333 73 Tobias Brunner
|pluto.threads                                      |4         |Number of worker threads in pluto|
334 87 Tobias Brunner
|\3. *pluto plugins section*                        |
335 73 Tobias Brunner
|pluto.plugins.attr                                 |          |Section to specify arbitrary attributes that are assigned to a peer via Mode Config, see [[AttrPlugin|attr plugin]]|
336 73 Tobias Brunner
|pluto.plugins.kernel-klips.ipsec_dev_count         |4         |Number of ipsecN devices|
337 30 Martin Willi
|pluto.plugins.kernel-klips.ipsec_dev_mtu           |0         |Set MTU of ipsecN device|
338 1 Martin Willi
|\3. *pool section*                                 |
339 61 Andreas Steffen
|pool.load                                          |          |Plugins to load in ipsec pool tool|
340 61 Andreas Steffen
|\3. *scepclient section*                           |
341 1 Martin Willi
|scepclient.load                                    |          |Plugins to load in ipsec scepclient tool|
342 1 Martin Willi
|\3. *starter section*                              |
343 100 Tobias Brunner
|starter.load                                       |          |Plugins to load in starter|
344 1 Martin Willi
|starter.load_warning                               |yes       |Disable charon/pluto plugin load option warning|