- 1 Introduction
- 2 Trusting Downloaded Images
- 3 OpenPGP
- 4 Verifiable Builds
- 5 Whonix Updates
- 6 Appendix
- 7 Footnotes / References
- 8 License
Trust is a very problematic issue. This is the essence of why security is difficult in every field, including general computing and Internet communication. A skeptical user might ask themselves the following questions before relying upon Whonix for sensitive activities on a daily basis:
- Can Whonix and its developers be trusted?
- Are backdoors present in Whonix that can take control over a computer or exfiltrate data?
- Does Whonix generate compromised encryption keys to enable government spying?
- How trustworthy and sincere are the stated anonymity goals of the Whonix project?
Opinions will vary widely, but the reasoning process used to reach the conclusion should be closely examined. It is important that both trust and distrust are based on facts, and not gut feelings, instincts, paranoid conceptions, unfounded hearsay or the words of others.
It is unsurprising that the Whonix project and other anonymity platforms / tools claim to be honest, but written assurances are worthless. For an informed decision, it is worth looking at the bigger Whonix picture: core components, affiliations, project track record, and how reasonable trust might be established.
Free Software and Public Scrutiny
Whonix and other free software makes it possible to check the source code to determine how a software distribution functions and what it consists of. Suitably skilled individuals can thoroughly audit the code to search for the presence of any malicious code, like a backdoor. In addition, software can be manually built from source code and the result compared against any versions that are pre-built and already being distributed, like the Whonix ova images that can be downloaded from . This comparison can determine whether any malicious changes were made, or if the distributed version was actually built with the source code.
Naturally most people do not have the requisite knowledge, skills or time to properly audit software. However, the public scrutiny of popular, open source software implies a certain degree of trustworthiness. The axiom attributed to Linus Torvalds  -- "Given enough eyeballs, all bugs are shallow" -- is a reasonable assumption in user communities that are large, vibrant, and focused on fixing security vulnerabilities quickly.  The free software community has a strong tradition of publicly reporting and resolving serious issues, and a large pool of developers and beta testers can help to identify and remedy problems. 
Trusting Debian GNU/Linux
Nearly all the software shipped in Whonix comes from the Debian GNU/Linux distribution. Debian's packages are heavily scrutinized as it is one of the largest Linux distributions at present. Debian is also one of the most popular distributions for derivative platforms; Ubuntu Linux is a Debian derivative, and the same applies to all Ubuntu derivatives such as Linux Mint.
The sheer number using Debian's software packages and the large developer pool inspecting software integrity are significant factors in Debian's favor. Debian regularly identifies and patches serious security issues like the infamous SSH PRNG vulnerability , but backdoors or other purposeful security holes have never been discovered to date. Debian's focus on security is further evidenced by their Security Audit team which constantly searches for new or unfixed security issues. 
Whonix anonymity is based on Tor, which is developed by The Tor Project. Tor is a mature anonymity network with a substantial user base, and it has developed a solid reputation after more than 15 years of development. Tor's distributed trust model makes it difficult for any single entity to capture a user's traffic and identify them on a consistent basis.
Tor and its general development are subject to heavy public scrutiny by academics, security professionals and a host of developers.  For example, there is a body of Tor research related to potential attack vectors on onion routing and the adequacy of current defenses, and the source code has undergone several external audits. Like any software project, numerous security issues have been identified and resolved over the years, but a purposeful backdoor has never been discovered.  Theories about deliberate backdoors in Tor are considered highly speculative and lacking any credible basis.
In one sense, Whonix is the simple union of Debian and Tor and a mechanism to glue them together. If a user already trusts Debian and The Tor Project, then a method for assessing Whonix trustworthiness is also necessary.
The Whonix project was founded on 11 January, 2012. It previously existed under different project names, including TorBOX and aos. As mentioned earlier, Whonix is free software which makes the source code available for inspection. In the main, Whonix is comprised of specifications for which Debian software packages should be installed and their appropriate configuration. Unfortunately, Whonix does not receive the kind of attention that is dedicated to Debian or Tor, and a formal, external audit has not yet taken place.
With a relatively small development team and estimated user base, the "many eyeballs" theory may work against Whonix at present. However, the source code is comparably small and devoid of complexities, meaning the project is in relatively good shape compared to many other similar projects. Interested readers can learn more about the Whonix specification and design here. 
With these factors in mind, the reader can now make an informed decision about the trustworthiness of Whonix.
Trusting Downloaded Images
Users should not blindly trust the Whonix project or its developers. Logically it is unwise to trust unknown persons, especially on the Internet. On that basis, trust in Whonix founder Patrick Schleizer should not rely on his public persona or the appearance of the Whonix project alone. Whonix may be or could become a high profile target, and it is risky to assume that Schleizer's build machine would remain clean under those circumstances.
Binary images can be trusted to some extent if a user verifies that they received exactly the same code as thousands of other users, and no one has found or publicly reported any serious security issues. This requires verification of the Whonix-Workstation and Whonix-Gateway images using the available OpenPGP signatures.  All binary releases and source code tags for releases are OpenPGP-signed by lead Whonix developer Patrick Schleizer.
In order of increasing security, the Whonix images can be:
- Downloaded via . TLS provides some trust and integrity of the hash file, but it is still advisable to check the site's certificate and perform manual OpenPGP verification.
- Downloaded over the Whonix v3 onion address with Tor Browser before OpenPGP verification. Onion addresses provide a higher standard of authentication than clearnet addresses.
- Built from source since it is a relatively easy procedure. 
Most users retrieve OpenPGP fingerprints directly from a website and then download an associated key from a key server. The problem with this method is that TLS is fallible and the connection could be insecure or broken. Greater security necessitates a key signing party, whereby a direct and trusted path of communication can be confirmed by all attendees. If this step is not followed, OpenPGP is only secure as TLS.
It is often impossible to meet this condition of meeting in person. To mitigate the risk, any OpenPGP fingerprint should be cross-referenced on multiple "secure" (
https://) sites. An additional fail-safe is to use an alternative authentication system, for example comparing the Tor signing keys on both the clearnet and onion domains: https://www.torproject.org/docs/signing-keys.html and http://expyuzz4wqqyqhjn.onion/docs/signing-keys.html
Onion services offer strong authentication via multiple layers of encryption. This does not prohibit an advanced adversary from trying to impersonate an onion service, but together with multiple fingerprint sources, it becomes increasingly difficult and improbable that a single entity could impersonate them all.
Whonix Binaries and Git Tags
All Whonix binaries are OpenPGP-signed by Whonix developer Patrick Schleizer.  The source code is directly available on github over TLS, and it can be cloned using git over
https://. Git tags for each release are also OpenPGP-signed by Whonix developer Patrick Schleizer. Users can also request signed git development tags from the same developer.
Even if Whonix developers are distrusted, verifying binary downloads or git tags with OpenPGP is still useful. For example in order to audit Whonix, it is important to verify the download came from Whonix developers and that it was not tampered with by third parties. This is a realistic threat, as these recent examples show:
- An attacker could modify source codes on github (w)
- sourceforge hacked (w)
- sourceforge mirror hacked (w)
The OpenPGP key also ensures that if the Whonix infrastructure is ever compromised by a powerful adversary (such as a domain takeover), the original Whonix developers can at least prove they owned the infrastructure.
Whonix Developer OpenPGP Guidelines
All long-term Whonix developers are encouraged to:
- Create a 4096/4096 RSA/RSA OpenPGP key.
- Retrieve the latest which comes with Whonix-Workstation for stronger hashes, no-emit-version, and other improved settings.
- Store the private key inside an encrypted file.
- Make a backup of that encrypted file.
- Remember the password and regularly test one's memory of it.
- Upload the encrypted file to a (free) online cloud-based host to protect against theft, fire, natural events and so on.
From the beginning of the Whonix project, greater trust has been placed in developers who publish their OpenPGP public key earlier on, since this reduces the probability of an evil developer attack.
Verifiable .ova Releases
|Warning: Deprecated. A dedicated maintainer is required.|
Whonix previously had a feature which allows the community to check that Whonix .ova  releases are verifiably created from the project's own source code - verifiable builds.  This only proves that the person and machine  building Whonix have not added anything malicious, such as a backdoor.  It does not prove there are no backdoors present in Debian. This is not possible, because neither Debian  nor any other operating system provides deterministic builds yet. 
This feature does not attempt to prove there are not any vulnerabilities present  in Whonix or Debian. Fatal outcomes are still possible via a remotely exploitable  bug in Whonix or Debian, a flaw in Whonix's firewall which leaks traffic, or code phoning home  the contents of the HDD/SSD. Community effort is a precondition to improved security with this feature, particularly auditing of Whonix and Debian source code to check for possible backdoors and vulnerabilities.
In summary, this feature is useful and potentially improves security, but it is not a magical solution for all computer security and trust issues. The following table helps to explain what this feature can achieve.
Table: Verifiable Builds Comparison
|Whonix||Tails||Tor Browser||Qubes OS TorVM||corridor|
|Deterministic builds ||No||No (planned) ||Yes ||No||Not applicable |
|Based on a deterministically built  operating system||No ||No ||Not applicable||No ||No |
|Verifiably no backdoor in the project's own source code||Invalid ||Invalid ||Invalid ||Invalid ||Invalid |
|Verifiably vulnerability-free||No ||No ||No ||No ||No |
|Verifiably no hidden source code  in upstream distribution / binaries ||No ||No ||No ||No ||No |
|Project's binary builds are verifiably created from project's own source code (no hidden source code  in the project's own source code)||No (deprecated) ||No||Yes||No||Not applicable |
Some readers might be curious why Whonix was previously verifiable, while Debian and other distributions are not. In short, this is because Whonix is uncomplicated by comparison. In simple terms, Whonix is a collection of configuration files and scripts, and the source code does not contain any compiled code and so on. In contrast, Debian is a full operating system, without which Whonix would not exist. 
This feature was first made available in Whonix 8. Only users who download a new image can profit from this feature.  It is not possible to audit versions older than Whonix 8 with this script. 
This is only an an introduction to this topic; see Verifiable Builds for full details.
Verifiable Whonix Debian Packages
|Warning: Deprecated. A dedicated maintainer is required.|
This has been deprecated because it is difficult to implement before Debian Stretch and/or the experimental Debian reproducible toolchain being merged into Debian stable.  For full details on this topic, see Verifiable Whonix Debian Packages.
An optional updater has been available in Whonix since version 6 of the platform.  When it comes to trust, there is a large difference between building Whonix from source code and using the Default-Download-Version.
APT Repository and Binary Builds Trust
When Whonix is built with the build script and the source code is verified to be non-malicious and reasonably bug-free, Whonix developers are unable to access the system. On the other hand, if Whonix's APT repository is enabled, developers holding a Whonix repository signing key could release a malicious update to gain full access to the machine(s). 
Even if the Whonix APT repository is not used with the Default-Download version, it is still theoretically possible for Whonix developers to sneak a backdoor into the binary builds which are available for download.  Although an unpleasant threat, using Whonix's APT repository poses a greater risk: a malicious Whonix developer might sneak in a backdoor at any time.
It is easier to sneak backdoors into binary builds, since they contain compiled code in binary packages which are downloaded from the Debian repository when built. The actual Whonix deb packages do not yet have any compiled code, and consist of only configuration files, scripts, and comments.  The lack of compiled code inside Whonix deb packages at present might make it easier for auditors searching for a backdoor in updated deb packages,  compared to the binary builds.
APT Repository Default Settings
- Building from source code: Whonix's APT Repository is disabled by default. 
- Default binary download: Whonix's APT Repository is enabled by default.
- Qubes/Install: Whonix's APT Repository is enabled by default.
- Building from source code: Whonix's APT Repository is enabled by default. 
Most users will have the Whonix APT repository enabled. This means when updated Whonix debian packages are uploaded to the Whonix APT repository, these packages will be automatically installed when the system is upgraded.  If this behavior is unwanted, this can be disabled. Refer to the previous section outlining security implications before proceeding.
- *: poor security.
- ****: best security.
Table: Build and APT Repository Security Comparison
|Binary Download with Whonix APT Repository||Binary Download without Whonix APT Repository||Built from Source Code and Whonix APT Repository Enabled||Built from Source Code and Whonix APT Repository Disabled|
- The Whonix binary download using the Whonix APT repository is the most convenient method, but also the least secure.
- It is somewhat safer to use the Whonix binary download and then disable the Whonix APT repository. However, the user must then manually download updated Whonix deb packages upon release, and independently verify and install them.
- The greatest security comes from building Whonix and updated packages from source code, particularly if the source code is verified before building Whonix.
What Digital Signatures Prove
See Verifying Software Signatures for details on what digital signatures prove. In short, a user must be careful to ensure the public keys that are used for signature verification are the bona fide Whonix key pair belonging to Patrick Schleizer.
Evil Developer Attack
An "evil developer attack" is a narrow example of an insider threat: 
Software development teams face a critical threat to the security of their systems: insiders.
An insider threat is a current or former employee, business partner, or contractor who has access to an organization’s data, network, source code, or other sensitive information who may intentionally misuse this information and negatively affect the availability, integrity, or confidentiality of the organization’s information system.
In the case of software, a disguised attack is conducted on the integrity of the software platform. While this threat is only theoretical, it would be naive to assume that no major software project has ever had a malicious insider. Whonix and all other open source software projects face this problem, particularly those that are focused on anonymity such as VeraCrypt,  Tails, I2P, The Tor Project and so on.
A blueprint for a successful insider attack is as follows:
- Either start a new software project or join an existing software project.
- Gain trust by working hard, behaving well, and publishing your sources.
- Build binaries directly from your sources and offer them for download.
- Attract a lot of users by making a great product.
- Continue to develop the product.
- Make a second branch of your sources and add malware.
- Continue to publish your clean sources, but offer your malicious binaries for download.
- If undetected, a lot of users are now infected with malware.
An evil developer attack is very difficult for end users to notice. If the backdoor is rarely used, then it may remain a secret for a long time. If it was used for something obvious, such as adding all the users to a botnet, then it would be quickly discovered and reported on.
Open source software has some advantages over proprietary code, but certainly not for this threat model. For instance, no one is checking if the binaries are made from the proclaimed source and publishing the results, a procedure called "deterministic builds".  This standard is quite difficult to achieve, but is being worked towards. 
The insider threat nicely captures how difficult it is to trust developers, even if they are not anonymous. Further, even if they are known and have earned significant trust as a legitimate developer, this does not discount the possibility of serious mistakes that may jeopardize the user. The motives and internal security of everyone contributing to major software projects like Tor, distribution developers and maintainers, and the hundreds of upstream developers and contributors is a legitimate concern. 
The trusted computing base of a modern operating system is enormous. There are so many people involved in software and complex hardware development, that it would be unsurprising if none of the bugs in existence were intentional. While detecting software changes in aggregate may be easy (by diffing the hash sums), finding and proving that a change is a purposeful backdoor rather than a bug in well designed source code is near impossible.
Other Projects Discussing Trust
- Tails is a live CD or USB that aims to preserve privacy and anonymity - Tails about trust. (w)
- I2P (anonymizing network) has also discussed development attacks. (w)
- Qubes OS: What do the Digital Signatures Prove and What They DO NOT Prove (w)
- Miron’s Weblog: Attack Scenarios on Software Distributions (w)
- A list of incidents concerning compromised servers: On distributing binaries (w)
Footnotes / References
- Creator of the Linux kernel.
- On the flip-side, there is no guarantee that just because software is open to review, that sane reviews will actually be performed. Further, people developing and reviewing software must know the principles of secure coding.
- https://lists.debian.org/debian-security-announce/2008/msg00152.html (w)
- Debian also participates in security standardization efforts and related overarching projects.
- And undoubtedly advanced adversaries.
- That said, a skilled, malicious coder is far more likely to introduce subtle errors that open non-obvious attack vectors.
- This is a good starting point to understand how Whonix works.
- This feature has been available since Whonix 0.4.5
- Verifiable Builds allow auditors to check if there is hidden code inside Whonix.
- Whonix developer (w), named proper in the past (w), renamed himself to adrelanos (w), published his OpenPGP key on 05/29/12 (w) (wiki history (w)). Revealed his identity on 01/18/14. (w) Patrick Schleizer posted his OpenPGP key transition message on 01/18/14, signed by both his old and new key. (w)
- This feature only adds security if people actually use it. Do not assume that someone else will do it for you
- Due to build machine compromise.
- Whonix is based on Debian.
- Some Debian developers are steadily working on this long-term project, see: Reproducible Builds.
- Open Source software does not automatically prevent backdoors, unless the user creates their own binaries directly from the source code. People who compile, upload and distribute binaries (including the webhost) could add hidden code, without publishing the backdoor. Anybody can claim that a certain binary was built cleanly from source code, when it was in fact built using the source code with a hidden component. Those deciding to infect the build machine with a backdoor are in a privileged position; the distributor is unlikely to become aware of the subterfuge. Deterministic builds can help to detect backdoors, since it can reproduce identical binary packages (byte-for-byte) from a given source. For more information on deterministic builds and why this is important, see:
- See Tails Roadmap.
- See Deterministic Builds Part One: Cyberwar and Global Compromise and Deterministic Builds Part Two: Technical Details.
- corridor only uses shell scripts.
- To be fair, there are no deterministically built operating systems yet. It is a difficult process and takes a lot of effort to complete. While Debian has around 22,000 reproducible packages in mid-2018, this work has been ongoing since 2013 and is far from done.
The first form of backdoor is a vulnerability (bug) in the source code. Vulnerabilities are introduced either purposefully or accidentally due to human error. Following software deployment, an attacker may discover the vulnerability and use an exploit to gain unauthorized access. Such vulnerabilities can be cleverly planted in plain sight in open source code, while being very difficult to spot by code auditors. Examples of this type of backdoor include:
- An attempt to backdoor the kernel.
- The Debian SSL debacle; many argued that this wasn't a bug but in fact a backdoor, as it hadn't been spotted for several years.
It is therefore impossible to claim that non-trivial source code is backdoor-free, because backdoors can be hidden as vulnerabilities. Auditors scrutinizing the source code can only state an opinion about the quality of the source code, and eventually report vulnerabilities if/when they are identified. Assertions that source code is free of computer viruses (like trojan horses) is the only reasonable assertion that can be made.
- Although theoretically possible, there are no mathematically proven bug-free operating systems yet.
- The upstream distribution is the distribution on which the project is based. Whonix and Tails are based on Debian, thus Debian is their upstream distribution. QubesOS TorVM is based on Qubes OS, which is itself based on Fedora and Xen.
- See verifiable builds.
- Whonix relies on the tireless efforts of Debian and other upstream projects.
- Because in order to implement the verifiable builds feature, a lot of non-deterministic, auto-generated files are removed at the end of the build process and re-created during first boot.
- It is not actually impossible, but it would require significant effort.
- Old advice: Since Whonix 7.5.2, all Whonix Debian Packages have been deterministically built. This means if the Whonix Debian Packages 7.5.2 are built from source code, and 7.5.2 downloaded from the Whonix Debian repository, it is possible to diff the checksum (for example the sha512sum) of those files and they should match. This has been deprecated because of a dpkg bug. The estimate of the Installed-Size can be wrong by a factor of 8, or a difference of 100MB (note: this bug has now been resolved). Different underlying file systems cause different file sizes, leading to checksums not matching.
- When Whonix's APT repository is disabled, there is no updater - as was the case in Whonix 0.5.6 and below.
- At the moment, Whonix developer Patrick Schleizer is the only one holding the Whonix APT repository OpenPGP signing key.
- See the Verifiable Builds section for further details.
- Although these could change with a malicious update.
- Unless it is a targeted attack.
- Since Whonix version 7.3.3
- To disable this setting, see: qubes-template-whonix:
builder.conf, and set
WHONIX_APT_REPOSITORY_OPTS = off
- After running
sudo apt-get update && sudo apt-get dist-upgrademanually or via a GUI updater.
- Whonix developers place little trust in the CA model. Even if the numerous implementation problems were solved, such as problematic revocation and the ability for every CA to issue certificates for anything (including "*"), third party trust cannot be established. Until an alternative arrives and is widely adopted, everybody has to rely upon SSL/TLS to some extent.
- TrueCrypt has been discontinued.
- Interested readers can investigate its complexity by searching with the phrase "trusting trust".
- In the case of Whonix, binaries are not distributed nor created. Only unmodified upstream binaries are distributed, along with shell scripts. This claim is much easier to verify than if Whonix were distributing binaries from project source code.
Whonix Trust wiki page Copyright (C) Amnesia <amnesia at boum dot org>
Whonix Trust wiki page Copyright (C) 2012 - 2018 ENCRYPTED SUPPORT LP <firstname.lastname@example.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.
Thanks to Qubes OS (Permission) (w). The "What do the Digital Signatures Prove and What They DO NOT Prove" chapter contains content from the Qubes OS: What do the Digital Signatures Prove and What They DO NOT Prove page.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.