Doc #71365 [Com]: random_bytes(): missing Error causes; may return PRNG

[email protected] ("[email protected]") Wed, 25 Jan 2023 19:54:14 +0000
Newsgroups php.doc.bugs
Message-ID <[email protected]>
Edit report at https://bugs.php.net/bug.php?id=71365&edit=1

 ID:                 71365
 Comment by:         [email protected]
 Reported by:        salsi at icosaedro dot it
 Summary:            random_bytes(): missing Error causes; may return
                     PRNG
 Status:             Open
 Type:               Documentation Problem
 Package:            Unknown/Other Function
 PHP Version:        7.0.2
 Block user comment: N
 Private report:     N

 New Comment:

Current versions of PHP preferably use the getrandom(2) syscall if available and thus are not affected by low entropy situations shortly after boot, because the syscall blocks until sufficient entropy has been obtained. Even with older versions or operating systems that use /dev/urandom, it is generally not possible to “exhaust” the CSPRNG, as also explained by the “Myths about urandom” link.

Likewise the CSPRNG is effectively infallible on modern PHP versions and operating systems. I believe the information that the functions relying on the CSPRNG might throw if no source can be found is sufficient, the distinction between a missing source and a failing source does not provide a real value-add for the reader, because it is not actionable.

Please open an issue in the php/doc-en repository if you feel further clarification in the documentation is required: https://github.com/php/doc-en/issues


Previous Comments:
------------------------------------------------------------------------
[2016-01-17 16:01:12] public+php dot net at bastelstu dot be

http://www.2uo.de/myths-about-urandom/

------------------------------------------------------------------------
[2016-01-14 05:37:45] salsi at icosaedro dot it

Description:
------------
---
From manual page: http://www.php.net/function.random-bytes
---

Examining the C source code, appears that the Error exception might be thrown also on failed reading from the source of randomness, or no enough entropy is available (whenever an estimation of the available entropy is available).

It might worth to mention also that if not enough entropy data is available, some implementations (notably when reading from /dev/urandom as a last resort) may return values from a PRNG rather than from a CSPRNG, so partially defeating the purpose of this function for CS applications.

The same holds for the companion random_int() function, which relies on the same base function as random_bytes().

Programmers should be advised that abusing of the entropy source may then compromise security, and those entropy sources should be used sparingly.



------------------------------------------------------------------------



--
Edit this bug report at https://bugs.php.net/bug.php?id=71365&edit=1