qemu/qapi
Daniel P. Berrange 4652b8f3e1 qcow2: add support for LUKS encryption format
This adds support for using LUKS as an encryption format
with the qcow2 file, using the new encrypt.format parameter
to request "luks" format. e.g.

  # qemu-img create --object secret,data=123456,id=sec0 \
       -f qcow2 -o encrypt.format=luks,encrypt.key-secret=sec0 \
       test.qcow2 10G

The legacy "encryption=on" parameter still results in
creation of the old qcow2 AES format (and is equivalent
to the new 'encryption-format=aes'). e.g. the following are
equivalent:

  # qemu-img create --object secret,data=123456,id=sec0 \
       -f qcow2 -o encryption=on,encrypt.key-secret=sec0 \
       test.qcow2 10G

 # qemu-img create --object secret,data=123456,id=sec0 \
       -f qcow2 -o encryption-format=aes,encrypt.key-secret=sec0 \
       test.qcow2 10G

With the LUKS format it is necessary to store the LUKS
partition header and key material in the QCow2 file. This
data can be many MB in size, so cannot go into the QCow2
header region directly. Thus the spec defines a FDE
(Full Disk Encryption) header extension that specifies
the offset of a set of clusters to hold the FDE headers,
as well as the length of that region. The LUKS header is
thus stored in these extra allocated clusters before the
main image payload.

Aside from all the cryptographic differences implied by
use of the LUKS format, there is one further key difference
between the use of legacy AES and LUKS encryption in qcow2.
For LUKS, the initialiazation vectors are generated using
the host physical sector as the input, rather than the
guest virtual sector. This guarantees unique initialization
vectors for all sectors when qcow2 internal snapshots are
used, thus giving stronger protection against watermarking
attacks.

Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
Message-id: 20170623162419.26068-14-berrange@redhat.com
Reviewed-by: Alberto Garcia <berto@igalia.com>
Signed-off-by: Max Reitz <mreitz@redhat.com>
2017-07-11 17:44:56 +02:00
..
block-core.json qcow2: add support for LUKS encryption format 2017-07-11 17:44:56 +02:00
block.json qapi: Fix some QMP documentation regressions 2017-06-04 18:42:55 +03:00
common.json qmp-commands: move 'query-commands' doc to schema 2017-01-16 09:19:47 +01:00
crypto.json qapi: The #optional tag is redundant, drop 2017-03-16 07:13:02 +01:00
event.json shutdown: Expose bool cause in SHUTDOWN and RESET events 2017-05-23 13:28:17 +02:00
introspect.json qapi: The #optional tag is redundant, drop 2017-03-16 07:13:02 +01:00
Makefile.objs qapi: rename *qmp-*-visitor* to *qobject-*-visitor* 2016-10-25 16:25:48 +02:00
opts-visitor.c qapi: Fix QemuOpts visitor regression on unvisited input 2017-03-22 19:24:34 +01:00
qapi-clone-visitor.c qapi: Remove visit_start_alternate() parameter promote_int 2017-06-20 14:31:31 +02:00
qapi-dealloc-visitor.c qapi: Remove visit_start_alternate() parameter promote_int 2017-06-20 14:31:31 +02:00
qapi-util.c qapi: New parse_qapi_name() 2017-03-07 16:07:47 +01:00
qapi-visit-core.c qapi: Remove visit_start_alternate() parameter promote_int 2017-06-20 14:31:31 +02:00
qmp-dispatch.c qmp: Improve QMP dispatch error messages 2017-05-09 09:14:40 +02:00
qmp-event.c qobject: Use simpler QDict/QList scalar insertion macros 2017-05-09 09:13:51 +02:00
qmp-registry.c qapi: Support multiple command registries per program 2017-03-05 09:12:25 +01:00
qobject-input-visitor.c qapi: update the qobject visitor to use QNUM_U64 2017-06-20 14:31:31 +02:00
qobject-output-visitor.c qapi: update the qobject visitor to use QNUM_U64 2017-06-20 14:31:31 +02:00
rocker.json qapi: The #optional tag is redundant, drop 2017-03-16 07:13:02 +01:00
string-input-visitor.c qapi: add explicit null to string input and output visitors 2017-06-30 14:03:31 +10:00
string-output-visitor.c qapi: add explicit null to string input and output visitors 2017-06-30 14:03:31 +10:00
trace-events qapi: Remove visit_start_alternate() parameter promote_int 2017-06-20 14:31:31 +02:00
trace.json qapi: The #optional tag is redundant, drop 2017-03-16 07:13:02 +01:00