Skip to content
InertPDF
A white page sealed in an amber cube, with four spikes that cannot reach it

How isolation works

A PDF can contain code, automatic actions, links and attachments. InertPDF keeps two things apart: what reads the document's bytes and what shows it to you. Here you will find what each part does and, platform by platform, what it does not do.

1. The working copy

When you open a file, the main program copies it into a folder created for that document and computes its SHA-256 fingerprint. It only checks that the file starts like a PDF: it does not interpret it. The original is not read or modified again, and you save the results of the tools wherever you choose.

When the document is closed the working folder is deleted; at the next launch any folders left behind by a forced shutdown are deleted too. Files larger than 512 MB are not opened.

2. The reading process

Everything that interprets the document's bytes runs in a separate program, the helper: structure, metadata, active code, hidden text, signatures, forms, annotations and the editing tools.

The helper receives only two file names, works inside the document's folder, starts without the user's environment variables and does not know the path of the original. Passwords to unlock or protect a file reach it through standard input and are never written to disk.

3. Resource limits

The helper is capped at 1.5 GB of memory and 30 seconds of CPU for each core it can use. The main program stops it after 45 seconds, or after 10 minutes for heavy tools such as merging, compressing and text recognition. A document crafted to hang the reader or exhaust its memory ends the helper, not the program.

4. No isolation, nothing opens

If the helper is missing, or if isolation cannot be applied, the document does not open and the program says so. There is no fallback that reads the file inside the main program.

5. The page viewer

Pages are drawn by the program itself, in its own window, without running anything from the document: actions and fields are not triggered, links to other pages of the document work, and links to the outside are shown and can be copied, but are never opened. The window cannot connect to the internet, so a remote image or font is never downloaded.

The view does not receive the file you opened, but the copy rewritten by the isolated process after the checks: it contains only what was examined, with a checkerboard box in place of any image that failed verification. A file crafted to be read one way by the checks and another way by the view therefore shows nothing that was not examined.

The test at launch

At every start the program places a decoy file outside the helper's folder and opens a local network port that listens. It then asks the helper to read the decoy, write a file next to it, connect to the port and start a program: directly, through the shell, system scripts and, on Windows, COM and WMI services.

The main program judges the result: for writing, what counts is whether the file really exists, not what the helper reports. Until the test passes, no document opens.

  • Read outside the folderdenied on macOS, Windows and Linux
  • Write outside the folderdenied on macOS, Windows and Linux
  • Open a connectiondenied on macOS, Windows and Linux
  • Launch another programdenied on macOS, Windows and Linux
InertPDF start screen with the tools and the status “Isolation verified”
At every start the program tries to break out of its own isolation: reading and writing outside its folder, opening a connection, starting a program. It opens documents only if every attempt is denied.

What each platform guarantees

The reading processmacOSWindowsLinux
Reads files outside the document folderDenied by the systemDenied by the systemDenied by the system
Writes outside the document folderDenied by the systemDenied by the systemDenied by the system
Opens network connectionsDenied by the systemDenied by the systemDenied by the system
Launches other programsDenied by the systemDenied by the systemDenied by the system
Memory and CPU limitsYesYesYes
Condition for opening documentsEvery escape failsEvery escape failsEvery escape fails

macOS: a sandbox that starts from “deny everything”

On macOS the helper starts inside a system sandbox profile that denies everything by default and allows only: running the helper itself, reading the system libraries needed to start it, and reading and writing the document's folder alone. No network, no other processes, no system services, no reading the rest of the disk. If the profile cannot be applied, the helper does not start.

Windows: an AppContainer with no capabilities

On Windows the helper starts inside an AppContainer, the container Windows uses to isolate apps, without any of the capabilities an app can request: no network, no access to your files. The program grants it only the document's folder, and takes it back when the operation ends. At creation it is also forbidden to start other processes, which the system enforces on every path (direct start, shell, COM and WMI services), and placed in a Job object with memory and CPU limits, termination together with the program and no access to the clipboard, desktop or system settings. If any of these protections cannot be applied, the helper does not start.

Like any contained app, the helper can read the Windows system folders that are open to all apps (for example Windows' own folder), not your documents nor program folders that do not allow it.

Linux: Landlock and seccomp

On Linux the helper, as soon as it starts and before reading the document, locks itself in with kernel tools and can never unlock again: the ban on gaining new privileges, Landlock, which leaves it only the document's folder, and a seccomp filter that denies it starting other programs, creating processes, network connections, debugging other processes and the kernel's asynchronous I/O queues. Memory and CPU limits are the same as on the other platforms. A kernel with Landlock enabled is required: if it is missing, or if a single escape in the test succeeds, no document opens.

The program's only connections

Reading a document does not use the network. The program connects to the internet to verify digital signatures: from the fixed addresses of the national bodies it downloads the public trust lists of Italy, France, Germany and Spain, at most once a week and never while opening a document; and it asks for a certificate's revocation status only if its chain leads, signature by signature, to an authority in those lists. An address written inside a document of unknown origin is never contacted.

Licensing, updates, support and telemetry use only api.inertpdf.com and carry no contents, names or paths of documents. Telemetry is on by default and can be turned off in Settings.

What isolation does not do

  • It does not make the document harmless: it reads it without letting it act. If you save it and open it with another program, what that program does applies.
  • It does not protect attachments you save: InertPDF never opens them and saves them with the system's “downloaded from the internet” mark, but you can open them with other programs.
  • It does not replace an antivirus or operating system updates.
  • A flaw in the engine that draws the pages remains possible: that is why the helper reads the file's bytes first and the viewer has the network blocked.

If the document must be passed on or opened with other programs, InertPDF prepares a safer version with two tools. Deep clean writes a new file from the document's content: it removes code and actions at every level, attachments and earlier versions, and replaces embedded fonts with standard fonts and JBIG2 and JPEG 2000 images, the formats most affected by vulnerabilities, with a placeholder, like every image that fails verification; from the other images it removes comments, metadata and trailing data. It scales down oversized images, keeping their proportions and position. Text, drawings and the pixels of other images stay as they were in the document, so the risk is greatly reduced but not eliminated. Rasterize instead turns every page into an image drawn by InertPDF: nothing of the original file remains, at the cost of selectable text (which OCR can rebuild).