From 1192039d9909e2c301497c7d75f691bc45dc5deb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tobias=20Nie=C3=9Fen?= Date: Mon, 31 Jan 2022 08:47:13 +0100 Subject: [PATCH] doc: remove section on "recent" ECDH changes The ECDH API changes were made more than six years ago and this section is not helpful for new applications. The behavior of the ECDH APIs should be explained in the relevant sections, not in a note. Refs: https://github.com/nodejs/node/pull/3511 PR-URL: https://github.com/nodejs/node/pull/41773 Reviewed-By: Rich Trott Reviewed-By: Luigi Pinca Reviewed-By: Benjamin Gruenbaum --- doc/api/crypto.md | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/doc/api/crypto.md b/doc/api/crypto.md index b156ee9e03806f..61172d3c4c49ee 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -5414,21 +5414,6 @@ and returned `'latin1'` encoded strings by default rather than `Buffer`s. This default was changed after Node.js v0.8 to use [`Buffer`][] objects by default instead. -### Recent ECDH changes - -Usage of `ECDH` with non-dynamically generated key pairs has been simplified. -Now, [`ecdh.setPrivateKey()`][] can be called with a preselected private key -and the associated public point (key) will be computed and stored in the object. -This allows code to only store and provide the private part of the EC key pair. -[`ecdh.setPrivateKey()`][] now also validates that the private key is valid for -the selected curve. - -The [`ecdh.setPublicKey()`][] method is now deprecated as its inclusion in the -API is not useful. Either a previously stored private key should be set, which -automatically generates the associated public key, or [`ecdh.generateKeys()`][] -should be called. The main drawback of using [`ecdh.setPublicKey()`][] is that -it can be used to put the ECDH key pair into an inconsistent state. - ### Support for weak or compromised algorithms The `crypto` module still supports some algorithms which are already @@ -5971,7 +5956,6 @@ See the [list of SSL OP Flags][] for details. [`diffieHellman.setPublicKey()`]: #diffiehellmansetpublickeypublickey-encoding [`ecdh.generateKeys()`]: #ecdhgeneratekeysencoding-format [`ecdh.setPrivateKey()`]: #ecdhsetprivatekeyprivatekey-encoding -[`ecdh.setPublicKey()`]: #ecdhsetpublickeypublickey-encoding [`hash.digest()`]: #hashdigestencoding [`hash.update()`]: #hashupdatedata-inputencoding [`hmac.digest()`]: #hmacdigestencoding