Actions

Verify Virtual Machine Images on the Command Line

From Whonix

< KVM



notice Digital signatures can increase security but this requires knowledge. Learn more about digital software signature verification.

In order to verify the Whonix image, GnuPG must be installed. GnuPG is the common OpenPGP implementation for Linux: it is installed by default in Debian, Ubuntu, Whonix and many other distributions.

1. Import the signing key.

Refer the the more secure, detailed Whonix ™ KVM Signing Key instructions.

hulahoop.asc

2. Download the cryptographic (OpenPGP) signature corresponding to the virtual machine image you want to verify.

3. Save the signature in the same folder as the virtual machine image.

4. Start the cryptographic verification.

This process can take several minutes.

cd [the directory in which you downloaded the .ova and the .asc]

gpg --verify-options show-notations --verify Whonix*.libvirt.xz.asc Whonix*.libvirt.xz

5. Check the output of the verification step.

If the virtual machine image is correct, the output will inform that the signature is good:

gpg: Good signature from "HulaHoop"

This output might be followed by a warning as follows.

gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.

This message does not alter the validity of the signature related to the downloaded key. Rather, this warning refers to the level of trust placed in the Whonix signing key and the web of trust. To remove this warning, the Whonix signing key must be personally signed with your own key.

warning Check the GPG signature timestamp makes sense. For example, if you previously saw a signature from 2020 and now see a signature from 2019, then this might be a targeted rollback (downgrade) or indefinite freeze attack. [1]

The first line includes the signature creation timestamp; see the example below.

gpg: Signature made Mon 19 Jan 2015 11:45:41 PM CET using RSA key ID 77BB3C48

warning Note: OpenPGP signatures sign files, but not file names. [2]

The file@name OpenPGP notation in Whonix ™ release signatures describes the file name. This helps to confirm that the file name has not been tampered with; see the example below.

gpg: Signature notation: file@name=Whonix-15.0.1.5.1.libvirt.xz

If the Virtual Machine image is not correct, the output will inform that the signature is bad:

gpg: BAD signature from "HulaHoop"

Ambox warning pn.svg.png Do not continue if verification fails! This risks using infected or erroneous files! The whole point of verification is to confirm file integrity. This page is strongly related to the pages Placing Trust in Whonix ™ and Verifying Software Signatures.

Troubleshooting[edit]

When a GPG error is encountered, first try a web search for the relevant error. The security stackexchange website [archive] can also help to resolve GPG problems. Describe the problem thoroughly, but be sure it is GPG-related and not specific to Whonix ™.

More help resources are available on the Support page.

Footnotes[edit]

License[edit]

Whonix ™ KVM/Verify the virtual machine images using the command line wiki page Copyright (C) Amnesia <amnesia at boum dot org>
Whonix ™ KVM/Verify the virtual machine images using the command line wiki page Copyright (C) 2012 - 2020 ENCRYPTED SUPPORT LP <adrelanos@whonix.org>

This program comes with ABSOLUTELY NO WARRANTY; for details see the wiki source code.
This is free software, and you are welcome to redistribute it under certain conditions; see the wiki source code for details.



text=Jobs in USA
Jobs in USA


Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki


Follow: Twitter.png Facebook.png Rss.png Matrix logo.svg.png 1024px-Telegram 2019 Logo.svg.png Discourse logo.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contriute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Share: Twitter | Facebook

https link onion link

This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! Read, understand and agree to Conditions for Contributions to Whonix ™, then Edit! Edits are held for moderation. Policy of Whonix Website and Whonix Chat and Policy On Nonfreedom Software applies.

Copyright (C) 2012 - 2020 ENCRYPTED SUPPORT LP. Whonix ™ is a trademark. Whonix ™ is a licensee [archive] of the Open Invention Network [archive]. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Freedom Software license as Whonix ™ itself. (Why?)

Whonix ™ is a derivative of and not affiliated with Debian [archive]. Debian is a registered trademark [archive] owned by Software in the Public Interest, Inc [archive].

Whonix ™ is produced independently from the Tor® [archive] anonymity software and carries no guarantee from The Tor Project [archive] about quality, suitability or anything else.

By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent. Whonix ™ is provided by ENCRYPTED SUPPORT LP. See Imprint, Contact.