Force an immediate BSOD + system reset/shutdown after "Clear encryption keys from memory if a new device is inserted" is triggered

Open
#1,993 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
42/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
c

Research direction

The issue identifies the DBT_DEVICEARRIVAL path and VC_IOCTL_EMERGENCY_CLEAR_ALL_KEYS; start by locating that handler and the key-clearing call. Review how the driver handles emergency key clearing and system crash or reset behavior. Done means the requested immediate crash followed by reset or shutdown occurs after keys are wiped, including when Windows automatic reboot is disabled.

Written by the indexing model from the issue text.

Description

Currently

The documentation (doc/html/en/VeraCrypt RAM Encryption.html) states:

If a new device is inserted, master keys are immediately purged from memory, resulting in a Windows BSOD.

However, when DBT_DEVICEARRIVAL triggers VC_IOCTL_EMERGENCY_CLEAR_ALL_KEYS, VeraCrypt only wipes the encryption keys from RAM and calls WipeCache(). It does not actively force a BSOD or system reset, passively relying on Windows to eventually crash with BSOD when a critical kernel disk I/O request fails.

During practical testing on Windows 10 (32GB RAM), inserting a new USB drive while on the Win+L lock screen successfully triggered key clearing (files on the system drive could no longer be opened), but in ~1/15 tests Windows somehow did not BSOD. Because the OS session, file explorer, thumbnails, folder names, and USB drivers were already cached in RAM, Windows allowed unlocking the screen and remained interactive in memory, even mounting the newly inserted USB drive.

Additionally

Even when a BSOD does occur (which is what happened to me most often), if AutoReboot is disabled in Windows registry settings HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CrashControl, the system stays powered on at the blue screen indefinitely with RAM still powered (which can already contain some sensitive data).

Desired behavior

Instead of passively waiting for Windows to fault (BSOD) on disk I/O after VC_IOCTL_EMERGENCY_CLEAR_ALL_KEYS, VeraCrypt should actively force an immediate system crash (BSOD) + instant system reset/shutdown as soon as the encryption keys are wiped.

Dominant language
C
Stars
11.7k
Forks
1.4k
Avg merge
1d 1h
Merged PRs (30d)
28

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from veracrypt/VeraCrypt

All issues in veracrypt/VeraCrypt

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.