| Alex Gaynor | 2a70f91 | 2014-02-06 09:47:07 -0800 | [diff] [blame] | 1 | Random number generation |
| 2 | ======================== |
| 3 | |
| 4 | When generating random data for use in cryptographic operations, such as an |
| 5 | initialization vector for encryption in |
| 6 | :class:`~cryptography.hazmat.primitives.ciphers.modes.CBC` mode, you do not |
| 7 | want to use the standard :mod:`random` module APIs. This is because they do not |
| Alex Gaynor | cb15716 | 2014-02-06 10:27:48 -0800 | [diff] [blame^] | 8 | provide a cryptographically secure random number generator, which can result in |
| 9 | major security issues depending on the algorithms in use. |
| Alex Gaynor | 2a70f91 | 2014-02-06 09:47:07 -0800 | [diff] [blame] | 10 | |
| 11 | Therefore, it is our recommendation to always use your operating system's |
| 12 | provided random number generator, which is available as ``os.urandom()``. For |
| 13 | example, if you need 16 bytes of random data for an initialization vector, you |
| 14 | can obtain them with: |
| 15 | |
| 16 | .. doctest:: |
| 17 | |
| 18 | >>> import os |
| 19 | >>> os.urandom(16) |
| 20 | '...' |