| xf.li | 6c8fc1e | 2023-08-12 00:11:09 -0700 | [diff] [blame^] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: cacert |
| 4 | Arg: <file> |
| 5 | Help: CA certificate to verify peer against |
| 6 | Protocols: TLS |
| 7 | Category: tls |
| 8 | See-also: capath insecure |
| 9 | Example: --cacert CA-file.txt $URL |
| 10 | Added: 7.5 |
| 11 | Multi: single |
| 12 | --- |
| 13 | Tells curl to use the specified certificate file to verify the peer. The file |
| 14 | may contain multiple CA certificates. The certificate(s) must be in PEM |
| 15 | format. Normally curl is built to use a default file for this, so this option |
| 16 | is typically used to alter that default file. |
| 17 | |
| 18 | curl recognizes the environment variable named 'CURL_CA_BUNDLE' if it is |
| 19 | set, and uses the given path as a path to a CA cert bundle. This option |
| 20 | overrides that variable. |
| 21 | |
| 22 | The windows version of curl will automatically look for a CA certs file named |
| 23 | 'curl-ca-bundle.crt', either in the same directory as curl.exe, or in the |
| 24 | Current Working Directory, or in any folder along your PATH. |
| 25 | |
| 26 | If curl is built against the NSS SSL library, the NSS PEM PKCS#11 module |
| 27 | (libnsspem.so) needs to be available for this option to work properly. |
| 28 | |
| 29 | (iOS and macOS only) If curl is built against Secure Transport, then this |
| 30 | option is supported for backward compatibility with other SSL engines, but it |
| 31 | should not be set. If the option is not set, then curl will use the |
| 32 | certificates in the system and user Keychain to verify the peer, which is the |
| 33 | preferred method of verifying the peer's certificate chain. |
| 34 | |
| 35 | (Schannel only) This option is supported for Schannel in Windows 7 or later |
| 36 | with libcurl 7.60 or later. This option is supported for backward |
| 37 | compatibility with other SSL engines; instead it is recommended to use |
| 38 | Windows' store of root certificates (the default for Schannel). |