Skip to content

Cryfind is a tool to help you find crypto signatures in binary.

License

Notifications You must be signed in to change notification settings

oalieno/cryfind

Repository files navigation

Cryfind is a tool to help you find crypto signatures in binary.

Usage

Usage: cryfind [-m METHODS] [-s STRING] [-c CONSTANT] [-x LENGTH] [-y] <filename>

-h --help           Show this screen
-m METHODS          Methods to be used, could be : constant,api,peimport,stackstrings or all [default: constant,api]
-s STRING           Specify custom string to search in ascii, conflict with -c option
-c CONSTANT         Specify custom constant to search in hex, conflict with -s option
-x LENGTH           Maximum xor key length to try [default: 4]
-y --summary        Only show summary
# default setting
cryfind sample.exe

# use all available methods
cryfind -m all sample.exe

# use only constant and peimport methods
cryfind -m constant,peimport sample.exe

# show only summary
cryfind -y sample.exe

# search for 'test' string and try xor key length from 1 to 8
cryfind -x 8 -s 'test' sample.exe

# search for 0xdeadbeef hex and try xor key length from 1 to 8
cryfind -x 8 -c '0xdeadbeef' sample.exe

You can also compile all constants to yara rules using crygen.

Usage: crygen [-e ENCODING]

-h --help           Show this screen
-e ENCODING         Encoding, could be : fullword,qword,dword or all [default: all]

Install

Python >= 3

python setup.py install

or

pip install git+https://github.com/oalieno/cryfind.git

Output Example

example

Encoding

abbreviation full name
big big endian
little little endian
bnb big endian -> negative -> big endian
bnl big endian -> negative -> little endian
lnb little endian -> negative -> big endian
lnl little endian -> negative -> little endian

Python API

pydoc crylib
Help on package crylib:

NAME
    crylib

PACKAGE CONTENTS
    base
    constants (package)
    findapi
    findconst
    peimport
    stackstrings

FUNCTIONS
    constants_to_rules(constants, sizes=['fullword'])
        Convert constants to yara rules
        
        Parameters
        ----------
        constant: Dict
            Constant you want to convert.
        sizes: List[str]
            Sizes of word, can be 'fullword', 'qword', or 'dword'. Defaults to ['fullword'].
        
        Returns
        -------
        str
        
        Examples
        --------
        >>> constants_to_rules([{'name': 'test', 'value': b'abcd'}])
        rule cry_1 {
            meta:
                id = 0
                name = "test"
                length = 4
            strings:
                $c_0_0_0 = { 61626364 }
                $c_0_0_1 = { 64636261 }
            condition:
                (any of ($c_0_0_*))
        }
    
    find_api(binary, apis)
        Find crypto api names in binary
        
        Parameters
        ----------
        binary: bytes
            Target binary to search for.
        apis: List[Dict]
            API names you want to find.
        
        Returns
        -------
        List[Dict]
        
        Examples
        --------
        >>> results = find_api(b'......A_SHAFinal.....', [{'name': 'advapi32.dll', 'functions': ['A_SHAFinal', 'A_SHAInit']}])
        >>> print(results[0])
        {'name': 'advapi32.dll', 'functions': [{'name': 'A_SHAFinal', 'addresses': [6]}]}
    
    find_const(binary, constants, summary=False, xor_size_max=1)
        Find constants in binary
        
        Parameters
        ----------
        binary: bytes
            Target binary to search for.
        constants: List[Dict]
            Constants you want to find.
        summary: boolean (optional)
            Only get the name of constants. Defaults to False.
        
        Returns
        -------
        List[Result]
        
        Examples
        --------
        >>> results = find_const(b'abcd', [{'name': 'test', 'value': b'abcd'}])
        >>> print(results[0])
        [+] test
            - fullword
                | [0] 61626364 (big): 0x0
    
    pe_import(binary)
        Find api names in PE import tables
        
        Parameters
        ----------
        binary: bytes
            Target binary to search for.
        
        Returns
        -------
        List[Dict]
        
        Examples
        --------
        >>> results = pe_import(open('./test', 'wb').read())
        >>> print(results[0])
        {'dll': 'advapi32.dll', 'function': 'CryptAcquireContextA'}
    
    stackstrings(binary)
        Dump the stack from emulation
        
        Parameters
        ----------
        binary: bytes
            Target binary.
        
        Returns
        -------
        bytes

DATA
    __all__ = ['find_const', 'find_api', 'stackstrings', 'pe_import', 'con...

Constants

Cryptographic constants, or you can also call it signatures or patterns.

About

Cryfind is a tool to help you find crypto signatures in binary.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages