Skip to content
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

Add caveats section in the doc of crypto #3479

Closed
wants to merge 7 commits into from

Conversation

shigeki
Copy link
Contributor

@shigeki shigeki commented Oct 22, 2015

This is originally from nodejs/node-v0.x-archive#25564.

This adds caveats section in the crypto api documentation to notify users of the risks of weak algorithms and small keys and revises examples to use safe ones.

Fix: #3406

Shigeki Ohtsu and others added 5 commits October 22, 2015 11:06
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

The crypto module still supports some algorithms which are already
compromised. And the API also allows to use ciphers and hashes with a
small key size that are consider to be weak for a safe use.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"... that are considered to be too weak for safe use."

@jasnell
Copy link
Member

jasnell commented Oct 22, 2015

Looks good in general but a few nits.

@shigeki
Copy link
Contributor Author

shigeki commented Oct 22, 2015

@jasnell Thanks. I revised the doc and add a commit.

@brendanashworth brendanashworth added crypto Issues and PRs related to the crypto subsystem. doc Issues and PRs related to the documentations. labels Oct 22, 2015
## Caveats

The crypto module still supports some algorithms which are already
compromised. And the API also allows to use ciphers and hashes with a
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"And the API also allows the use of ciphers and hashes with a" (replace to with the)

@jasnell
Copy link
Member

jasnell commented Oct 22, 2015

Thank you @shigeki ... just a few more I promise ;-). It's great that these recommendations are being updated!

@shigeki
Copy link
Contributor Author

shigeki commented Oct 22, 2015

@jasnell Thanks for reviewing. It is very helpful for me to correct my English. I appreciate that. The additional fix was made in db5b6e2. Commits will be squashed later.

@jasnell
Copy link
Member

jasnell commented Oct 22, 2015

LGTM! Thanks @shigeki !

@jasnell
Copy link
Member

jasnell commented Oct 22, 2015

@indutny ... any feedback before I land?

@jasnell
Copy link
Member

jasnell commented Oct 28, 2015

@indutny ... ping?

shigeki pushed a commit that referenced this pull request Nov 5, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
@jasnell
Copy link
Member

jasnell commented Nov 5, 2015

Landed in 017fc5b

@jasnell jasnell closed this Nov 5, 2015
shigeki pushed a commit that referenced this pull request Nov 7, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
@Fishrock123 Fishrock123 mentioned this pull request Nov 11, 2015
shigeki pushed a commit that referenced this pull request Nov 16, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
@MylesBorins
Copy link
Contributor

landed in lts-v4.x-staging as 4a94c0a

shigeki pushed a commit that referenced this pull request Dec 4, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
@jasnell jasnell mentioned this pull request Dec 17, 2015
shigeki pushed a commit that referenced this pull request Dec 17, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
shigeki pushed a commit that referenced this pull request Dec 23, 2015
Add description of user responsibility in the choice of cypto
algorithms and its key length. Some of recommendations for the safer
use are also described.

PR-URL: #3479
Reviewed-By: James M Snell <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
crypto Issues and PRs related to the crypto subsystem. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants