pinnedpubkey.d 1.1 KB

1234567891011121314151617181920212223242526272829303132
  1. c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
  2. SPDX-License-Identifier: curl
  3. Long: pinnedpubkey
  4. Arg: <hashes>
  5. Help: FILE/HASHES Public key to verify peer against
  6. Protocols: TLS
  7. Category: tls
  8. Example: --pinnedpubkey keyfile $URL
  9. Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
  10. Added: 7.39.0
  11. See-also: hostpubsha256
  12. Multi: single
  13. ---
  14. Tells curl to use the specified public key file (or hashes) to verify the
  15. peer. This can be a path to a file which contains a single public key in PEM
  16. or DER format, or any number of base64 encoded sha256 hashes preceded by
  17. 'sha256//' and separated by ';'.
  18. When negotiating a TLS or SSL connection, the server sends a certificate
  19. indicating its identity. A public key is extracted from this certificate and
  20. if it does not exactly match the public key provided to this option, curl
  21. aborts the connection before sending or receiving any data.
  22. PEM/DER support:
  23. OpenSSL and GnuTLS (added in 7.39.0), wolfSSL (added in 7.43.0), mbedTLS (added in 7.47.0)
  24. sha256 support:
  25. OpenSSL, GnuTLS and wolfSSL (added in 7.44.0), mbedTLS (added in 7.47.0)
  26. Other SSL backends not supported.