blob: 0657e6e791476d57c10a7dd0f96ab934bd684676 [file] [log] [blame]
lh9ed821d2023-04-07 01:36:19 -07001Long: pinnedpubkey
2Arg: <hashes>
3Help: FILE/HASHES Public key to verify peer against
4Protocols: TLS
5---
6Tells curl to use the specified public key file (or hashes) to verify the
7peer. This can be a path to a file which contains a single public key in PEM
8or DER format, or any number of base64 encoded sha256 hashes preceded by
9\'sha256//\' and separated by \';\'
10
11When negotiating a TLS or SSL connection, the server sends a certificate
12indicating its identity. A public key is extracted from this certificate and
13if it does not exactly match the public key provided to this option, curl will
14abort the connection before sending or receiving any data.
15
16PEM/DER support:
17 7.39.0: OpenSSL, GnuTLS and GSKit
18 7.43.0: NSS and wolfSSL/CyaSSL
19 7.47.0: mbedtls
20 7.49.0: PolarSSL
21sha256 support:
22 7.44.0: OpenSSL, GnuTLS, NSS and wolfSSL/CyaSSL.
23 7.47.0: mbedtls
24 7.49.0: PolarSSL
25Other SSL backends not supported.
26
27If this option is used several times, the last one will be used.