qemu-e2k/include/crypto
Philippe Mathieu-Daudé 993aec27aa crypto: Add tls-cipher-suites object
On the host OS, various aspects of TLS operation are configurable.
In particular it is possible for the sysadmin to control the TLS
cipher/protocol algorithms that applications are permitted to use.

* Any given crypto library has a built-in default priority list
  defined by the distro maintainer of the library package (or by
  upstream).

* The "crypto-policies" RPM (or equivalent host OS package)
  provides a config file such as "/etc/crypto-policies/config",
  where the sysadmin can set a high level (library-independent)
  policy.

  The "update-crypto-policies --set" command (or equivalent) is
  used to translate the global policy to individual library
  representations, producing files such as
  "/etc/crypto-policies/back-ends/*.config". The generated files,
  if present, are loaded by the various crypto libraries to
  override their own built-in defaults.

  For example, the GNUTLS library may read
  "/etc/crypto-policies/back-ends/gnutls.config".

* A management application (or the QEMU user) may overide the
  system-wide crypto-policies config via their own config, if
  they need to diverge from the former.

Thus the priority order is "QEMU user config" > "crypto-policies
system config" > "library built-in config".

Introduce the "tls-cipher-suites" object for exposing the ordered
list of permitted TLS cipher suites from the host side to the
guest firmware, via fw_cfg. The list is represented as an array
of bytes.

The priority at which the host-side policy is retrieved is given
by the "priority" property of the new object type. For example,
"priority=@SYSTEM" may be used to refer to
"/etc/crypto-policies/back-ends/gnutls.config" (given that QEMU
uses GNUTLS).

The firmware uses the IANA_TLS_CIPHER array for configuring
guest-side TLS, for example in UEFI HTTPS Boot.

[Description from Daniel P. Berrangé, edited by Laszlo Ersek.]

Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Acked-by: Laszlo Ersek <lersek@redhat.com>
Message-Id: <20200623172726.21040-2-philmd@redhat.com>
2020-07-03 18:16:01 +02:00
..
aes.h crypto: aes: always rename internal symbols 2016-06-13 12:41:17 +01:00
afsplit.h Don't talk about the LGPL if the file is licensed under the GPL 2019-01-30 10:51:20 +01:00
block.h luks: extract qcrypto_block_calculate_payload_offset() 2020-03-11 12:42:29 +01:00
cipher.h crypto: define cleanup functions for use with g_autoptr 2019-08-22 10:47:12 +01:00
desrfb.h Clean up header guards that don't match their file name 2016-07-12 16:19:16 +02:00
hash.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
hmac.h crypto: define cleanup functions for use with g_autoptr 2019-08-22 10:47:12 +01:00
init.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
ivgen.h crypto: define cleanup functions for use with g_autoptr 2019-08-22 10:47:12 +01:00
pbkdf.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
random.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
secret.h crypto/secret: move main logic from 'secret' to 'secret_common'. 2020-06-15 11:33:51 +01:00
secret_common.h crypto/secret: move main logic from 'secret' to 'secret_common'. 2020-06-15 11:33:51 +01:00
secret_keyring.h crypto/linux_keyring: add 'secret_keyring' secret object. 2020-06-15 11:33:51 +01:00
tls-cipher-suites.h crypto: Add tls-cipher-suites object 2020-07-03 18:16:01 +02:00
tlscreds.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
tlscredsanon.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
tlscredspsk.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
tlscredsx509.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00
tlssession.h crypto: Fix typo in QCryptoTLSSession's <example> comment 2019-12-18 08:36:15 +01:00
xts.h crypto: Fix LGPL information in the file headers 2019-07-19 14:21:25 +01:00