Skip to content

Common entropy source and DRNG management

Stephan Müller linux-crypto llvm oe-kbuild-all 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest7 patches 6 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/7crypto: DRBG - remove internal reseeding operationcrypto/algif_rng.c crypto/drbg.c crypto/testmgr.c +2 more+140 -13241 reply
2/7crypto: AF_ALG - remove ALG_SET_DRBG_ENTROPY interfacecrypto/Kconfig crypto/af_alg.c crypto/algif_rng.c +4 more+3 -1010 replies
3/7crypto: Entropy Source and DRNG Managercrypto/Kconfig crypto/Makefile crypto/esdm/Kconfig +14 more+1984 -00 replies
4/7crypto: move Jitter RNG header include dircrypto/jitterentropy-kcapi.c crypto/jitterentropy.c include/crypto/internal/jitterentropy.h+2 -30 replies
5/7crypto: ESDM - add Jitter RNG entropy sourcecrypto/esdm/Kconfig crypto/esdm/Makefile crypto/esdm/esdm_es_jent.c +3 more+199 -00 replies
6/7crypto: ESDM - add Kernel RNG entropy sourcecrypto/esdm/Kconfig crypto/esdm/Makefile crypto/esdm/esdm_es_krng.c +3 more+173 -00 replies
7/7crypto: ESDM - add kernel crypto API RNG interfacecrypto/esdm/Kconfig crypto/esdm/Makefile crypto/esdm/esdm_drng_kcapi.c +2 more+116 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH 0/7] Common entropy source and DRNG management

The current code base of the kernel crypto API random number support leaves the task to seed and reseed the DRNG to either the caller or the DRNG implementation. The code in crypto/drbg.c implements its own seeding strategy. crypto/ansi_cprng.c does not contain any seeding operation. The implementation in arch/s390/crypto/prng.c has yet another approach for seeding. Albeit the crypto_rng_reset() contains a seeding logic from get_random_bytes, there is no management of the DRNG to ensure proper reseeding or control which entropy sources are used for pulling data from.

The task of seeding and reseeding a DRNG including the controlling of the state of the entropy sources is security sensitive as the strength of the data obtained from the DRNG rests in large parts on the proper seeding. In addition, various aspects need to be considered when (re)seeding a DRNG. This gap is filled with the Entropy Source and DRNG Manager (ESDM) proposed by this patch set.

The ESDM consists of two managers: the manager for the DRNG(s) and manager for the entropy sources. The DRNG manager ensures that DRNGs are properly seeded before random numbers are obtained from them. Similarly, the entropy source manager ensures that the available entropy sources are properly initialized if needed, and that data is obtained with an appropriately considered entropy rate.

Both, the DRNG and entropy source managers offer a pluggable interface allowing to use different DRNG implementations as well as various entropy sources. Each provided entropy source may be enabled during compile time. The ESDM therefore provides flexibility in the future to extend the set of entropy sources or the supported DRNGs to the required algorithms.

The patch set consists of the following changes:

- Patch 1 removes the seeding and reseeding logic from the DRBG transforming it into a pure deterministic implementation.

- Patch 2 removes the special AF_ALG interface used to test the DRBG implementation which requires bypassing of the DRBG automated seeding from entropy sources. With patch 1 this is not needed any more.

- Patch 3 adds the ESDM with its DRNG and entropy source managers. It contains the support to use the kernel crypto API's DRNG implementations.

- Patches 4 and 5 use the existing Jitter RNG as an entropy source for the ESDM.

- Patch 6 provides the glue code to use the get_random_bytes function as entropy source to the ESDM.

- Patch 7 adds the ESDM interface to register it with the kernel crypto API RNG framework as "stdrng" with the highest priority. This way, the ESDM is used per default when using the call crypto_get_default_rng().

With this patch series, callers to the kernel crypto API would not experience any difference. When using the RNG framework, the function crypto_get_default_rng is commonly used. Instead of providing the DRBG implementation, the ESDM is used which returns random numbers from a properly seeded DRBG.

Stephan Mueller (7):
crypto: DRBG - remove internal reseeding operation
crypto: AF_ALG - remove ALG_SET_DRBG_ENTROPY interface
crypto: Entropy Source and DRNG Manager
crypto: move Jitter RNG header include dir
crypto: ESDM - add Jitter RNG entropy source
crypto: ESDM - add Kernel RNG entropy source
crypto: ESDM - add kernel crypto API RNG interface

 crypto/Kconfig                                |  11 +-
 crypto/Makefile                               |   1 +
 crypto/af_alg.c                               |   7 -
 crypto/algif_rng.c                            |  74 +-
 crypto/drbg.c                                 | 640 ++++-------------
 crypto/esdm/Kconfig                           | 166 +++++
 crypto/esdm/Makefile                          |  15 +
 crypto/esdm/esdm_definitions.h                | 141 ++++
 crypto/esdm/esdm_drng_kcapi.c                 | 202 ++++++
 crypto/esdm/esdm_drng_kcapi.h                 |  13 +
 crypto/esdm/esdm_drng_mgr.c                   | 398 +++++++++++
 crypto/esdm/esdm_drng_mgr.h                   |  85 +++
 crypto/esdm/esdm_es_aux.c                     | 332 +++++++++
 crypto/esdm/esdm_es_aux.h                     |  44 ++
 crypto/esdm/esdm_es_jent.c                    | 128 ++++
 crypto/esdm/esdm_es_jent.h                    |  17 +
 crypto/esdm/esdm_es_krng.c                    | 120 ++++
 crypto/esdm/esdm_es_krng.h                    |  17 +
 crypto/esdm/esdm_es_mgr.c                     | 372 ++++++++++
 crypto/esdm/esdm_es_mgr.h                     |  46 ++
 crypto/esdm/esdm_es_mgr_cb.h                  |  73 ++
 crypto/esdm/esdm_interface_kcapi.c            |  91 +++
 crypto/esdm/esdm_sha.h                        |  14 +
 crypto/esdm/esdm_sha256.c                     |  72 ++
 crypto/jitterentropy-kcapi.c                  |   3 +-
 crypto/jitterentropy.c                        |   2 +-
 crypto/testmgr.c                              | 104 +--
 crypto/testmgr.h                              | 641 +-----------------
 include/crypto/drbg.h                         |  84 ---
 include/crypto/esdm.h                         | 115 ++++
 include/crypto/if_alg.h                       |   1 -
 .../crypto/internal}/jitterentropy.h          |   0
 include/crypto/internal/rng.h                 |   6 -
 include/crypto/rng.h                          |   4 -
 include/uapi/linux/if_alg.h                   |   2 +-
 35 files changed, 2615 insertions(+), 1426 deletions(-)
 create mode 100644 crypto/esdm/Kconfig
 create mode 100644 crypto/esdm/Makefile
 create mode 100644 crypto/esdm/esdm_definitions.h
 create mode 100644 crypto/esdm/esdm_drng_kcapi.c
 create mode 100644 crypto/esdm/esdm_drng_kcapi.h
 create mode 100644 crypto/esdm/esdm_drng_mgr.c
 create mode 100644 crypto/esdm/esdm_drng_mgr.h
 create mode 100644 crypto/esdm/esdm_es_aux.c
 create mode 100644 crypto/esdm/esdm_es_aux.h
 create mode 100644 crypto/esdm/esdm_es_jent.c
 create mode 100644 crypto/esdm/esdm_es_jent.h
 create mode 100644 crypto/esdm/esdm_es_krng.c
 create mode 100644 crypto/esdm/esdm_es_krng.h
 create mode 100644 crypto/esdm/esdm_es_mgr.c
 create mode 100644 crypto/esdm/esdm_es_mgr.h
 create mode 100644 crypto/esdm/esdm_es_mgr_cb.h
 create mode 100644 crypto/esdm/esdm_interface_kcapi.c
 create mode 100644 crypto/esdm/esdm_sha.h
 create mode 100644 crypto/esdm/esdm_sha256.c
 create mode 100644 include/crypto/esdm.h
 rename {crypto => include/crypto/internal}/jitterentropy.h (100%)
Signature · 1 line
2.33.1