Project

General

Profile

ipsec.conf: ca Reference » History » Version 17

Tobias Brunner, 23.10.2015 18:58
Refer to notes regarding also=

1 11 Tobias Brunner
{{title(ipsec.conf: ca Reference)}}
2 11 Tobias Brunner
3 11 Tobias Brunner
h1. ipsec.conf: ca <name>
4 11 Tobias Brunner
5 6 Tobias Brunner
h1. ca <name>
6 6 Tobias Brunner
7 15 Tobias Brunner
*ca* sections are *optional sections* that can be used to assign special parameters to a Certification Authority (CA).
8 1 Martin Willi
9 14 Tobias Brunner
Because the daemon automatically imports CA certificates from [[IpsecDirectoryCacerts|/etc/ipsec.d/cacerts]], there is no need to explicitly
10 14 Tobias Brunner
add them with a CA section, unless you want to assign special parameters (like a CRL) to a CA.
11 10 Tobias Brunner
12 1 Martin Willi
h2. Parameters
13 1 Martin Willi
14 14 Tobias Brunner
_also = <name>_
15 8 Andreas Steffen
16 17 Tobias Brunner
p((. includes ca section _<name>_.  Some aspects of this changed with version:5.2.0 (refer to [[IpsecConf#Reusing-Existing-Parameters]] for details).
17 7 Tobias Brunner
18 1 Martin Willi
_auto = *ignore* | add_
19 7 Tobias Brunner
20 8 Andreas Steffen
_cacert = <path>_
21 1 Martin Willi
22 10 Tobias Brunner
p((. defines a path to the CA certificate either relative to [[IpsecDirectoryCacerts|/etc/ipsec.d/cacerts]] or as an absolute path.
23 1 Martin Willi
24 16 Tobias Brunner
p((. Since [[5.0.2]] a value of the form _%smartcard[<slot nr>[@<module>]]:<keyid>_ defines a specific CA certificate
25 16 Tobias Brunner
     to load from a PKCS#11 backend for this CA. See [[PinSecret|ipsec.secrets]] for details about smartcard definitions
26 16 Tobias Brunner
27 7 Tobias Brunner
_crluri = <uri>_
28 8 Andreas Steffen
29 7 Tobias Brunner
p((. defines a CRL distribution point (ldap, http, or file URI).
30 1 Martin Willi
31 9 Tobias Brunner
_crluri1_
32 8 Andreas Steffen
33 7 Tobias Brunner
p((. synonym for _crluri_.
34 4 Martin Willi
35 8 Andreas Steffen
_crluri2 = <uri>_
36 1 Martin Willi
37 12 Tobias Brunner
p((. defines an alternative CRL distribution point (ldap, http, or file URI).
38 3 Martin Willi
39 7 Tobias Brunner
_ocspuri = <uri>_
40 8 Andreas Steffen
41 7 Tobias Brunner
p((. defines an OCSP URI.
42 3 Martin Willi
43 9 Tobias Brunner
_ocspuri1_
44 8 Andreas Steffen
45 7 Tobias Brunner
p((. synonym for _ocspuri_.
46 7 Tobias Brunner
47 1 Martin Willi
_ocspuri2 = <uri>_
48 8 Andreas Steffen
49 12 Tobias Brunner
p((. defines an alternative OCSP URI. Only used by the charon daemon (since 5.0.0 also for IKEv1).
50 1 Martin Willi
51 1 Martin Willi
_certuribase = <uri>_
52 1 Martin Willi
53 1 Martin Willi
p((. defines the base URI for the [[HashAndUrl|Hash and URL]] feature supported by IKEv2.
54 1 Martin Willi
     Instead of exchanging complete certificates, IKEv2 allows to send an URI
55 1 Martin Willi
     that resolves to the DER encoded certificate. The certificate URIs are built
56 5 Tobias Brunner
     by appending the SHA1 hash of the DER encoded certificates to this base URI.
57 14 Tobias Brunner
58 14 Tobias Brunner
h2. Old options (before 5.0.0)
59 14 Tobias Brunner
60 14 Tobias Brunner
_ldaphost = <hostname>_
61 14 Tobias Brunner
62 14 Tobias Brunner
p((. defines an ldap host. Only used by the IKEv1 daemon pluto.