pinnedpubkey.d 1.0 KB

123456789101112131415161718192021222324252627282930313233343536
  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. ---
  10. Tells curl to use the specified public key file (or hashes) to verify the
  11. peer. This can be a path to a file which contains a single public key in PEM
  12. or DER format, or any number of base64 encoded sha256 hashes preceded by
  13. 'sha256//' and separated by ';'.
  14. When negotiating a TLS or SSL connection, the server sends a certificate
  15. indicating its identity. A public key is extracted from this certificate and
  16. if it does not exactly match the public key provided to this option, curl will
  17. abort the connection before sending or receiving any data.
  18. PEM/DER support:
  19. 7.39.0: OpenSSL, GnuTLS and GSKit
  20. 7.43.0: NSS and wolfSSL
  21. 7.47.0: mbedtls
  22. sha256 support:
  23. 7.44.0: OpenSSL, GnuTLS, NSS and wolfSSL
  24. 7.47.0: mbedtls
  25. Other SSL backends not supported.
  26. If this option is used several times, the last one will be used.