pinnedpubkey.d 1.0 KB

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