Changed some minor stuff in ipsec.conf(5) man page.

Also added some "links" to strongswan.conf(5).
This commit is contained in:
Tobias Brunner
2010-10-19 17:18:30 +02:00
parent 6bcf6016e6
commit a5477a6fa3
+27 -12
View File
@@ -233,6 +233,9 @@ defines the identity of the AAA backend used during IKEv2 EAP authentication.
This is required if the EAP client uses a method that verifies the server This is required if the EAP client uses a method that verifies the server
identity (such as EAP-TLS), but it does not match the IKEv2 gateway identity. identity (such as EAP-TLS), but it does not match the IKEv2 gateway identity.
.TP .TP
.BR also " = <name>"
includes conn section
.BR <name> .
.TP .TP
.BR auth " = " esp " | ah" .BR auth " = " esp " | ah"
whether authentication should be done as part of whether authentication should be done as part of
@@ -247,9 +250,9 @@ The IKEv2 daemon currently supports ESP only.
.BR authby " = " pubkey " | rsasig | ecdsasig | psk | eap | never | xauth..." .BR authby " = " pubkey " | rsasig | ecdsasig | psk | eap | never | xauth..."
how the two security gateways should authenticate each other; how the two security gateways should authenticate each other;
acceptable values are acceptable values are
.B secret
or
.B psk .B psk
or
.B secret
for pre-shared secrets, for pre-shared secrets,
.B pubkey .B pubkey
(the default) for public key signatures as well as the synonyms (the default) for public key signatures as well as the synonyms
@@ -360,6 +363,9 @@ dead peers.
defines the timeout interval, after which all connections to a peer are deleted defines the timeout interval, after which all connections to a peer are deleted
in case of inactivity. This only applies to IKEv1, in IKEv2 the default in case of inactivity. This only applies to IKEv1, in IKEv2 the default
retransmission timeout applies, as every exchange is used to detect dead peers. retransmission timeout applies, as every exchange is used to detect dead peers.
See
.IR strongswan.conf (5)
for a description of the IKEv2 retransmission timeout.
.TP .TP
.BR inactivity " = <time>" .BR inactivity " = <time>"
defines the timeout interval, after which a CHILD_SA is closed if it did defines the timeout interval, after which a CHILD_SA is closed if it did
@@ -401,7 +407,7 @@ defined, the IKEv2 identity will be used as EAP identity.
.BR esp " = <cipher suites>" .BR esp " = <cipher suites>"
comma-separated list of ESP encryption/authentication algorithms to be used comma-separated list of ESP encryption/authentication algorithms to be used
for the connection, e.g. for the connection, e.g.
.BR 3des-md5 . .BR aes128-sha256 .
The notation is The notation is
.BR encryption-integrity-[dh-group] . .BR encryption-integrity-[dh-group] .
.br .br
@@ -411,7 +417,7 @@ is specified, CHILD_SA setup and rekeying include a separate diffe hellman
exchange (IKEv2 only). exchange (IKEv2 only).
.TP .TP
.BR forceencaps " = yes | " no .BR forceencaps " = yes | " no
Force UDP encapsulation for ESP packets even if no NAT situation is detected. force UDP encapsulation for ESP packets even if no NAT situation is detected.
This may help to surmount restrictive firewalls. In order to force the peer to This may help to surmount restrictive firewalls. In order to force the peer to
encapsulate packets, NAT detection payloads are faked (IKEv2 only). encapsulate packets, NAT detection payloads are faked (IKEv2 only).
.TP .TP
@@ -715,18 +721,18 @@ or
or or
.BR yes , .BR yes ,
and and
.BR ifasked , .BR ifasked " (the default),"
the latter meaning that the peer must send a certificate request payload in the latter meaning that the peer must send a certificate request payload in
order to get a certificate in return. order to get a certificate in return.
.TP .TP
.BR leftsourceip " = %config | %cfg | %modeconfig | %modecfg | <ip address>" .BR leftsourceip " = %config | %cfg | %modeconfig | %modecfg | <ip address>"
The internal source IP to use in a tunnel, also known as virtual IP. If the The internal source IP to use in a tunnel, also known as virtual IP. If the
value is one of the synonyms value is one of the synonyms
.BR %modeconfig ,
.BR %modecfg ,
.BR %config , .BR %config ,
or
.BR %cfg , .BR %cfg ,
.BR %modeconfig ,
or
.BR %modecfg ,
an address is requested from the peer. In IKEv2, a statically defined address an address is requested from the peer. In IKEv2, a statically defined address
is also requested, since the server may change it. is also requested, since the server may change it.
.TP .TP
@@ -962,12 +968,14 @@ signifying that no IPsec processing should be done at all;
.BR drop , .BR drop ,
signifying that packets should be discarded; and signifying that packets should be discarded; and
.BR reject , .BR reject ,
signifying that packets should be discarded and a diagnostic ICMP returned. signifying that packets should be discarded and a diagnostic ICMP returned
.RB ( reject
is currently not supported by the NETKEY stack of the Linux 2.6 kernel).
The IKEv2 daemon charon currently supports The IKEv2 daemon charon currently supports
.BR tunnel , .BR tunnel ,
.BR transport , .BR transport ,
and and
.BR tunnel_proxy .BR transport_proxy
connection types, only. connection types, only.
.TP .TP
.BR xauth " = " client " | server" .BR xauth " = " client " | server"
@@ -1014,6 +1022,10 @@ of this connection will be used as peer ID.
This are optional sections that can be used to assign special This are optional sections that can be used to assign special
parameters to a Certification Authority (CA). parameters to a Certification Authority (CA).
.TP .TP
.BR also " = <name>"
includes ca section
.BR <name> .
.TP
.BR auto " = " ignore " | add" .BR auto " = " ignore " | add"
currently can have either the value currently can have either the value
.B ignore .B ignore
@@ -1087,7 +1099,7 @@ Accepted values are
.B yes .B yes
and and
.B no .B no
(the default). (the default). Only relevant for IKEv1, as CRLs are always cached in IKEv2.
.TP .TP
.BR charonstart " = " yes " | no" .BR charonstart " = " yes " | no"
whether to start the IKEv2 charon daemon or not. whether to start the IKEv2 charon daemon or not.
@@ -1153,7 +1165,7 @@ Accepted values are
and and
.B no .B no
(the default). (the default).
Used by IKEv1 only, NAT traversal always being active in IKEv2. Used by IKEv1 only, NAT traversal is always being active in IKEv2.
.TP .TP
.BR nocrsend " = yes | " no .BR nocrsend " = yes | " no
no certificate request payloads will be sent. no certificate request payloads will be sent.
@@ -1246,6 +1258,9 @@ Acceptable values for types are
and the level is one of and the level is one of
.B -1, 0, 1, 2, 3, 4 .B -1, 0, 1, 2, 3, 4
(for silent, audit, control, controlmore, raw, private). (for silent, audit, control, controlmore, raw, private).
For more flexibility see LOGGER CONFIGURATION in
.IR strongswan.conf (5).
.SH IKEv2 EXPIRY/REKEY .SH IKEv2 EXPIRY/REKEY
The IKE SAs and IPsec SAs negotiated by the daemon can be configured to expire The IKE SAs and IPsec SAs negotiated by the daemon can be configured to expire
after a specific amount of time. For IPsec SAs this can also happen after a after a specific amount of time. For IPsec SAs this can also happen after a