Skip to content

Add MaldocTrace - #252

Open
debugactiveprocess wants to merge 1 commit into
teamdfir:masterfrom
debugactiveprocess:add-maldoctrace
Open

debugactiveprocess wants to merge 1 commit into
teamdfir:masterfrom
debugactiveprocess:add-maldoctrace

Conversation

@debugactiveprocess

Copy link
Copy Markdown

Adds MaldocTrace (Apache-2.0), a static analyzer and safe VBA emulator for malicious Office documents. It complements the oletools already in SIFT: besides extracting VBA it emulates the macros against a simulated Windows environment (nothing is executed) and reports the deobfuscated commands, dropped files, embedded/linked OLE objects (e.g. URL monikers, Equation Editor exploits), encrypted Office files, archives and emails, with a verdict and IOCs as text or JSON.

The state (sift/scripts/maldoctrace.sls)

  • Follows AGENTS.md: one tool per file, sift-scripts- IDs, metadata header with Notes: maldoctrace, {% set (no leading dash) after the header.
  • Downloads the static release binary to /var/cache/sift/archives/, pinned to v0.4.0 with per-arch SHA256 (amd64 / arm64, via grains["osarch"], no hardcoded arch in the URL), extracts it under /opt/maldoctrace and symlinks /usr/local/bin/maldoctrace.
  • No renovate annotation, since the file has two arch-specific hashes (the case AGENTS.md says not to annotate).
  • Registered in both lists of sift/scripts/init.sls.

Testing

I don't have a container runtime here, so I did not run .ci/test-state.sh; I'm relying on the CI matrix for the real Salt run. What I did check:

  • rendered the Jinja for osarch amd64 and arm64 and parsed the YAML (URLs, hashes and symlink targets as expected);
  • both hashes match the release's checksums.txt, and the tarball layout matches the symlink target (maldocTrace_0.4.0_linux_<arch>/maldocTrace);
  • reproduced the state's steps on Linux amd64 (download, sha256sum -c, extract, symlink): maldoctrace version prints MaldocTrace 0.4.0.

I'm the tool's author and will keep the pin updated.

Disclosure: this pull request was prepared with the help of an AI assistant (Claude Code) following the repository's AGENTS.md, and reviewed by me.

Installs the MaldocTrace release binary (amd64/arm64) under /opt/maldoctrace with a /usr/local/bin/maldoctrace symlink, pinned to v0.4.0 with per-arch SHA256.

Assisted-by: Claude Code (Claude Opus 5.5)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant