Skip to content
Automatically generate AV byte signatures from sets of similar binaries.
C++ Python C
Branch: master
Clone or download

Latest commit

cblichmann Build in C++17 mode
This is harder than necessary in Bazel. It requires either a custom
`CROSSTOOL`, or a per-workspace `.bazelrc`. This change implements the
latter approach specifying the `--cxxopt` and `--host_cxxopt` options.
To make this platform-agnostic, `--enable_platform_specific_config`
needs to be used, available since Bazel 5975545 (Aug 27, 2019).
Note that when embedding VxSig in your own projects, this setting will
"poison" all other C++ build targets.

Signed-off-by: Christian Blichmann <mail@blichmann.eu>
Latest commit 8d4d367 Jan 18, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
vxsig Build in C++17 mode Jan 18, 2020
.bazelrc
.clang-format
.gitignore
CONTRIBUTING.md
LICENSE
README.md Update license header with recommended best practices Jan 17, 2020
WORKSPACE Update to BinExport 11 master Jan 18, 2020

README.md

VxSig

Copyright 2011-2020 Google LLC

Disclaimer: This is not an official Google product (experimental or otherwise), it is just code that happens to be owned by Google.

Introduction

VxSig is a tool and library to automatically generate AV byte signatures from sets of similar binaries. It processes files generated by BinExport and BinDiff.

Signatures can be generated for Yara(the default) and ClamAV.

Status

VxSig is a mature tool that has been used at Google to create signature and scan for many kinds of malware and targetted threats.

Quick Start

VxSig uses Bazel to build, so install that first. On Debian 10 "Buster":

echo "deb http://storage.googleapis.com/bazel-apt stable jdk1.8" | \
  sudo tee /etc/apt/sources.list.d/bazel.list
wget -qO - https://bazel.build/bazel-release.pub.gpg | sudo apt-key add -
sudo apt-get update
sudo apt-get install -qy bazel

Clone and run the build:

git clone https://github.com/google/vxsig && cd vxsig
bazel build -c opt //vxsig:vxsig

To build an example Yara signature:

bazel-bin/vxsig/vxsig --detection_name=VxSigTestSig --trim_length=400 \
  vxsig/testdata/592fvs2065.BinDiff

The output should look like this (truncated):

----8<--------8<---- Signature ----8<--------8<----                    
rule VxSigTestSig {
  meta:
    vxsig_build = "redacted"
  strings:
    $ = {
         00008bd85985db5975
         // 00401049: mov ebx, eax
         // 0040104b: pop ecx
         // 0040104c: test ebx, ebx
         // 0040104e: pop ecx
         // 0040104f: jnz 0x4010b7
      [-]110000435653e8
         // 004010c0: inc ebx
         // 004010c1: push esi
         // 004010c2: push ebx
         // 004010c3: call 0x40226c
      [-]1100006a10be
         // 004010fe: push b1 0x10
         // 00401100: mov esi, 0x4042a8
      [-]6a0056e8
         // 00401105: push b1 0x0
         // 00401107: push esi
         // 0040110b: call 0x402266
...

Further reading / Similar tools

Getting Involved

If you want to contribute, please read CONTRIBUTING.md and send pull requests. You can also report bugs or file feature requests.

You can’t perform that action at this time.