-r--r--r-- 20038 librandombytes-20230919/doc/html/security.html raw
<html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <style type="text/css"> html{overflow-y:scroll} body{font-family:"Noto Sans","Droid Sans","DejaVu Sans","Arial",sans-serif;line-height:1.5} tt,code{background-color:#f0f0f0;font-family:"Noto Sans Mono","Droid Sans Mono","DejaVu Sans Mono","Courier New",monospace,sans-serif;font-size:1em;} pre{margin-left:3em} p,ul,ol,blockquote,pre{font-size:1.0em;line-height:1.6} li p{font-size:1.0em} blockquote p{font-size:1.0em} h1{font-size:1.5em} h2{font-size:1.3em} h3{font-size:1.0em} h1 a{text-decoration:none} table{border-collapse:collapse} th,td{border:1px solid black} table a{text-decoration:none} table tr{font-size:1.0em;line-height:1.6} .links a:hover{text-decoration:underline} .links a:active{text-decoration:underline} .links img{width:200px;padding-left:1em} .links td{border:0px;padding-top:0.5em;padding-bottom:0.5em} .headline{padding:0;font-weight:bold;font-size:1.5em;vertical-align:top;padding-bottom:0.5em;color:#2f8a59} .navt{display:inline-block;box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box; min-width:14%;margin:0;padding:0;padding-left:0.5em;padding-right:0.5em;vertical-align:center; font-weight:bold;font-size:1.1em;text-align:center;border:1px solid black} .here{border-bottom:0px;background-color:#ffffff} .away{background-color:#2f8a59;} .away a{text-decoration:none;display:block;color:#ffffff} .away a:hover,.away a:active{text-decoration:underline} .main{margin:0;padding-top:0em;padding-bottom:1%;clear:both} </style> <title> librandombytes: Security</title> </head> <body> <div class=headline> librandombytes</div> <div class=nav> <div class="navt away"><a href=index.html>Intro</a> </div><div class="navt away"><a href=download.html>Download</a> </div><div class="navt away"><a href=install.html>Install</a> </div><div class="navt away"><a href=api.html>API</a> </div><div class="navt here">Security </div><div class="navt away"><a href=license.html>License</a> </div></div> <div class=main> <p>The standard security goal for a random-number generator (RNG) is that no feasible computation can distinguish the RNG output from true randomness, i.e., from a uniform random string of the same length. This allows applications to treat the RNG output as true randomness.</p> <p>Beyond merely asking for indistinguishability, some applications ask for "forward secrecy". This means that the RNG output is indistinguishable from true randomness for an attacker who sees the subsequent state of the entire device, including the internal state of the RNG.</p> <p>A typical explanation of the importance of forward secrecy is as follows: "A rogue country's spy agency has intercepted ciphertexts that a whistleblower has sent to a journalist. Agents then grab the whistleblower's computer while the computer is unlocked, take it away for analysis, and see that the whistleblower deleted the messages after sending them. Can the agency use the computer's current RNG state to reconstruct old keys and decrypt the ciphertexts?"</p> <p>Sometimes there are also requests for "backward secrecy". A strict interpretation of backward secrecy says that an attacker who sees the state of the entire device cannot distinguish the <em>next</em> RNG output from uniform. A weaker variant is for secrecy to <em>eventually</em> be restored after a compromise. Either way, backward secrecy is advertised as providing "self-healing", "post-compromise security", etc. Beware that this assumes a questionable concept of compromise as a one-time event rather than a naturally persistent state; meanwhile the complications of trying to achieve "post-compromise security" have a long history of distracting attention from the more fundamental task of preventing compromises in the first place.</p> <p>Whether or not backward secrecy is desired, there are many ways for RNGs to fail to provide forward secrecy, or to fail to even reach the standard security goal. For example:</p> <ul> <li> <p>After source code for the RC4 stream cipher was posted anonymously in 1994, RC4 was rapidly shown to flunk the standard definition of cipher security. Before and after this, RC4 was pushed by NSA (which had set up <a href="https://cr.yp.to/export/dtn/V3N4_10_92.pdf">special procedures</a> to allow RC4 export licenses) and by the RSA company. RC4 remained in wide use for two decades for TLS encryption and for RNGs.</p> </li> <li> <p>Around 2005, NSA paid the RSA company <a href="https://www.reuters.com/article/us-usa-security-rsa-idUSBRE9BJ1C220131220">$10 million</a> to use Dual EC as the default RNG in RSA's BSAFE library. Dual EC was an RNG designed to be <a href="https://projectbullrun.org/dual-ec/index.html">predictable by NSA</a>.</p> </li> <li> <p>Newer RNGs have often turned out to be feasible to distinguish from uniform. Common contributing factors include inadequate attention to security (which is hard to measure) and much more attention to performance (which is much easier to measure). For example, a <a href="https://tosc.iacr.org/index.php/ToSC/article/view/8700">2020 attack</a> uses just 2<sup>57</sup> CPU cycles to recover the secret "seed" and secret "increment" of the "PCG64" RNG.</p> </li> <li> <p>Many RNG constructions advertised as "provably secure" constructions based on well-studied cryptographic primitives turn out to provide much lower security levels than desired. For example, AES-256-CTR, the usual "provably secure" way to use AES-256 as a stream cipher and RNG, provably flunks a simple collision test after 2<sup>68</sup> bytes of output. This is not a sharp cutoff: one needs a much smaller limit on the output length to avoid having this attack succeed with probability measurably above 0.</p> </li> <li> <p>Even after the removal of Dual EC, NIST's "SP 800-90" RNG standard remains unnecessarily complicated and unnecessarily difficult to analyze. A partial analysis in 2018 showed that SP 800-90A <a href="https://eprint.iacr.org/2018/349">failed to provide</a> some of its claimed forward-secrecy properties. Also, because of performance problems in how NIST handles short outputs, applications are encouraged to add their own larger output buffers, typically compromising forward secrecy.</p> </li> </ul> <p>Furthermore, RNG security can be compromised by implementation failures. For example:</p> <ul> <li> <p>The AES design encourages implementors to use "T-table" implementations on many platforms, exposing secret keys to <a href="https://cr.yp.to/papers.html#cachetiming">cache-timing attacks</a>.</p> </li> <li> <p>If a virtual machine generates RNG output (perhaps used for a nonce sent to an attacker) and is then restored from a snapshot, many types of RNGs will generate the same RNG output again (perhaps then used for a secret key). This recycling compromises the security of various applications that would otherwise be safe.</p> </li> <li> <p>Similarly, many types of RNGs will produce identical results in parent and child processes after <code>fork()</code>, again compromising security of various applications that would otherwise be safe.</p> </li> <li> <p>In 2006, the Debian OS distribution incorrectly removed essential lines of code from the OpenSSL RNG, producing easily breakable keys in various cryptographic applications. Other Debian-based distributions, such as Ubuntu, copied the change.</p> <p>The Debian error was publicly discovered and corrected in 2008. A <a href="https://fahrplan.events.ccc.de/congress/2008/Fahrplan/events/2995.en.html">review</a> showed that the error was triggered by warnings from a code-analysis tool that did not understand what was going on in the RNG code.</p> </li> <li> <p>In 2012, two <a href="https://eprint.iacr.org/2012/064">independent</a> <a href="https://factorable.net/">papers</a> showed that a noticeable percentage of RSA public keys available on the Internet were factorable because two keys had factors in common.</p> <p>The second paper observed vulnerable keys from Linux, FreeBSD, and Windows, and gave a convincing explanation of how randomness would repeat on embedded Linux systems:</p> <ul> <li> <p>The Linux kernel accumulated entropy very slowly on small devices.</p> </li> <li> <p>Keys were generated by the device on first boot, starting very early in the boot process.</p> </li> <li> <p><code>/dev/urandom</code>, the source of randomness, returned data without waiting for 256 bits of entropy to be collected.</p> </li> </ul> <p>Another available mechanism, <code>/dev/random</code>, waited for entropy but was justifably avoided by many applications. This mechanism had the serious misfeature of also waiting for further entropy for every subsequent call; slow entropy collection thus turned <code>/dev/random</code> into a <a href="https://github.com/openssl/openssl/issues/9078">problematic</a> bottleneck.</p> </li> <li> <p>In 2018, a Linux kernel bug was <a href="https://lkml.org/lkml/2018/4/12/711">discovered</a> that would result in <code>/dev/random</code> not waiting long enough for entropy to be collected.</p> </li> </ul> <p>RNG failures are often used as motivation for the development of further RNGs, but if this process is not carefully managed then it increases the load on reviewers and encourages further security problems.</p> <p>librandombytes does not provide a new RNG; it is a wrapper around existing RNGs. It does not wrap every available RNG; it limits the number of options to simplify review. It takes the maximally centralized option, the OS kernel's RNG, by default; it provides one backup option, the OpenSSL RNG, just in case this is critical for system performance.</p> <p>Usage of the OS kernel's RNG has an imperfect track record, as illustrated by the papers from 2012 cited above. This is concerning. However, there are reasons to believe that risks have been reduced:</p> <ul> <li> <p>There is increasing adoption of OpenBSD's approach of provisioning all devices with initial randomness at installation time, for example by having a computer generate initial randomness for a device that it is flashing or for a new virtual-machine image.</p> </li> <li> <p>There is increasing usage of mechanisms to quickly collect entropy, even on small devices. This serves as a backup if initial randomness fails, and can rescue forward secrecy when flash does not adequately erase randomness that was stored for the next boot. Also, people trying to achieve backward secrecy require these mechanisms.</p> </li> <li> <p>There is increasing usage of mechanisms for virtual machines to collect entropy from the host machine, such as <code>virtio-rng</code>.</p> </li> <li> <p>It is increasingly common for CPUs to include RNG hardware, although this hardware is inherently difficult to audit and <a href="https://www.iacr.org/archive/ches2013/80860203/80860203.pdf">easy to sabotage</a>. A <a href="https://lore.kernel.org/all/776cb5c2d33e7fd0d2893904724c0e52b394f24a.1565817448.git.thomas.lendacky@amd.com/T/#u">BIOS bug</a> removed all entropy from the RNG on AMD CPUs after suspend/resume; the bug wasn't addressed for five years.</p> </li> <li> <p>There is increasing availability of <code>getrandom</code> and/or <code>getentropy</code>. These functions wait for initial entropy to be collected (without the <code>/dev/random</code> misfeature of also waiting for further entropy for every subsequent call). This avoids security problems in the disaster scenario of initial randomness failing and entropy collection being slow. Some history:</p> <ul> <li> <p>2014: <code>getentropy</code> was introduced in OpenBSD 5.6, and <code>getrandom</code> was introduced (as a variant of <code>getentropy</code>) in Linux kernel 3.17.</p> </li> <li> <p>2015: <code>getentropy</code> and <code>getrandom</code> were added to <a href="https://blogs.oracle.com/solaris/post/solaris-new-system-calls-getentropy2-and-getrandom2">Solaris 11.3</a>.</p> </li> <li> <p>2017: <code>getentropy</code> and <code>getrandom</code> were added to <a href="https://sourceware.org/legacy-ml/libc-alpha/2017-02/msg00079.html">glibc 2.25</a>, with <code>getentropy</code> provided as a wrapper around <code>getrandom</code> on Linux systems.</p> </li> <li> <p>2018: <code>getentropy</code> and <code>getrandom</code> were added to <a href="https://www.freebsd.org/releases/12.0R/relnotes/">FreeBSD 12.0</a>.</p> </li> </ul> <p>FreeBSD already changed <code>/dev/urandom</code> <a href="https://papers.freebsd.org/2017/vbsdcon/gurney-A_Deep_Dive_into_FreeBSDs_Kernel_RNG.files/gurney-A_Deep_Dive_into_FreeBSDs_Kernel_RNG.pdf">in 2000</a> to wait for initial entropy to be collected, already bringing the same benefit without requiring applications to adopt a new interface. For OpenBSD, randomness was always available from installation time, so <code>/dev/urandom</code> never had a reason to wait. (But <code>getrandom</code> and <code>getentropy</code> have separate advantages of not relying on opening a file; this simplifies <code>chroot</code> setups and avoids various failure cases.)</p> </li> <li> <p>There is increasing convergence upon the ChaCha20 stream cipher as the foundation of random-number generation.</p> <p>ChaCha20 is a 2008 variant of the 2005 Salsa20 stream cipher, and is one of just two ciphers in TLS 1.3. ChaCha20 is stronger against known attacks than the other TLS 1.3 cipher, AES-256-CTR; recall that AES-256-CTR flunks a feasible collision test. ChaCha20 also does not have AES's problem of encouraging variable-time software.</p> <p>Regarding possible attack improvements, the challenge of breaking scaled-down versions of Salsa20 and ChaCha20 has attracted 20 attacks from <a href="https://cr.yp.to/snuffle.html#security">43 cryptanalysts</a>. With the published techniques, ChaCha6 is feasible to break by a large-scale attack, and ChaCha7 is subject to an attack faster than brute force. (For comparison, even if the aforementioned collision failure is ignored, 6 out of the 14 rounds of AES-256 are breakable by a feasible attack, and 8 out of the 14 rounds of AES-256 are subject to an attack faster than brute force.) The long-term security of ChaCha8 is unclear, but the recommended ChaCha20 has very low risk.</p> </li> <li> <p>There is increasing convergence upon a simple, efficient, easily analyzed mechanism to provide forward secrecy given a strong stream cipher: <a href="https://blog.cr.yp.to/20170723-random.html">fast-key-erasure RNGs</a>. Examples of these RNGs include</p> <ul> <li> <p>2013: Nick Mathewson's <a href="https://github.com/nmathewson/libottery">libottery</a>, which says it is "based on a construction described in XXX, as summarized by DJB";</p> </li> <li> <p>2013: OpenBSD's <a href="https://github.com/openbsd/src/commit/90c1fad70a3483c2c72c3c90acf438a5f235c776"><code>arc4random</code> update</a>, with credit to libottery, replacing previous use of RC4;</p> </li> <li> <p>2018: FreeBSD's <a href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=182610"><code>arc4random</code> update</a>, with credit to libottery and OpenBSD; and</p> </li> <li> <p>2022: Linux's <a href="https://www.zx2c4.com/projects/linux-rng-5.17-5.18/inside-linux-kernel-rng-presentation-sept-13-2022.pdf">RNG updates</a>.</p> </li> </ul> <p>A 2005 paper by <a href="https://eprint.iacr.org/2005/029">Barak and Halevi</a> analyzes the following special case of fast-key-erasure RNGs: an m-bit key is used to generate 2m bits of stream-cipher output, split into m bits of RNG output and m bits to overwrite the key. A general fast-key-erasure RNG obtains the same security properties at much higher speed by generating more output from each key: e.g., 768 bytes of output from a 32-byte key.</p> </li> </ul> <p><code>librandombytes-kernel</code> uses <code>getrandom</code> if it finds it, otherwise <code>getentropy</code> if it finds it, otherwise <code>/dev/urandom</code>. In the case of <code>/dev/urandom</code>, <code>librandombytes-kernel</code> waits at program startup for <code>/dev/random</code> to become readable; however, it skips this if the file <code>/var/run/urandom-ready</code> exists (or if <code>/dev/random</code> does not exist).</p> <p>The idea is that system administrators of Linux systems too old to have <code>getrandom</code> can run</p> <pre><code>dd count=1 bs=64 if=/dev/random of=/dev/urandom status=none \ &amp;&amp; findmnt -t tmpfs -T /var/run &gt;/dev/null \ &amp;&amp; touch /var/run/urandom-ready &amp; </code></pre> <p>from boot scripts so that <code>librandombytes-kernel</code> doesn't wait after initial per-boot entropy collection. Note that systems where <code>/var/run</code> is a persistent directory (rather than <code>tmpfs</code>), cleared by boot scripts, should not create <code>/var/run/urandom-ready</code>, since <code>librandombytes-kernel</code> might be running earlier in the boot process.</p> <p>There are various other ways that one can imagine <code>/dev/urandom</code> being read too early on old Linux systems (and not so old, as in the 2018 Linux bug mentioned above); <code>librandombytes-kernel</code> tries to reduce risks but does not make guarantees. Provisioning systems with initial randomness is recommended in all cases. There are also many other security reasons to recommend retiring old Linux systems if they cannot be upgraded.</p> <p><code>librandombytes-openssl</code>, which simply calls OpenSSL's <code>RAND_bytes</code>, raises more security concerns:</p> <ul> <li> <p>OpenSSL's <code>RAND_bytes</code> maintains an RNG state in user space, evidently because of a belief that this produces an important speedup. With its current defaults, OpenSSL can take an hour before it reseeds the user RNG state from the OS. This means that whatever entropy-injection mechanisms are in the OS RNG, for example to protect virtual machines, can leave OpenSSL unprotected for an hour.</p> </li> <li> <p>OpenSSL's default RNG, starting in <a href="https://www.openssl.org/blog/blog/2017/08/12/random/">2017</a>, is a NIST RNG, specifically CTR-DRBG built on top of AES. A <a href="https://eprint.iacr.org/2019/996">2019 attack</a> showed that OpenSSL in FIPS mode was using T-table implementations of AES and was leaking RNG secrets to a timing attack. Even with a constant-time AES implementation, the security level of this RNG is not clear from the existing literature.</p> </li> <li> <p>When OpenSSL first seeds its RNG from <code>/dev/urandom</code> on pre-<code>getrandom</code> Linux systems, it waits (starting with OpenSSL 1.1.1d in 2019) for <code>/dev/random</code> to become readable, and then creates shared memory segment 114. It skips the <code>/dev/random</code> wait if shared memory segment 114 exists already. This does not have the same security properties as checking for existence of a file that can be created only by root: if <em>any</em> account on the same system is running code from an attacker then the attacker can create shared memory segment 114, disabling the <code>/dev/random</code> test for all OpenSSL instances on the same system.</p> </li> </ul> <p>These OpenSSL issues are not obviously showstoppers. For systems where using the OS RNG is a performance problem, OpenSSL's RNG seems to be a reasonable backup plan. Of course, it would be possible to patch OpenSSL to use a fast-key-erasure RNG on top of ChaCha20, to use a safer <code>/dev/random</code> test (which could also be handled as a wrapper around OpenSSL), and to reseed more frequently.</p><hr><font size=1><b>Version:</b> This is version 2023.09.04 of the "Security" web page. </font> </div> </body> </html>