aboutsummaryrefslogtreecommitdiffstats
path: root/docs/random-numbers.rst
blob: c8f95fd8da37ec7767fa31ee12c61577cad05f76 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Random number generation
========================

When generating random data for use in cryptographic operations, such as an
initialization vector for encryption in
:class:`~cryptography.hazmat.primitives.ciphers.modes.CBC` mode, you do not
want to use the standard :mod:`random` module APIs. This is because they do not
provide a cryptographically secure random number generator, which can result in
major security issues depending on the algorithms in use.

Therefore, it is our recommendation to always use your operating system's
provided random number generator, which is available as ``os.urandom()``. For
example, if you need 16 bytes of random data for an initialization vector, you
can obtain them with:

.. doctest::

    >>> import os
    >>> os.urandom(16)
    '...'