Measured Boot Supplemental Pack
The Citrix Hypervisor Measured Boot Supplemental Pack enables customers to measure key components of their Citrix Hypervisor hosts at boot time. It also provides APIs that enable remote attestation solutions to collect these measurements securely. This supplemental pack is compatible with Intel computer systems that support Trusted Execution Technology (TXT).
This supplemental pack is available to download from the Citrix Hypervisor 8.2 Premium Edition page.
Measured Boot Supplemental Pack is available for Citrix Hypervisor Premium Edition customers, or those customers who have access to Citrix Hypervisor through their Citrix Virtual Apps and Desktops entitlement.
After installation of this Supplemental Pack, when a Citrix Hypervisor server next boots, Intel’s TXT takes measurements of low-level system components (such as firmware, BIOS, Xen hypervisor, dom0 kernel, and the dom0
initrd). These measurements are stored in a secure location on the host known as the Trusted Platform Module (TPM). A new interface is provided for clients, such as a remote attestation solution, to collect these measurements securely.
Remote Attestation solutions work by connecting to a Citrix Hypervisor server that is in a ‘known good’ clean state. It can remotely and securely query the Citrix Hypervisor server’s TPM for a list of low level key system measurements. It stores these measurements in a ‘white-list’ or ‘known good’ measurements list.
At this point, the remote attestation software periodically collects key system measurements and compares them to its ‘known good’ list.
A host is considered ‘untrusted’ in the following cases:
- If the remote attestation software is unable to collect the measurements
- If the measurements change
- If the cryptographic keys are not valid
In this event, the customer is notified. Higher-level orchestration software, such as CloudStack, OpenStack, or workload balancing software can perform intelligent security operations on the affected hosts.
Prepare the Citrix Hypervisor server
For this Supplemental Pack to function correctly, before attempting to gather data, edit the following settings in their host’s BIOS:
Set up the Citrix Hypervisor server to boot in legacy mode.
UEFI boot mode is not supported with measured boot.
Enable Intel AES-NI.
Switch on TPM Security or On with pre-boot measurements.
Clear the TPM.
This action erases any previous settings and passwords associated with the TPM to allow the Citrix Hypervisor Measured Boot Supplemental Pack to take control of the TPM.
A reboot is required after this step.
Enable Intel TXT.
- A reboot is required after step 5 and step 6.
- BIOS settings vary according to the hardware manufacturer. Consult your hardware documentation to see how to enable the TPM and TXT for their specific environment.
Install the Supplemental Pack
Use the Citrix Hypervisor CLI to install this Supplemental Pack. As with any software update, we advise that you back up your data before applying this supplemental pack.
Supplemental Packs can be transmitted within a zip file. If the Supplemental Pack ISO is contained within a zip file, unzip this zip file (to produce the disk ISO image), before carrying out the steps below.
Install onto a running Citrix Hypervisor system
Download the Supplemental Pack directly to the Citrix Hypervisor host to be updated.
We recommend storing it in the
Alternatively, you can download the file to an internet-connected computer, and burn the ISO image to a CD.
Use XenCenter to access the Citrix Hypervisor host’s console, or use secure shell (SSH) to log on directly.
The simplest method is to install directly from the ISO file. Enter the following:
xe-install-supplemental-pack /tmp/Citrix Hypervisor-8.2-measured-boot.iso <!--NeedCopy-->
Alternatively, if you chose to burn the ISO to a CD, you must mount the disk. For example, for a CD-ROM, enter the following:
mkdir -p /mnt/tmp mount /dev/<path to cd-rom> /mnt/tmp cd /mnt/tmp/ ./install.sh cd / umount /mnt/tmp <!--NeedCopy-->
For the changes to take effect, reboot your host.
If you are installing this Supplemental Pack on top of a previous version, confirm overwriting the previous installation. Enter
Y when prompted during
Update default password
In previous versions of the supplemental pack, the default password was set to
xenroot with a trailing newline. This trailing newline has been removed for the default password in this version of the supplemental pack with the new default password being
A custom password can be set in
/opt/xensource/tpm/config and must be a sha1 hash of a plain text password, which can be generated with
echo -n <password | sha1sum. If
-n is omitted from this command line, a trailing newline is included in the password.
Set asset tags
Asset tags can be set by using the
/opt/xensource/tpm/xentpm binary with the
--tpm_clear_asset_tag methods, or by using the management API
tpm plug-in with the
tpm_set_asset_tag (taking a ‘tag’ argument) and
/opt/xensource/tpm/xentpm --tpm_set_asset_tag <tag_sha1> /opt/xensource/tpm/xentpm --tpm_clear_asset_tag xe host-call-plugin uuid=<host_uuid> plugin=tpm fn=tpm_set_asset_tag args:tag=<tag_sha1> xe host-call-plugin uuid=<host_uuid> plugin=tpm fn=tpm_clear_asset_tag <!--NeedCopy-->
A reboot is required after this step.
To download the Measured Boot Supplemental Pack, see the Citrix Hypervisor 8.2 Premium Edition page.
If you experience any difficulties with installing this Supplemental Pack, contact Citrix Technical Support.
For Citrix Hypervisor 8.2 documentation, visit the Citrix Product Documentation website.