kernel: Add option to control DS field behavior
[strongswan.git] / src / swanctl / swanctl.opt
1 connections { # }
2         Section defining IKE connection configurations.
3
4         Section defining IKE connection configurations.
5
6         The connections section defines IKE connection configurations, each in
7         its own subsections. In the keyword description below, the connection
8         is named _<conn>_, but an arbitrary yet unique connection name can be
9         chosen for each connection subsection.
10
11 connections.<conn> { # }
12         Section for an IKE connection named <conn>.
13
14 connections.<conn>.version = 0
15         IKE major version to use for connection.
16
17         IKE major version to use for connection. _1_ uses IKEv1 aka ISAKMP, _2_
18         uses IKEv2. A connection using the default of _0_ accepts both IKEv1
19         and IKEv2 as responder, and initiates the connection actively with IKEv2.
20
21 connections.<conn>.local_addrs = %any
22         Local address(es) to use for IKE communication, comma separated.
23
24         Local address(es) to use for IKE communication, comma separated. Takes
25         single IPv4/IPv6 addresses, DNS names, CIDR subnets or IP address ranges.
26
27         As initiator, the first non-range/non-subnet is used to initiate the
28         connection from. As responder, the local destination address must match at
29         least to one of the specified addresses, subnets or ranges.
30
31         If FQDNs are assigned they are resolved every time a configuration lookup
32         is done. If DNS resolution times out, the lookup is delayed for that time.
33
34 connections.<conn>.remote_addrs = %any
35         Remote address(es) to use for IKE communication, comma separated.
36
37         Remote address(es) to use for IKE communication, comma separated. Takes
38         single IPv4/IPv6 addresses, DNS names, CIDR subnets or IP address ranges.
39
40         As initiator, the first non-range/non-subnet is used to initiate the
41         connection to. As responder, the initiator source address must match at
42         least to one of the specified addresses, subnets or ranges.
43
44         If FQDNs are assigned they are resolved every time a configuration lookup
45         is done. If DNS resolution times out, the lookup is delayed for that time.
46
47         To initiate a connection, at least one specific address or DNS name must
48         be specified.
49
50 connections.<conn>.local_port = 500
51         Local UDP port for IKE communication.
52
53         Local UDP port for IKE communication. By default the port of the socket
54         backend is used, which is usually _500_. If port _500_ is used, automatic
55         IKE port floating to port 4500 is used to work around NAT issues.
56
57         Using a non-default local IKE port requires support from the socket backend
58         in use (socket-dynamic).
59
60 connections.<conn>.remote_port = 500
61         Remote UDP port for IKE communication.
62
63         Remote UDP port for IKE communication. If the default of port _500_ is used,
64         automatic IKE port floating to port 4500 is used to work around NAT issues.
65
66 connections.<conn>.proposals = default
67         Comma separated proposals to accept for IKE.
68
69         A proposal is a set of algorithms. For non-AEAD algorithms, this includes
70         for IKE an encryption algorithm, an integrity algorithm, a pseudo random
71         function and a Diffie-Hellman group. For AEAD algorithms, instead of
72         encryption and integrity algorithms, a combined algorithm is used.
73
74         In IKEv2, multiple algorithms of the same kind can be specified in a single
75         proposal, from which one gets selected. In IKEv1, only one algorithm per
76         kind is allowed per proposal, more algorithms get implicitly stripped. Use
77         multiple proposals to offer different algorithms combinations in IKEv1.
78
79         Algorithm keywords get separated using dashes. Multiple proposals may be
80         separated by commas. The special value _default_ forms a default proposal
81         of supported algorithms considered safe, and is usually a good choice
82         for interoperability.
83
84 connections.<conn>.vips =
85         Virtual IPs to request in configuration payload / Mode Config.
86
87         Comma separated list of virtual IPs to request in IKEv2 configuration
88         payloads or IKEv1 Mode Config. The wildcard addresses _0.0.0.0_ and _::_
89         request an arbitrary address, specific addresses may be defined. The
90         responder may return a different address, though, or none at all.
91
92 connections.<conn>.aggressive = no
93         Use Aggressive Mode in IKEv1.
94
95         Enables Aggressive Mode instead of Main Mode with Identity Protection.
96         Aggressive Mode is considered less secure, because the ID and HASH
97         payloads are exchanged unprotected. This allows a passive attacker to
98         snoop peer identities, and even worse, start dictionary attacks on the
99         Preshared Key.
100
101 connections.<conn>.pull = yes
102         Set the Mode Config mode to use.
103
104         If the default of _yes_ is used, Mode Config works in pull mode, where
105         the initiator actively requests a virtual IP. With _no_, push mode is used,
106         where the responder pushes down a virtual IP to the initiating peer.
107
108         Push mode is currently supported for IKEv1, but not in IKEv2. It is used
109         by a few implementations only, pull mode is recommended.
110
111 connections.<conn>.dscp = 000000
112         Differentiated Services Field Codepoint to set on outgoing IKE packets (six
113         binary digits).
114
115         Differentiated Services Field Codepoint to set on outgoing IKE packets for
116         this connection. The value is a six digit binary encoded string specifying
117         the Codepoint to set, as defined in RFC 2474.
118
119 connections.<conn>.encap = no
120         Enforce UDP encapsulation by faking NAT-D payloads.
121
122         To enforce UDP encapsulation of ESP packets, the IKE daemon can fake the
123         NAT detection payloads. This makes the peer believe that NAT takes
124         place on the path, forcing it to encapsulate ESP packets in UDP.
125
126         Usually this is not required, but it can help to work around connectivity
127         issues with too restrictive intermediary firewalls.
128
129 connections.<conn>.mobike = yes
130         Enables MOBIKE on IKEv2 connections.
131
132         Enables MOBIKE on IKEv2 connections. MOBIKE is enabled by default on IKEv2
133         connections, and allows mobility of clients and multi-homing on servers by
134         migrating active IPsec tunnels.
135
136         Usually keeping MOBIKE enabled is unproblematic, as it is not used if the
137         peer does not indicate support for it. However, due to the design of MOBIKE,
138         IKEv2 always floats to port 4500 starting from the second exchange. Some
139         implementations don't like this behavior, hence it can be disabled.
140
141 connections.<conn>.dpd_delay = 0s
142         Interval of liveness checks (DPD).
143
144         Interval to check the liveness of a peer actively using IKEv2 INFORMATIONAL
145         exchanges or IKEv1 R_U_THERE messages. Active DPD checking is only enforced
146         if no IKE or ESP/AH packet has been received for the configured DPD delay.
147
148 connections.<conn>.dpd_timeout = 0s
149         Timeout for DPD checks (IKEV1 only).
150
151         Charon by default uses the normal retransmission mechanism and timeouts to
152         check the liveness of a peer, as all messages are used for liveness
153         checking. For compatibility reasons, with IKEv1 a custom interval may be
154         specified; this option has no effect on connections using IKE2.
155
156 connections.<conn>.fragmentation = yes
157         Use IKE UDP datagram fragmentation.  (_yes_, _accept_, _no_ or _force_).
158
159         Use IKE fragmentation (proprietary IKEv1 extension or RFC 7383 IKEv2
160         fragmentation).  Acceptable  values  are _yes_ (the     default), _accept_,
161         _force_ and _no_. If set to _yes_, and the peer supports it, oversized IKE
162         messages will be sent in fragments. If set to _accept_, support for
163         fragmentation is announced to the peer but the daemon does not send its own
164         messages in fragments.  If set to _force_ (only supported for IKEv1) the
165         initial IKE message will already be fragmented if required. Finally, setting
166         the option to _no_ will disable announcing support for this feature.
167
168         Note that fragmented IKE messages sent by a peer are always accepted
169         irrespective of the value of this option (even when set to _no_).
170
171 connections.<conn>.send_certreq = yes
172         Send certificate requests payloads (_yes_ or _no_).
173
174         Send certificate request payloads to offer trusted root CA certificates
175         to the peer. Certificate requests help the peer to choose an appropriate
176         certificate/private key for authentication and are enabled by default.
177
178         Disabling certificate requests can be useful if too many trusted root CA
179         certificates are installed, as each certificate request increases the size
180         of the initial IKE packets.
181
182 connections.<conn>.send_cert = ifasked
183         Send certificate payloads (_always_, _never_ or _ifasked_).
184
185         Send certificate payloads when using certificate authentication. With the
186         default of _ifasked_ the daemon sends certificate payloads only if
187         certificate requests have been received. _never_ disables sending of
188         certificate payloads altogether, _always_ causes certificate payloads to be
189         sent unconditionally whenever certificate authentication is used.
190
191 connections.<conn>.keyingtries = 1
192         Number of retransmission sequences to perform during initial connect.
193
194         Number of retransmission sequences to perform during initial connect.
195         Instead of giving up initiation after the first retransmission sequence with
196         the default value of _1_, additional sequences may be started according to
197         the configured value. A value of _0_ initiates a new sequence until the
198         connection establishes or fails with a permanent error.
199
200 connections.<conn>.unique = no
201         Connection uniqueness policy (_never_, _no_, _keep_ or _replace_).
202
203         Connection uniqueness policy to enforce. To avoid multiple connections
204         from the same user, a uniqueness policy can be enforced. The value _never_
205         does never enforce such a policy, even if a peer included INITIAL_CONTACT
206         notification messages, whereas _no_ replaces existing connections for the
207         same identity if a new one has the INITIAL_CONTACT notify. _keep_ rejects
208         new connection attempts if the same user already has an active connection,
209         _replace_ deletes any existing connection if a new one for the same user
210         gets established.
211
212         To compare connections for uniqueness, the remote IKE identity is used. If
213         EAP or XAuth authentication is involved, the EAP-Identity or XAuth username
214         is used to enforce the uniqueness policy instead.
215
216         On initiators this setting specifies whether an INITIAL_CONTACT notify is
217         sent during IKE_AUTH if no existing connection is found with the remote
218         peer (determined by the identities of the first authentication round).
219         Unless set to _never_ the client will send a notify.
220
221 connections.<conn>.reauth_time = 0s
222         Time to schedule IKE reauthentication.
223
224         Time to schedule IKE reauthentication. IKE reauthentication recreates the
225         IKE/ISAKMP SA from scratch and re-evaluates the credentials. In asymmetric
226         configurations (with EAP or configuration payloads) it might not be possible
227         to actively reauthenticate as responder. The IKEv2 reauthentication lifetime
228         negotiation can instruct the client to perform reauthentication.
229
230         Reauthentication is disabled by default. Enabling it usually may lead
231         to small connection interruptions, as strongSwan uses a break-before-make
232         policy with IKEv2 to avoid any conflicts with associated tunnel resources.
233
234 connections.<conn>.rekey_time = 4h
235         Time to schedule IKE rekeying.
236
237         IKE rekeying refreshes key material using a Diffie-Hellman exchange, but
238         does not re-check associated credentials. It is supported in IKEv2 only,
239         IKEv1 performs a reauthentication procedure instead.
240
241         With the default value IKE rekeying is scheduled every 4 hours, minus the
242         configured **rand_time**. If a **reauth_time** is configured, **rekey_time**
243         defaults to zero disabling rekeying; explicitly set both to enforce
244         rekeying and reauthentication.
245
246 connections.<conn>.over_time = 10% of rekey_time/reauth_time
247         Hard IKE_SA lifetime if rekey/reauth does not complete, as time.
248
249         Hard IKE_SA lifetime if rekey/reauth does not complete, as time.
250         To avoid having an IKE/ISAKMP kept alive if IKE reauthentication or rekeying
251         fails perpetually, a maximum hard lifetime may be specified. If the
252         IKE_SA fails to rekey or reauthenticate within the specified time, the
253         IKE_SA gets closed.
254
255         In contrast to CHILD_SA rekeying, **over_time** is relative in time to the
256         **rekey_time** _and_ **reauth_time** values, as it applies to both.
257
258         The default is 10% of the longer of **rekey_time** and **reauth_time**.
259
260 connections.<conn>.rand_time = over_time
261         Range of random time to subtract from rekey/reauth times.
262
263         Time range from which to choose a random value to subtract from
264         rekey/reauth times. To avoid having both peers initiating the rekey/reauth
265         procedure simultaneously, a random time gets subtracted from the
266         rekey/reauth times.
267
268         The default is equal to the configured **over_time**.
269
270 connections.<conn>.pools =
271         Comma separated list of named IP pools.
272
273         Comma separated list of named IP pools to allocate virtual IP addresses and
274         other configuration attributes from. Each name references a pool by name
275         from either the **pools** section or an external pool.
276
277 connections.<conn>.mediation = no
278         Whether this connection is a mediation connection.
279
280         Whether this connection is a mediation connection, that is, whether this
281         connection is used to mediate other connections using the IKEv2 Mediation
282         Extension.  Mediation connections create no CHILD_SA.
283
284 connections.<conn>.mediated_by =
285         The name of the connection to mediate this connection through.
286
287         The name of the connection to mediate this connection through. If given, the
288         connection will be mediated through the named mediation connection.
289         The     mediation connection must have **mediation** enabled.
290
291 connections.<conn>.mediation_peer =
292         Identity under which the peer is registered at the mediation server.
293
294         Identity under which the peer is registered at the mediation server, that
295         is, the IKE identity the other end of this connection uses as its local
296         identity on its connection to the mediation server. This is the identity we
297         request the mediation server to mediate us with. Only relevant on
298         connections that set **mediated_by**. If it is not given, the remote IKE
299         identity of the first authentication round of this connection will be used.
300
301 connections.<conn>.local<suffix> {}
302         Section for a local authentication round.
303
304         Section for a local authentication round. A local authentication round
305         defines the rules how authentication is performed for the local peer.
306         Multiple rounds may be defined to use IKEv2 RFC 4739 Multiple Authentication
307         or IKEv1 XAuth.
308
309         Each round is defined in a section having _local_ as prefix, and an optional
310         unique suffix. To define a single authentication round, the suffix may be
311         omitted.
312
313 connections.<conn>.local<suffix>.round = 0
314         Optional numeric identifier by which authentication rounds are sorted.  If
315         not specified rounds are ordered by their position in the config file/VICI
316         message.
317
318 connections.<conn>.local<suffix>.certs =
319         Comma separated list of certificate candidates to use for authentication.
320
321         Comma separated list of certificate candidates to use for authentication.
322         The certificates may use a relative path from the **swanctl** _x509_
323         directory or an absolute path.
324
325         The certificate used for authentication is selected based on the received
326         certificate request payloads. If no appropriate CA can be located, the
327         first certificate is used.
328
329 connections.<conn>.local<suffix>.cert<suffix> =
330         Section for a certificate candidate to use for authentication.
331
332         Section for a certificate candidate to use for authentication. Certificates
333         in _certs_ are transmitted as binary blobs, these sections offer more
334         flexibility.
335
336 connections.<conn>.local<suffix>.cert<suffix>.file =
337         Absolute path to the certificate to load.
338
339         Absolute path to the certificate to load. Passed as-is to the daemon, so it
340         must be readable by it.
341
342         Configure either this or _handle_, but not both, in one section.
343
344 connections.<conn>.local<suffix>.cert<suffix>.handle =
345         Hex-encoded CKA_ID of the certificate on a token.
346
347         Hex-encoded CKA_ID of the certificate on a token.
348
349         Configure either this or _file_, but not both, in one section.
350
351 connections.<conn>.local<suffix>.cert<suffix>.slot =
352         Optional slot number of the token that stores the certificate.
353
354 connections.<conn>.local<suffix>.cert<suffix>.module =
355         Optional PKCS#11 module name.
356
357 connections.<conn>.local<suffix>.pubkeys =
358         Comma separated list of raw public key candidates to use for authentication.
359
360         Comma separated list of raw public key candidates to use for authentication.
361         The public keys may use a relative path from the **swanctl** _pubkey_
362         directory or an absolute path.
363
364         Even though multiple local public keys could be defined in principle, only
365         the     first public key in the list is used for authentication.
366
367 connections.<conn>.local<suffix>.auth = pubkey
368         Authentication to perform locally (_pubkey_, _psk_, _xauth[-backend]_ or
369         _eap[-method]_).
370
371         Authentication to perform locally. _pubkey_ uses public key authentication
372         using a private key associated to a usable certificate. _psk_ uses
373         pre-shared key authentication. The IKEv1 specific _xauth_ is used for
374         XAuth or Hybrid authentication, while the IKEv2 specific _eap_ keyword
375         defines EAP authentication.
376
377         For _xauth_, a specific backend name may be appended, separated by a dash.
378         The appropriate _xauth_ backend is selected to perform the XAuth exchange.
379         For traditional XAuth, the _xauth_ method is usually defined in the second
380         authentication round following an initial _pubkey_ (or _psk_) round. Using
381         _xauth_ in the first round performs Hybrid Mode client authentication.
382
383         For _eap_, a specific EAP method name may be appended, separated by a dash.
384         An EAP module implementing the appropriate method is selected to perform
385         the EAP conversation.
386
387         If both peers support RFC 7427 ("Signature Authentication in IKEv2")
388         specific hash algorithms to be used during IKEv2 authentication may be
389         configured. To do so use _ike:_ followed by a trust chain signature scheme
390         constraint (see description of the **remote** section's **auth** keyword).
391         For example, with _ike:pubkey-sha384-sha256_ a public key signature scheme
392         with either SHA-384 or SHA-256 would get used for authentication, in that
393         order and depending on the hash algorithms supported by the peer. If no
394         specific hash algorithms are configured, the default is to prefer an
395         algorithm that matches or exceeds the strength of the signature key.
396         If no constraints with _ike:_ prefix are configured any signature scheme
397         constraint (without _ike:_ prefix) will also apply to IKEv2 authentication,
398         unless this is disabled in **strongswan.conf**(5). To use RSASSA-PSS
399         signatures use _rsa/pss_ instead of _pubkey_ or _rsa_ as in e.g.
400         _ike:rsa/pss-sha256_. If _pubkey_ or _rsa_ constraints are configured
401         RSASSA-PSS signatures will only be used if enabled in
402         **strongswan.conf**(5).
403
404 connections.<conn>.local<suffix>.id =
405         IKE identity to use for authentication round.
406
407         IKE identity to use for authentication round. When using certificate
408         authentication, the IKE identity must be contained in the certificate,
409         either as subject or as subjectAltName.
410
411         The identity can be an IP address, a fully-qualified domain name, an email
412         address or a Distinguished Name for which the ID type is determined
413         automatically and the string is converted to the appropriate encoding. To
414         enforce a specific identity type, a prefix may be used, followed by a colon
415         (:). If the number sign (#) follows the colon, the remaining data is
416         interpreted as hex encoding, otherwise the string is used as-is as the
417         identification data. Note that this implies that no conversion is performed
418         for non-string identities. For example, _ipv4:10.0.0.1_ does not create a
419         valid ID_IPV4_ADDR IKE identity, as it does not get converted to binary
420         0x0a000001. Instead, one could use _ipv4:#0a000001_ to get a valid identity,
421         but just using the implicit type with automatic conversion is usually
422         simpler. The same applies to the ASN1 encoded types. The following prefixes
423         are known: _ipv4_, _ipv6_, _rfc822_, _email_, _userfqdn_, _fqdn_, _dns_,
424         _asn1dn_, _asn1gn_ and _keyid_. Custom type prefixes may be specified by
425         surrounding the numerical type value by curly brackets.
426
427 connections.<conn>.local<suffix>.eap_id = id
428         Client EAP-Identity to use in EAP-Identity exchange and the EAP method.
429
430 connections.<conn>.local<suffix>.aaa_id = remote-id
431         Server side EAP-Identity to expect in the EAP method.
432
433         Server side EAP-Identity to expect in the EAP method. Some EAP methods, such
434         as EAP-TLS, use an identity for the server to perform mutual authentication.
435         This identity may differ from the IKE identity, especially when EAP
436         authentication is delegated from the IKE responder to an AAA backend.
437
438         For EAP-(T)TLS, this defines the identity for which the server must provide
439         a certificate in the TLS exchange.
440
441 connections.<conn>.local<suffix>.xauth_id = id
442         Client XAuth username used in the XAuth exchange.
443
444 connections.<conn>.remote<suffix> {}
445         Section for a remote authentication round.
446
447         Section for a remote authentication round. A remote authentication round
448         defines the constraints how the peers must authenticate to use this
449         connection. Multiple rounds may be defined to use IKEv2 RFC 4739 Multiple
450         Authentication or IKEv1 XAuth.
451
452         Each round is defined in a section having _remote_ as prefix, and an
453         optional unique suffix. To define a single authentication round, the suffix
454         may be omitted.
455
456 connections.<conn>.remote<suffix>.round = 0
457         Optional numeric identifier by which authentication rounds are sorted.  If
458         not specified rounds are ordered by their position in the config file/VICI
459         message.
460
461 connections.<conn>.remote<suffix>.id = %any
462         IKE identity to expect for authentication round.
463
464         IKE identity to expect for authentication round. Refer to the _local_ _id_
465         section for details.
466
467 connections.<conn>.remote<suffix>.eap_id = id
468         Identity to use as peer identity during EAP authentication.
469
470         Identity to use as peer identity during EAP authentication. If set to _%any_
471         the EAP-Identity method will be used to ask the client for an identity.
472
473 connections.<conn>.remote<suffix>.groups =
474         Authorization group memberships to require.
475
476         Comma separated authorization group memberships to require. The peer must
477         prove membership to at least one of the specified groups. Group membership
478         can be certified by different means, for example by appropriate Attribute
479         Certificates or by an AAA backend involved in the authentication.
480
481 connections.<conn>.remote<suffix>.cert_policy =
482         Certificate policy OIDs the peer's certificate must have.
483
484         Comma separated list of certificate policy OIDs the peer's certificate must
485         have. OIDs are specified using the numerical dotted representation.
486
487 connections.<conn>.remote<suffix>.certs =
488         Comma separated list of certificate to accept for authentication.
489
490         Comma separated list of certificates to accept for authentication.
491         The certificates may use a relative path from the **swanctl** _x509_
492         directory or an absolute path.
493
494 connections.<conn>.remote<suffix>.cert<suffix> =
495         Section for a certificate to accept for authentication.
496
497         Section for a certificate to accept for authentication. Certificates
498         in _certs_ are transmitted as binary blobs, these sections offer more
499         flexibility.
500
501 connections.<conn>.remote<suffix>.cert<suffix>.file =
502         Absolute path to the certificate to load.
503
504         Absolute path to the certificate to load. Passed as-is to the daemon, so it
505         must be readable by it.
506
507         Configure either this or _handle_, but not both, in one section.
508
509 connections.<conn>.remote<suffix>.cert<suffix>.handle =
510         Hex-encoded CKA_ID of the certificate on a token.
511
512         Hex-encoded CKA_ID of the certificate on a token.
513
514         Configure either this or _file_, but not both, in one section.
515
516 connections.<conn>.remote<suffix>.cert<suffix>.slot =
517         Optional slot number of the token that stores the certificate.
518
519 connections.<conn>.remote<suffix>.cert<suffix>.module =
520         Optional PKCS#11 module name.
521
522 connections.<conn>.remote<suffix>.cacerts =
523         Comma separated list of CA certificates to accept for authentication.
524
525         Comma separated list of CA certificates to accept for authentication.
526         The certificates may use a relative path from the **swanctl** _x509ca_
527         directory or an absolute path.
528
529 connections.<conn>.remote<suffix>.cacert<suffix> =
530         Section for a CA certificate to accept for authentication.
531
532         Section for a CA certificate to accept for authentication. Certificates
533         in _cacerts_ are transmitted as binary blobs, these sections offer more
534         flexibility.
535
536 connections.<conn>.remote<suffix>.cacert<suffix>.file =
537         Absolute path to the certificate to load.
538
539         Absolute path to the certificate to load. Passed as-is to the daemon, so it
540         must be readable by it.
541
542         Configure either this or _handle_, but not both, in one section.
543
544 connections.<conn>.remote<suffix>.cacert<suffix>.handle =
545         Hex-encoded CKA_ID of the CA certificate on a token.
546
547         Hex-encoded CKA_ID of the CA certificate on a token.
548
549         Configure either this or _file_, but not both, in one section.
550
551 connections.<conn>.remote<suffix>.cacert<suffix>.slot =
552         Optional slot number of the token that stores the CA certificate.
553
554 connections.<conn>.remote<suffix>.cacert<suffix>.module =
555         Optional PKCS#11 module name.
556
557 connections.<conn>.remote<suffix>.pubkeys =
558         Comma separated list of raw public keys to accept for authentication.
559
560         Comma separated list of raw public keys to accept for authentication.
561         The public keys may use a relative path from the **swanctl** _pubkey_
562         directory or an absolute path.
563
564 connections.<conn>.remote<suffix>.revocation = relaxed
565         Certificate revocation policy, (_strict_, _ifuri_ or _relaxed_).
566
567         Certificate revocation policy for CRL or OCSP revocation.
568
569         A _strict_ revocation policy fails if no revocation information is
570         available, i.e. the certificate is not known to be unrevoked.
571
572         _ifuri_ fails only if a CRL/OCSP URI is available, but certificate
573         revocation checking fails, i.e. there should be revocation information
574         available, but it could not be obtained.
575
576         The default revocation policy _relaxed_ fails only if a certificate
577         is revoked, i.e. it is explicitly known that it is bad.
578
579 connections.<conn>.remote<suffix>.auth = pubkey
580         Authentication to expect from remote (_pubkey_, _psk_, _xauth[-backend]_ or
581         _eap[-method]_).
582
583         Authentication to expect from remote. See the **local** section's **auth**
584         keyword description about the details of supported mechanisms.
585
586         To require a trustchain public key strength for the remote side, specify the
587         key type followed by the minimum strength in bits (for example _ecdsa-384_
588         or _rsa-2048-ecdsa-256_). To limit the acceptable set of hashing algorithms
589         for trustchain validation, append hash algorithms to _pubkey_ or a key
590         strength definition (for example _pubkey-sha256-sha512_,
591         _rsa-2048-sha256-sha384-sha512_ or
592         _rsa-2048-sha256-ecdsa-256-sha256-sha384_).
593         Unless disabled in **strongswan.conf**(5), or explicit IKEv2 signature
594         constraints are configured (refer to the description of the **local**
595         section's **auth** keyword for details), such key types and hash algorithms
596         are also applied as constraints against IKEv2 signature authentication
597         schemes used by the remote side. To require RSASSA-PSS signatures use
598         _rsa/pss_ instead of _pubkey_ or _rsa_ as in e.g. _rsa/pss-sha256_. If
599         _pubkey_ or _rsa_ constraints are configured RSASSA-PSS signatures will only
600         be accepted if enabled in **strongswan.conf**(5).
601
602         To specify trust chain constraints for EAP-(T)TLS, append a colon to the
603         EAP method, followed by the key type/size and hash algorithm as discussed
604         above (e.g. _eap-tls:ecdsa-384-sha384_).
605
606 connections.<conn>.children.<child> {}
607         CHILD_SA configuration sub-section.
608
609         CHILD_SA configuration sub-section. Each connection definition may have
610         one or more sections in its _children_ subsection. The section name
611         defines the name of the CHILD_SA configuration, which must be unique within
612         the connection.
613
614 connections.<conn>.children.<child>.ah_proposals =
615         AH proposals to offer for the CHILD_SA.
616
617         AH proposals to offer for the CHILD_SA. A proposal is a set of algorithms.
618         For AH, this includes an integrity algorithm and an optional Diffie-Hellman
619         group. If a DH group is specified, CHILD_SA/Quick Mode rekeying and initial
620         negotiation uses a separate Diffie-Hellman exchange using the specified
621         group (refer to _esp_proposals_ for details).
622
623         In IKEv2, multiple algorithms of the same kind can be specified in a single
624         proposal, from which one gets selected. In IKEv1, only one algorithm per
625         kind is allowed per proposal, more algorithms get implicitly stripped. Use
626         multiple proposals to offer different algorithms combinations in IKEv1.
627
628         Algorithm keywords get separated using dashes. Multiple proposals may be
629         separated by commas. The special value _default_ forms a default proposal
630         of supported algorithms considered safe, and is usually a good choice
631         for interoperability. By default no AH proposals are included, instead ESP
632         is proposed.
633
634 connections.<conn>.children.<child>.esp_proposals = default
635         ESP proposals to offer for the CHILD_SA.
636
637         ESP proposals to offer for the CHILD_SA. A proposal is a set of algorithms.
638         For ESP non-AEAD proposals, this includes an integrity algorithm, an
639         encryption algorithm, an optional Diffie-Hellman group and an optional
640         Extended Sequence Number Mode indicator. For AEAD proposals, a combined
641         mode algorithm is used instead of the separate encryption/integrity
642         algorithms.
643
644         If a DH group is specified, CHILD_SA/Quick Mode rekeying and initial
645         negotiation use a separate Diffie-Hellman exchange using the specified
646         group. However, for IKEv2, the keys of the CHILD_SA created implicitly with
647         the IKE_SA will always be derived from the IKE_SA's key material. So any DH
648         group specified here will only apply when the CHILD_SA is later rekeyed or
649         is created with a separate CREATE_CHILD_SA exchange. A proposal mismatch
650         might, therefore, not immediately be noticed when the SA is established, but
651         may later cause rekeying to fail.
652
653         Extended Sequence Number support may be indicated with the _esn_ and _noesn_
654         values, both may be included to indicate support for both modes. If omitted,
655         _noesn_ is assumed.
656
657         In IKEv2, multiple algorithms of the same kind can be specified in a single
658         proposal, from which one gets selected. In IKEv1, only one algorithm per
659         kind is allowed per proposal, more algorithms get implicitly stripped. Use
660         multiple proposals to offer different algorithms combinations in IKEv1.
661
662         Algorithm keywords get separated using dashes. Multiple proposals may be
663         separated by commas. The special value _default_ forms a default proposal
664         of supported algorithms considered safe, and is usually a good choice
665         for interoperability. If no algorithms are specified for AH nor ESP,
666         the _default_ set of algorithms for ESP is included.
667
668 connections.<conn>.children.<child>.sha256_96 = no
669         Use incorrect 96-bit truncation for HMAC-SHA-256.
670
671         HMAC-SHA-256 is used with 128-bit truncation with IPsec. For compatibility
672         with implementations that incorrectly use 96-bit truncation this option may
673         be enabled to configure the shorter truncation length in the kernel.  This
674         is not negotiated, so this only works with peers that use the incorrect
675         truncation length (or have this option enabled).
676
677 connections.<conn>.children.<child>.local_ts = dynamic
678         Local traffic selectors to include in CHILD_SA.
679
680         Comma separated list of local traffic selectors to include in CHILD_SA.
681         Each selector is a CIDR subnet definition, followed by an optional
682         proto/port selector. The special value _dynamic_ may be used instead of a
683         subnet definition, which gets replaced by the tunnel outer address or the
684         virtual IP, if negotiated. This is the default.
685
686         A protocol/port selector is surrounded by opening and closing square
687         brackets. Between these brackets, a numeric or **getservent**(3) protocol
688         name may be specified. After the optional protocol restriction, an optional
689         port restriction may be specified, separated by a slash. The port
690         restriction may be numeric, a **getservent**(3) service name, or the special
691         value _opaque_ for RFC 4301 OPAQUE selectors. Port ranges may be specified
692         as well, none of the kernel backends currently support port ranges, though.
693
694         When IKEv1 is used only the first selector is interpreted, except if
695         the Cisco Unity extension plugin is used. This is due to a limitation of the
696         IKEv1 protocol, which only allows a single pair of selectors per CHILD_SA.
697         So to tunnel traffic matched by several pairs of selectors when using IKEv1
698         several children (CHILD_SAs) have to be defined that cover the selectors.
699
700         The IKE daemon uses traffic selector narrowing for IKEv1, the same way it is
701         standardized and implemented for IKEv2. However, this may lead to problems
702         with other implementations. To avoid that, configure identical selectors in
703         such scenarios.
704
705 connections.<conn>.children.<child>.remote_ts = dynamic
706         Remote selectors to include in CHILD_SA.
707
708         Comma separated list of remote selectors to include in CHILD_SA. See
709         **local_ts** for a description of the selector syntax.
710
711 connections.<conn>.children.<child>.rekey_time = 1h
712         Time to schedule CHILD_SA rekeying.
713
714         Time to schedule CHILD_SA rekeying. CHILD_SA rekeying refreshes key
715         material, optionally using a Diffie-Hellman exchange if a group is
716         specified in the proposal.
717
718         To avoid rekey collisions initiated by both ends simultaneously, a value
719         in the range of **rand_time** gets subtracted to form the effective soft
720         lifetime.
721
722         By default CHILD_SA rekeying is scheduled every hour, minus **rand_time**.
723
724 connections.<conn>.children.<child>.life_time = rekey_time + 10%
725         Maximum lifetime before CHILD_SA gets closed, as time.
726
727         Maximum lifetime before CHILD_SA gets closed. Usually this hard lifetime
728         is never reached, because the CHILD_SA gets rekeyed before.
729         If that fails for whatever reason, this limit closes the CHILD_SA.
730
731         The default is 10% more than the **rekey_time**.
732
733 connections.<conn>.children.<child>.rand_time = life_time - rekey_time
734         Range of random time to subtract from **rekey_time**.
735
736         Time range from which to choose a random value to subtract from
737         **rekey_time**. The default is the difference between **life_time** and
738         **rekey_time**.
739
740 connections.<conn>.children.<child>.rekey_bytes = 0
741         Number of bytes processed before initiating CHILD_SA rekeying.
742
743         Number of bytes processed before initiating CHILD_SA rekeying. CHILD_SA
744         rekeying refreshes key material, optionally using a Diffie-Hellman exchange
745         if a group is specified in the proposal.
746
747         To avoid rekey collisions initiated by both ends simultaneously, a value
748         in the range of **rand_bytes** gets subtracted to form the effective soft
749         volume limit.
750
751         Volume based CHILD_SA rekeying is disabled by default.
752
753 connections.<conn>.children.<child>.life_bytes = rekey_bytes + 10%
754         Maximum bytes processed before CHILD_SA gets closed.
755
756         Maximum bytes processed before CHILD_SA gets closed. Usually this hard
757         volume limit is never reached, because the CHILD_SA gets rekeyed before.
758         If that fails for whatever reason, this limit closes the CHILD_SA.
759
760         The default is 10% more than **rekey_bytes**.
761
762 connections.<conn>.children.<child>.rand_bytes = life_bytes - rekey_bytes
763         Range of random bytes to subtract from **rekey_bytes**.
764
765         Byte range from which to choose a random value to subtract from
766         **rekey_bytes**. The default is the difference between **life_bytes** and
767         **rekey_bytes**.
768
769 connections.<conn>.children.<child>.rekey_packets = 0
770         Number of packets processed before initiating CHILD_SA rekeying.
771
772         Number of packets processed before initiating CHILD_SA rekeying. CHILD_SA
773         rekeying refreshes key material, optionally using a Diffie-Hellman exchange
774         if a group is specified in the proposal.
775
776         To avoid rekey collisions initiated by both ends simultaneously, a value
777         in the range of **rand_packets** gets subtracted to form the effective soft
778         packet count limit.
779
780         Packet count based CHILD_SA rekeying is disabled by default.
781
782 connections.<conn>.children.<child>.life_packets = rekey_packets + 10%
783         Maximum number of packets processed before CHILD_SA gets closed.
784
785         Maximum number of packets processed before CHILD_SA gets closed. Usually
786         this hard packets limit is never reached, because the CHILD_SA gets rekeyed
787         before. If that fails for whatever reason, this limit closes the CHILD_SA.
788
789         The default is 10% more than **rekey_bytes**.
790
791 connections.<conn>.children.<child>.rand_packets = life_packets - rekey_packets
792         Range of random packets to subtract from **packets_bytes**.
793
794         Packet range from which to choose a random value to subtract from
795         **rekey_packets**. The default is the difference between **life_packets**
796         and **rekey_packets**.
797
798 connections.<conn>.children.<child>.updown =
799         Updown script to invoke on CHILD_SA up and down events.
800
801 connections.<conn>.children.<child>.hostaccess = yes
802         Hostaccess variable to pass to **updown** script.
803
804 connections.<conn>.children.<child>.mode = tunnel
805         IPsec Mode to establish (_tunnel_, _transport_, _transport_proxy_, _beet_,
806         _pass_ or _drop_).
807
808         IPsec Mode to establish CHILD_SA with. _tunnel_ negotiates the CHILD_SA
809         in IPsec Tunnel Mode, whereas _transport_ uses IPsec Transport Mode.
810         _transport_proxy_ signifying the special Mobile IPv6 Transport Proxy Mode.
811         _beet_ is the Bound End to End Tunnel mixture mode, working with fixed inner
812         addresses without the need to include them in each packet.
813
814         Both _transport_ and _beet_ modes are subject to mode negotiation; _tunnel_
815         mode is negotiated if the preferred mode is not available.
816
817         _pass_ and _drop_ are used to install shunt policies which explicitly
818         bypass the defined traffic from IPsec processing or drop it, respectively.
819
820 connections.<conn>.children.<child>.policies = yes
821         Whether to install IPsec policies or not.
822
823         Whether to install IPsec policies or not. Disabling this can be useful in
824         some scenarios e.g. MIPv6, where policies are not managed by the IKE daemon.
825
826 connections.<conn>.children.<child>.policies_fwd_out = no
827         Whether to install outbound FWD IPsec policies or not.
828
829         Whether to install outbound FWD IPsec policies or not. Enabling this is
830         required in case there is a drop policy that would match and block forwarded
831         traffic for this CHILD_SA.
832
833 connections.<conn>.children.<child>.dpd_action = clear
834         Action to perform on DPD timeout (_clear_, _trap_ or _restart_).
835
836         Action to perform for this CHILD_SA on DPD timeout. The default _clear_
837         closes the CHILD_SA and does not take further action. _trap_ installs
838         a trap policy, which will catch matching traffic and tries to re-negotiate
839         the tunnel on-demand. _restart_ immediately tries to re-negotiate the
840         CHILD_SA under a fresh IKE_SA.
841
842 connections.<conn>.children.<child>.ipcomp = no
843         Enable IPComp compression before encryption.
844
845         Enable IPComp compression before encryption. If enabled, IKE tries to
846         negotiate IPComp compression to compress ESP payload data prior to
847         encryption.
848
849 connections.<conn>.children.<child>.inactivity = 0s
850         Timeout before closing CHILD_SA after inactivity.
851
852         Timeout before closing CHILD_SA after inactivity. If no traffic has
853         been processed in either direction for the configured timeout, the CHILD_SA
854         gets closed due to inactivity. The default value of _0_ disables inactivity
855         checks.
856
857 connections.<conn>.children.<child>.reqid = 0
858         Fixed reqid to use for this CHILD_SA.
859
860         Fixed reqid to use for this CHILD_SA. This might be helpful in some
861         scenarios, but works only if each CHILD_SA configuration is instantiated
862         not more than once. The default of _0_ uses dynamic reqids, allocated
863         incrementally.
864
865 connections.<conn>.children.<child>.priority = 0
866         Optional fixed priority for IPsec policies.
867
868         Optional fixed priority for IPsec policies. This could be useful to install
869         high-priority drop policies.  The default of _0_ uses dynamically calculated
870         priorities based on the size of the traffic selectors.
871
872 connections.<conn>.children.<child>.interface =
873         Optional interface name to restrict IPsec policies.
874
875 connections.<conn>.children.<child>.mark_in = 0/0x00000000
876         Netfilter mark and mask for input traffic.
877
878         Netfilter mark and mask for input traffic. On Linux, Netfilter may require
879         marks on each packet to match an SA/policy having that option set. This
880         allows installing duplicate policies and enables Netfilter rules to select
881         specific SAs/policies for incoming traffic.  Note that inbound marks are
882         only set on policies, by default, unless *mark_in_sa* is enabled. The
883         special value _%unique_ sets a unique mark on each CHILD_SA instance, beyond
884         that the value _%unique-dir_ assigns a different unique mark for each
885         CHILD_SA direction (in/out).
886
887         An additional mask may be appended to the mark, separated by _/_. The
888         default mask if omitted is 0xffffffff.
889
890 connections.<conn>.children.<child>.mark_in_sa = no
891         Whether to set *mark_in* on the inbound SA.
892
893         Whether to set *mark_in* on the inbound SA. By default, the inbound mark is
894         only set on the inbound policy. The tuple destination address, protocol and
895         SPI is unique and the mark is not required to find the correct SA, allowing
896         to mark traffic after decryption instead (where more specific selectors may
897         be used) to match different policies. Marking packets before decryption is
898         still possible, even if no mark is set on the SA.
899
900 connections.<conn>.children.<child>.mark_out = 0/0x00000000
901         Netfilter mark and mask for output traffic.
902
903         Netfilter mark and mask for output traffic. On Linux, Netfilter may require
904         marks on each packet to match a policy/SA having that option set. This
905         allows installing duplicate policies and enables Netfilter rules to select
906         specific policies/SAs for outgoing traffic. The special value _%unique_ sets
907         a unique mark on each CHILD_SA instance, beyond that the value _%unique-dir_
908         assigns a different unique mark for each CHILD_SA direction (in/out).
909
910         An additional mask may be appended to the mark, separated by _/_. The
911         default mask if omitted is 0xffffffff.
912
913 connections.<conn>.children.<child>.tfc_padding = 0
914         Traffic Flow Confidentiality padding.
915
916         Pads ESP packets with additional data to have a consistent ESP packet size
917         for improved Traffic Flow Confidentiality. The padding defines the minimum
918         size of all ESP packets sent.
919
920         The default value of 0 disables TFC padding, the special value _mtu_ adds
921         TFC padding to create a packet size equal to the Path Maximum Transfer Unit.
922
923 connections.<conn>.children.<child>.replay_window = 32
924         IPsec replay window to configure for this CHILD_SA.
925
926         IPsec replay window to configure for this CHILD_SA. Larger values than the
927         default of 32 are supported using the Netlink backend only, a value of 0
928         disables IPsec replay protection.
929
930 connections.<conn>.children.<child>.hw_offload = no
931         Enable hardware offload for this CHILD_SA, if supported by the IPsec
932         implementation.
933
934         Enable hardware offload for this CHILD_SA, if supported by the IPsec
935         implementation. The value _yes_ enforces offloading and the installation
936         will fail if it's not supported by either kernel or device.     The value _auto_
937         enables offloading, if it's supported, but the installation does not fail
938         otherwise.
939
940 connections.<conn>.children.<child>.copy_df = yes
941         Whether to copy the DF bit to the outer IPv4 header in tunnel mode.
942
943         Whether to copy the DF bit to the outer IPv4 header in tunnel mode. This
944         effectively disables Path MTU discovery (PMTUD).  Controlling this behavior
945         is not supported by all kernel interfaces.
946
947 connections.<conn>.children.<child>.copy_ecn = yes
948         Whether to copy the ECN header field to/from the outer IP header in tunnel
949         mode.
950
951         Whether to copy the ECN (Explicit Congestion Notification) header field
952         to/from the outer IP header in tunnel mode. Controlling this behavior is not
953         supported by all kernel interfaces.
954
955 connections.<conn>.children.<child>.copy_dscp = out
956         Whether to copy the DSCP header field to/from the outer IP header in tunnel
957         mode.
958
959         Whether to copy the DSCP (Differentiated Services Field Codepoint) header
960         field to/from the outer IP header in tunnel mode. The value _out_ only
961         copies the field from the inner to the outer header, the value _in_ does the
962         opposite and only copies the field from the outer to the inner header when
963         decapsulating, the value _yes_ copies the field in both directions, and the
964         value _no_ disables copying the field altogether.  Setting this to _yes_ or
965         _in_ could allow an attacker to adversely affect other traffic at the
966         receiver, which is why the default is _out_. Controlling this behavior is
967         not supported by all kernel interfaces.
968
969 connections.<conn>.children.<child>.start_action = none
970         Action to perform after loading the configuration (_none_, _trap_, _start_).
971
972         Action to perform after loading the configuration. The default of _none_
973         loads the connection only, which then can be manually initiated or used as
974         a responder configuration.
975
976         The value _trap_ installs a trap policy, which triggers the tunnel as soon
977         as matching traffic has been detected. The value _start_ initiates
978         the connection actively.
979
980         When unloading or replacing a CHILD_SA configuration having a
981         **start_action** different from _none_, the inverse action is performed.
982         Configurations with _start_ get closed, while such with _trap_ get
983         uninstalled.
984
985 connections.<conn>.children.<child>.close_action = none
986         Action to perform after a CHILD_SA gets closed (_none_, _trap_, _start_).
987
988         Action to perform after a CHILD_SA gets closed by the peer. The default of
989         _none_ does not take any action, _trap_ installs a trap policy for the
990         CHILD_SA. _start_ tries to re-create the CHILD_SA.
991
992         **close_action** does not provide any guarantee that the CHILD_SA is kept
993         alive. It acts on explicit close messages only, but not on negotiation
994         failures. Use trap policies to reliably re-create failed CHILD_SAs.
995
996 secrets { # }
997         Section defining secrets for IKE/EAP/XAuth authentication and private
998         key decryption.
999
1000         Section defining secrets for IKE/EAP/XAuth authentication and private key
1001         decryption. The **secrets** section takes sub-sections having a specific
1002         prefix which defines the secret type.
1003
1004         It is not recommended to define any private key decryption passphrases,
1005         as then there is no real security benefit in having encrypted keys. Either
1006         store the key unencrypted or enter the keys manually when loading
1007         credentials.
1008
1009 secrets.eap<suffix> { # }
1010         EAP secret section for a specific secret.
1011
1012         EAP secret section for a specific secret. Each EAP secret is defined in
1013         a unique section having the _eap_ prefix. EAP secrets are used for XAuth
1014         authentication as well.
1015
1016 secrets.xauth<suffix> { # }
1017         XAuth secret section for a specific secret.
1018
1019         XAuth secret section for a specific secret. **xauth** is just an alias
1020         for **eap**, secrets under both section prefixes are used for both EAP and
1021         XAuth authentication.
1022
1023 secrets.eap<suffix>.secret =
1024         Value of the EAP/XAuth secret.
1025
1026         Value of the EAP/XAuth secret. It may either be an ASCII string, a hex
1027         encoded string if it has a _0x_ prefix or a Base64 encoded string if it
1028         has a _0s_ prefix in its value.
1029
1030 secrets.eap<suffix>.id<suffix> =
1031         Identity the EAP/XAuth secret belongs to.
1032
1033         Identity the EAP/XAuth secret belongs to. Multiple unique identities may
1034         be specified, each having an _id_ prefix, if a secret is shared between
1035         multiple users.
1036
1037 secrets.ntlm<suffix> { # }
1038         NTLM secret section for a specific secret.
1039
1040         NTLM secret section for a specific secret. Each NTLM secret is defined in
1041         a unique section having the _ntlm_ prefix. NTLM secrets may only be used for
1042         EAP-MSCHAPv2 authentication.
1043
1044 secrets.ntlm<suffix>.secret =
1045         Value of the NTLM secret.
1046
1047         Value of the NTLM secret, which is the NT Hash of the actual secret, that
1048         is, MD4(UTF-16LE(secret)). The resulting 16-byte value may either be given
1049         as a hex encoded string with a _0x_ prefix or as a Base64 encoded string
1050         with a _0s_ prefix.
1051
1052 secrets.ntlm<suffix>.id<suffix> =
1053         Identity the NTLM secret belongs to.
1054
1055         Identity the NTLM secret belongs to. Multiple unique identities may
1056         be specified, each having an _id_ prefix, if a secret is shared between
1057         multiple users.
1058
1059 secrets.ike<suffix> { # }
1060         IKE preshared secret section for a specific secret.
1061
1062         IKE preshared secret section for a specific secret. Each IKE PSK is defined
1063         in a unique section having the _ike_ prefix.
1064
1065 secrets.ike<suffix>.secret =
1066         Value of the IKE preshared secret.
1067
1068         Value of the IKE preshared secret. It may either be an ASCII string,
1069         a hex encoded string if it has a _0x_ prefix or a Base64 encoded string if
1070         it has a _0s_ prefix in its value.
1071
1072 secrets.ike<suffix>.id<suffix> =
1073         IKE identity the IKE preshared secret belongs to.
1074
1075         IKE identity the IKE preshared secret belongs to. Multiple unique identities
1076         may be specified, each having an _id_ prefix, if a secret is shared between
1077         multiple peers.
1078
1079 secrets.private<suffix> { # }
1080         Private key decryption passphrase for a key in the _private_ folder.
1081
1082 secrets.private<suffix>.file =
1083         File name in the _private_ folder for which this passphrase should be used.
1084
1085 secrets.private<suffix>.secret
1086         Value of decryption passphrase for private key.
1087
1088 secrets.rsa<suffix> { # }
1089         Private key decryption passphrase for a key in the _rsa_ folder.
1090
1091 secrets.rsa<suffix>.file =
1092         File name in the _rsa_ folder for which this passphrase should be used.
1093
1094 secrets.rsa<suffix>.secret
1095         Value of decryption passphrase for RSA key.
1096
1097 secrets.ecdsa<suffix> { # }
1098         Private key decryption passphrase for a key in the _ecdsa_ folder.
1099
1100 secrets.ecdsa<suffix>.file =
1101         File name in the _ecdsa_ folder for which this passphrase should be used.
1102
1103 secrets.ecdsa<suffix>.secret
1104         Value of decryption passphrase for ECDSA key.
1105
1106 secrets.pkcs8<suffix> { # }
1107         Private key decryption passphrase for a key in the _pkcs8_ folder.
1108
1109 secrets.pkcs8<suffix>.file =
1110         File name in the _pkcs8_ folder for which this passphrase should be used.
1111
1112 secrets.pkcs8<suffix>.secret
1113         Value of decryption passphrase for PKCS#8 key.
1114
1115 secrets.pkcs12<suffix> { # }
1116         PKCS#12 decryption passphrase for a container in the _pkcs12_ folder.
1117
1118 secrets.pkcs12<suffix>.file =
1119         File name in the _pkcs12_ folder for which this passphrase should be used.
1120
1121 secrets.pkcs12<suffix>.secret
1122         Value of decryption passphrase for PKCS#12 container.
1123
1124 secrets.token<suffix> { # }
1125         Definition for a private key that's stored on a token/smartcard.
1126
1127 secrets.token<suffix>.handle =
1128         Hex-encoded CKA_ID of the private key on the token.
1129
1130 secrets.token<suffix>.slot =
1131         Optional slot number to access the token.
1132
1133 secrets.token<suffix>.module =
1134         Optional PKCS#11 module name to access the token.
1135
1136 secrets.token<suffix>.pin =
1137         Optional PIN required to access the key on the token. If none is provided
1138         the user is prompted during an interactive --load-creds call.
1139
1140 pools { # }
1141         Section defining named pools.
1142
1143         Section defining named pools. Named pools may be referenced by connections
1144         with the **pools** option to assign virtual IPs and other configuration
1145         attributes.
1146
1147 pools.<name> { # }
1148         Section defining a single pool with a unique name.
1149
1150 pools.<name>.addrs =
1151         Addresses allocated in pool.
1152
1153         Subnet or range defining addresses allocated in pool. Accepts a single CIDR
1154         subnet defining the pool to allocate addresses from or an address range
1155         (<from>-<to>).  Pools must be unique and non-overlapping.
1156
1157 pools.<name>.<attr> =
1158         Comma separated list of additional attributes from type <attr>.
1159
1160         Comma separated list of additional attributes of type **<attr>**. The
1161         attribute type may be one of _dns_, _nbns_, _dhcp_, _netmask_, _server_,
1162         _subnet_, _split_include_ and _split_exclude_ to define addresses or CIDR
1163         subnets for the corresponding attribute types. Alternatively, **<attr>** can
1164         be a numerical identifier, for which string attribute values are accepted
1165         as well.
1166
1167 authorities { # }
1168         Section defining attributes of certification authorities.
1169
1170 authorities.<name> { # }
1171         Section defining a certification authority with a unique name.
1172
1173 authorities.<name>.cacert =
1174         CA certificate belonging to the certification authority.
1175
1176         CA certificate belonging to the certification authority. The certificates
1177         may use a relative path from the **swanctl** _x509ca_ directory or an
1178         absolute path.
1179
1180         Configure one of _cacert_, _file_, or _handle_ per section.
1181
1182 authorities.<name>.file =
1183         Absolute path to the certificate to load.
1184
1185         Absolute path to the certificate to load. Passed as-is to the daemon, so it
1186         must be readable by it.
1187
1188         Configure one of _cacert_, _file_, or _handle_ per section.
1189
1190 authorities.<name>.handle =
1191         Hex-encoded CKA_ID of the CA certificate on a token.
1192
1193         Hex-encoded CKA_ID of the CA certificate on a token.
1194
1195         Configure one of _cacert_, _file_, or _handle_ per section.
1196
1197 authorities.<name>.slot =
1198         Optional slot number of the token that stores the CA certificate.
1199
1200 authorities.<name>.module =
1201         Optional PKCS#11 module name.
1202
1203 authorities.<name>.crl_uris =
1204         Comma-separated list of CRL distribution points.
1205
1206         Comma-separated list of CRL distribution points (ldap, http, or file URI).
1207
1208 authorities.<name>.ocsp_uris =
1209         Comma-separated list of OCSP URIs.
1210
1211 authorities.<name>.cert_uri_base =
1212         Defines the base URI for the Hash and URL feature supported by IKEv2.
1213
1214         Defines the base URI for the Hash and URL feature supported by IKEv2.
1215         Instead of exchanging complete certificates, IKEv2 allows one to send an
1216         URI that resolves to the DER encoded certificate. The certificate URIs are
1217         built by appending the SHA1 hash of the DER encoded certificates to this
1218         base URI.
1219
1220 include conf.d/*.conf
1221         Include config snippets