xemu/include/crypto
Richard W.M. Jones e1a6dc91dd crypto: Implement TLS Pre-Shared Keys (PSK).
Pre-Shared Keys (PSK) is a simpler mechanism for enabling TLS
connections than using certificates.  It requires only a simple secret
key:

  $ mkdir -m 0700 /tmp/keys
  $ psktool -u rjones -p /tmp/keys/keys.psk
  $ cat /tmp/keys/keys.psk
  rjones:d543770c15ad93d76443fb56f501a31969235f47e999720ae8d2336f6a13fcbc

The key can be secretly shared between clients and servers.  Clients
must specify the directory containing the "keys.psk" file and a
username (defaults to "qemu").  Servers must specify only the
directory.

Example NBD client:

  $ qemu-img info \
    --object tls-creds-psk,id=tls0,dir=/tmp/keys,username=rjones,endpoint=client \
    --image-opts \
    file.driver=nbd,file.host=localhost,file.port=10809,file.tls-creds=tls0,file.export=/

Example NBD server using qemu-nbd:

  $ qemu-nbd -t -x / \
    --object tls-creds-psk,id=tls0,endpoint=server,dir=/tmp/keys \
    --tls-creds tls0 \
    image.qcow2

Example NBD server using nbdkit:

  $ nbdkit -n -e / -fv \
    --tls=on --tls-psk=/tmp/keys/keys.psk \
    file file=disk.img

Signed-off-by: Richard W.M. Jones <rjones@redhat.com>
Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2018-07-03 13:04:38 +01:00
..
aes.h crypto: aes: always rename internal symbols 2016-06-13 12:41:17 +01:00
afsplit.h Clean up ill-advised or unusual header guards 2016-07-12 16:20:46 +02:00
block.h block: convert qcrypto_block_encrypt|decrypt to take bytes offset 2017-10-06 16:30:47 +02:00
cipher.h Include less of the generated modular QAPI headers 2018-03-02 13:45:50 -06:00
desrfb.h Clean up header guards that don't match their file name 2016-07-12 16:19:16 +02:00
hash.h Include less of the generated modular QAPI headers 2018-03-02 13:45:50 -06:00
hmac.h Include less of the generated modular QAPI headers 2018-03-02 13:45:50 -06:00
init.h Clean up ill-advised or unusual header guards 2016-07-12 16:20:46 +02:00
ivgen.h Clean up ill-advised or unusual header guards 2016-07-12 16:20:46 +02:00
pbkdf.h crypto: use correct derived key size when timing pbkdf 2016-09-19 16:30:45 +01:00
random.h Include qapi/error.h exactly where needed 2018-02-09 13:50:17 +01:00
secret.h Include less of the generated modular QAPI headers 2018-03-02 13:45:50 -06:00
tlscreds.h Include less of the generated modular QAPI headers 2018-03-02 13:45:50 -06:00
tlscredsanon.h Clean up header guards that don't match their file name 2016-07-12 16:19:16 +02:00
tlscredspsk.h crypto: Implement TLS Pre-Shared Keys (PSK). 2018-07-03 13:04:38 +01:00
tlscredsx509.h Clean up header guards that don't match their file name 2016-07-12 16:19:16 +02:00
tlssession.h Clean up header guards that don't match their file name 2016-07-12 16:19:16 +02:00
xts.h Include qapi/error.h exactly where needed 2018-02-09 13:50:17 +01:00