From 05b17e92501310cef10a22c38cfcec3a819a0163 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tobias=20Nie=C3=9Fen?= Date: Sat, 17 Sep 2022 03:00:35 +0200 Subject: [PATCH] doc: maintain only one list of MODP groups There are two lists of MODP groups, one of which is redundant and does not mark weak groups as deprecated. Remove said list and refer readers to the first list instead. Refs: https://github.com/nodejs/node/pull/43986 Refs: https://github.com/nodejs/node/pull/44588 PR-URL: https://github.com/nodejs/node/pull/44644 Reviewed-By: Ben Noordhuis Reviewed-By: Antoine du Hamel Reviewed-By: Luigi Pinca --- doc/api/crypto.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/doc/api/crypto.md b/doc/api/crypto.md index f47a323ea386ea..8df01e3cbf801f 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -4118,10 +4118,9 @@ added: v0.7.5 * Returns: {DiffieHellmanGroup} Creates a predefined `DiffieHellmanGroup` key exchange object. The -supported groups are: `'modp1'`, `'modp2'`, `'modp5'` (defined in -[RFC 2412][], but see [Caveats][]) and `'modp14'`, `'modp15'`, -`'modp16'`, `'modp17'`, `'modp18'` (defined in [RFC 3526][]). The -returned object mimics the interface of objects created by +supported groups are listed in the documentation for [`DiffieHellmanGroup`][]. + +The returned object mimics the interface of objects created by [`crypto.createDiffieHellman()`][], but will not allow changing the keys (with [`diffieHellman.setPublicKey()`][], for example). The advantage of using this method is that the parties do not have to @@ -6117,7 +6116,6 @@ See the [list of SSL OP Flags][] for details. [OpenSSL's SPKAC implementation]: https://www.openssl.org/docs/man1.1.0/apps/openssl-spkac.html [RFC 1421]: https://www.rfc-editor.org/rfc/rfc1421.txt [RFC 2409]: https://www.rfc-editor.org/rfc/rfc2409.txt -[RFC 2412]: https://www.rfc-editor.org/rfc/rfc2412.txt [RFC 2818]: https://www.rfc-editor.org/rfc/rfc2818.txt [RFC 3526]: https://www.rfc-editor.org/rfc/rfc3526.txt [RFC 3610]: https://www.rfc-editor.org/rfc/rfc3610.txt @@ -6128,6 +6126,7 @@ See the [list of SSL OP Flags][] for details. [Web Crypto API documentation]: webcrypto.md [`BN_is_prime_ex`]: https://www.openssl.org/docs/man1.1.1/man3/BN_is_prime_ex.html [`Buffer`]: buffer.md +[`DiffieHellmanGroup`]: #class-diffiehellmangroup [`EVP_BytesToKey`]: https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html [`KeyObject`]: #class-keyobject [`Sign`]: #class-sign