Uh oh!
There was an error while loading. Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork 34.2k
doc,test: clarify ChaCha20-Poly1305 usage#42323
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc,test: clarify ChaCha20-Poly1305 usage #42323
Uh oh!
There was an error while loading. Please reload this page.
Conversation
nodejs-github-bot commented Mar 13, 2022
mscdex commented Mar 13, 2022
Perhaps we should also note that this particular chacha20-poly1305 implementation conforms to RFC 7539 (IIRC)? |
tniessen commented Mar 13, 2022
Ideally, yes, but I haven't figured out where to best put that information without duplicating it across all relevant functions. Suggestions welcome, otherwise, I think we'll have to gradually improve the documentation over time. |
nodejs-github-bot commented Mar 14, 2022
tniessen commented Mar 16, 2022 • edited
Loading Uh oh!
There was an error while loading. Please reload this page.
edited
Uh oh!
There was an error while loading. Please reload this page.
@mscdex#42370 adds it to the existing mentions of |
d1bbf33 to 0307193Comparetniessen commented Mar 20, 2022
Rebased without changes. |
This comment was marked as outdated.
This comment was marked as outdated.
nodejs-github-bot commented Mar 20, 2022
nodejs-github-bot commented Mar 21, 2022
Landed in 6559261 |
tniessen commented Mar 21, 2022
Thanks for reviewing! |
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs#42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs#42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: #42323 Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs/node#42323 Reviewed-By: James M Snell <[email protected]>
The crypto documentation does not list
chacha20-poly1305as a supported AEAD algorithm and omits that the algorithm requires passing theauthTagLengthoption.This patch changes that and also adds a test to assert that the documented behavior is correct.
Arguably,
chacha20-poly1305should not require theauthTagLengthoption. I'll probably open a separate semver-minor PR to address that and update the documentation accordingly.