key.md (1191B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: key 5 Arg: <key> 6 Protocols: TLS SSH 7 Help: Private key filename 8 Category: tls ssh 9 Added: 7.9.3 10 Multi: single 11 See-also: 12 - key-type 13 - cert 14 Example: 15 - --cert certificate --key here $URL 16 --- 17 18 # `--key` 19 20 Private key filename. Allows you to provide your private key in this separate 21 file. For SSH, if not specified, curl tries the following candidates in order: 22 `~/.ssh/id_rsa`, `~/.ssh/id_dsa`, `./id_rsa`, `./id_dsa`. 23 24 If curl is built against OpenSSL library, and the engine pkcs11 or pkcs11 25 provider is available, then a PKCS#11 URI (RFC 7512) can be used to specify a 26 private key located in a PKCS#11 device. A string beginning with `pkcs11:` is 27 interpreted as a PKCS#11 URI. If a PKCS#11 URI is provided, then the --engine 28 option is set as `pkcs11` if none was provided and the --key-type option is 29 set as `ENG` or `PROV` if none was provided (depending on OpenSSL version). 30 31 If curl is built against Schannel then this option is ignored for TLS 32 protocols (HTTPS, etc). That backend expects the private key to be already 33 present in the keychain or PKCS#12 file containing the certificate.