Repository navigation
Add MaldocTrace - #252
Open
debugactiveprocess wants to merge 1 commit into
Open
Add MaldocTrace#252debugactiveprocess wants to merge 1 commit into
debugactiveprocess wants to merge 1 commit into
Conversation
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)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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)AGENTS.md: one tool per file,sift-scripts-IDs, metadata header withNotes: maldoctrace,{% set(no leading dash) after the header./var/cache/sift/archives/, pinned to v0.4.0 with per-arch SHA256 (amd64 / arm64, viagrains["osarch"], no hardcoded arch in the URL), extracts it under/opt/maldoctraceand symlinks/usr/local/bin/maldoctrace.AGENTS.mdsays not to annotate).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:osarchamd64 and arm64 and parsed the YAML (URLs, hashes and symlink targets as expected);checksums.txt, and the tarball layout matches the symlink target (maldocTrace_0.4.0_linux_<arch>/maldocTrace);sha256sum -c, extract, symlink):maldoctrace versionprintsMaldocTrace 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.