Skip to content

Commit 31436a4

Browse files
reaperhulkalex
andauthored
admit to the existence of nuance in HKDF (#8987)
* admit to the existence of nuance in HKDF * Update docs/hazmat/primitives/key-derivation-functions.rst Co-authored-by: Alex Gaynor <[email protected]> --------- Co-authored-by: Alex Gaynor <[email protected]>
1 parent 91e4189 commit 31436a4

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

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

+3-1
Original file line numberDiff line numberDiff line change
@@ -460,7 +460,8 @@ HKDF
460460
to be secret, but may cause stronger security guarantees if secret; see
461461
:rfc:`5869` and the `HKDF paper`_ for more details. If ``None`` is
462462
explicitly passed a default salt of ``algorithm.digest_size // 8`` null
463-
bytes will be used.
463+
bytes will be used. See `understanding HKDF`_ for additional detail about
464+
the salt and info parameters.
464465

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

0 commit comments

Comments
 (0)