← Back to software Static PDF inspection

PDF Security Engine

Static security analysis and preflight inspection for PDF documents.

Overview

PDF Security Engine is a command-line security analysis tool designed to help security analysts understand what is actually inside a PDF before deciding how to handle it.

Rather than attempting to label a document as malicious or benign, PDF Security Engine identifies and exposes security-relevant features, active content, embedded artifacts, execution triggers, and external references for analyst review.

Key capabilities

JavaScript analysis

  • Extracts JavaScript embedded within PDF documents.
  • Supports multiple JavaScript payloads in a single document.
  • Reports execution triggers and PDF event information.
  • Identifies script storage type and length.
  • Calculates SHA-256 hashes for individual scripts.
  • Flags eval() and atob() usage as analyst-review indicators.
  • Displays extracted JavaScript for direct inspection.

PDF action detection

  • Detects /OpenAction execution triggers.
  • Detects Additional Actions (/AA).
  • Detects /Launch actions.
  • Identifies active PDF features without assuming malicious intent.

External URI analysis

  • Extracts URI actions contained within the PDF.
  • Reports each URI occurrence as a separate finding.
  • Preserves raw URLs for direct investigation in tools such as sandboxes and reputation services.
  • Records source and PDF action information for each finding.

Embedded file analysis

  • Enumerates files embedded inside the PDF.
  • Reports filename, size, MIME/subtype, and SHA-256.
  • Identifies embedded PDFs, CSV files, executables, and other attachment types for further analyst investigation.

Forms and interactive content

  • Detects AcroForm content.
  • Detects XFA content.

Password-protected PDFs

  • Supports analysis of encrypted PDFs when the analyst supplies the document password.
  • Distinguishes between a password being required and an incorrect password.
  • Does not include passwords in analysis results.

File integrity and identification

  • Calculates the SHA-256 hash of the source PDF.
  • Calculates hashes of extracted JavaScript and embedded files to support investigation and IOC pivoting.

Human- and machine-readable output

  • Provides concise interactive command-line reporting for analysts.
  • Supports structured JSON output for integration with other applications and security workflows.
  • Uses documented exit codes for automation and application integration.

Designed for analysts

PDF Security Engine is intentionally deterministic. It reports observable characteristics of the document rather than producing opaque malware scores or attempting to replace human analysis.