Skip to content

Commit

Permalink
admit to the existence of nuance in HKDF (#8987)
Browse files Browse the repository at this point in the history
* admit to the existence of nuance in HKDF

* Update docs/hazmat/primitives/key-derivation-functions.rst

Co-authored-by: Alex Gaynor <alex.gaynor@gmail.com>

---------

Co-authored-by: Alex Gaynor <alex.gaynor@gmail.com>
  • Loading branch information
reaperhulk and alex authored May 30, 2023
1 parent 91e4189 commit 31436a4
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion docs/hazmat/primitives/key-derivation-functions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -460,7 +460,8 @@ HKDF
to be secret, but may cause stronger security guarantees if secret; see
:rfc:`5869` and the `HKDF paper`_ for more details. If ``None`` is
explicitly passed a default salt of ``algorithm.digest_size // 8`` null
bytes will be used.
bytes will be used. See `understanding HKDF`_ for additional detail about
the salt and info parameters.

:param bytes info: Application specific context information. If ``None``
is explicitly passed an empty byte string will be used.
Expand Down Expand Up @@ -1037,3 +1038,4 @@ Interface
.. _`here`: https://stackoverflow.com/a/30308723/1170681
.. _`recommends`: https://tools.ietf.org/html/rfc7914#section-2
.. _`The scrypt paper`: https://www.tarsnap.com/scrypt/scrypt.pdf
.. _`understanding HKDF`: https://soatok.blog/2021/11/17/understanding-hkdf/

0 comments on commit 31436a4

Please sign in to comment.