| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="vmencryption-encryption">
|
|---|
| 4 | <title>Encrypting a VM</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | Encrypting a VM can be done either using <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> or the
|
|---|
| 9 | <userinput>VBoxManage</userinput>. To encrypt an unencrypted VM with
|
|---|
| 10 | <userinput>VBoxManage</userinput>, use:
|
|---|
| 11 | </p>
|
|---|
| 12 | <pre xml:space="preserve">VBoxManage encryptvm <varname>uuid</varname>|<varname>vmname</varname> setencryption --new-password <varname>filename</varname>|- \
|
|---|
| 13 | --cipher <varname>cipher-ID</varname> --new-password-id <varname>ID</varname>
|
|---|
| 14 | </pre>
|
|---|
| 15 | <p>
|
|---|
| 16 | To supply the encryption password, point
|
|---|
| 17 | <userinput>VBoxManage</userinput> to the file where the password is
|
|---|
| 18 | stored or specify <codeph>-</codeph> to let
|
|---|
| 19 | <userinput>VBoxManage</userinput> prompt for the password on the
|
|---|
| 20 | command line.
|
|---|
| 21 | </p>
|
|---|
| 22 | <p>
|
|---|
| 23 | The cipher parameter specifies the cipher to use for encryption
|
|---|
| 24 | and can be either <codeph>AES-128</codeph> or
|
|---|
| 25 | <codeph>AES-256</codeph>. The appropriate mode of operation,
|
|---|
| 26 | such as GCM, CTR, or XTS will be selected by the VM depending on
|
|---|
| 27 | the encrypting component. The specified password identifier can
|
|---|
| 28 | be freely chosen by the user and is used for correct
|
|---|
| 29 | identification when supplying multiple passwords for the VM.
|
|---|
| 30 | </p>
|
|---|
| 31 | </body>
|
|---|
| 32 |
|
|---|
| 33 | </topic>
|
|---|
