Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jvoisin/php-malware-finder
Detect potentially malicious PHP files
https://github.com/jvoisin/php-malware-finder
antivirus malware php webshell yara
Last synced: 3 months ago
JSON representation
Detect potentially malicious PHP files
- Host: GitHub
- URL: https://github.com/jvoisin/php-malware-finder
- Owner: jvoisin
- License: lgpl-3.0
- Archived: true
- Created: 2015-07-02T09:29:21.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-10-20T16:02:54.000Z (about 1 year ago)
- Last Synced: 2024-09-21T00:01:52.255Z (3 months ago)
- Topics: antivirus, malware, php, webshell, yara
- Language: PHP
- Size: 3.58 MB
- Stars: 1,466
- Watchers: 75
- Forks: 284
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - jvoisin/php-malware-finder - Detect potentially malicious PHP files (PHP)
README
# PHP Malware Finder
```
_______ __ __ _______
| ___ || |_| || |
| | | || || ___|
| |___| || || |___ Webshell finder,
| ___|| || ___| kiddies hunter,
| | | ||_|| || | website cleaner.
|___| |_| |_||___|
Detect potentially malicious PHP files.
```
## What does it detect?
PHP-malware-finder does its very best to detect obfuscated/dodgy code as well as
files using PHP functions often used in malwares/webshells.
The following list of encoders/obfuscators/webshells are also detected:
* [Bantam](https://github.com/gellin/bantam)
* [Best PHP Obfuscator]( http://www.pipsomania.com/best_php_obfuscator.do )
* [Carbylamine]( https://code.google.com/p/carbylamine/ )
* [Cipher Design]( http://cipherdesign.co.uk/service/php-obfuscator )
* [Cyklodev]( http://sysadmin.cyklodev.com/online-php-obfuscator/ )
* [Joes Web Tools Obfuscator]( http://www.joeswebtools.com/security/php-obfuscator/ )
* [P.A.S]( http://profexer.name/pas/download.php )
* [PHP Jiami]( http://www.phpjiami.com/ )
* [Php Obfuscator Encode]( http://w3webtools.com/encode-php-online/ )
* [SpinObf]( http://mohssen.org/SpinObf.php )
* [Weevely3]( https://github.com/epinna/weevely3 )
* [atomiku]( http://atomiku.com/online-php-code-obfuscator/ )
* [cobra obfuscator]( http://obfuscator.uk/example/ )
* [nano]( https://github.com/UltimateHackers/nano )
* [novahot]( https://github.com/chrisallenlane/novahot )
* [phpencode]( http://phpencode.org )
* [tennc]( http://tennc.github.io/webshell/ )
* [web-malware-collection]( https://github.com/nikicat/web-malware-collection )
* [webtoolsvn]( http://www.webtoolsvn.com/en-decode/ )
* [Kraken-ng]( https://github.com/kraken-ng/ )
Of course it's **trivial** to bypass PMF,
but its goal is to catch kiddies and idiots,
not people with a working brain.
If you report a stupid tailored bypass for PMF, you likely belong to one (or
both) category, and should re-read the previous statement.
## How does it work?
Detection is performed by crawling the filesystem and testing files against a
[set](https://github.com/jvoisin/php-malware-finder/blob/master/php-malware-finder/php.yar)
of [YARA](http://virustotal.github.io/yara/) rules. Yes, it's that simple!
Instead of using a *hash-based* approach,
PMF tries as much as possible to use semantic patterns, to detect things like
"a `$_GET` variable is decoded two times, unzipped,
and then passed to some dangerous function like `system`".
## Installation
### From source
- Install Go >= 1.17 (using your package manager, or [manually](https://go.dev/doc/install))
- Install libyara >= 4.2 (using your package manager, or [from source](https://yara.readthedocs.io/en/stable/gettingstarted.html))
- Download php-malware-finder: `git clone https://github.com/jvoisin/php-malware-finder.git`
- Build php-malware-finder: `cd php-malware-finder && make`
or replace the last 2 steps with `go install github.com/jvoisin/php-malware-finder`,
which will directly compile and install PMF in your `${GOROOT}/bin` folder.
## How to use it?
```
$ ./php-malware-finder -h
Usage:
php-malware-finder [OPTIONS] [Target]
Application Options:
-r, --rules-dir= Alternative rules location (default: embedded rules)
-a, --show-all Display all matched rules
-f, --fast Enable YARA's fast mode
-R, --rate-limit= Max. filesystem ops per second, 0 for no limit (default: 0)
-v, --verbose Verbose mode
-w, --workers= Number of workers to spawn for scanning (default: 32)
-L, --long-lines Check long lines
-c, --exclude-common Do not scan files with common extensions
-i, --exclude-imgs Do not scan image files
-x, --exclude-ext= Additional file extensions to exclude
-u, --update Update rules
-V, --version Show version number and exit
Help Options:
-h, --help Show this help message
```
Or if you prefer to use `yara`:
```
$ yara -r ./data/php.yar /var/www
```
Please keep in mind that you should use at least YARA 3.4 because we're using
[hashes]( https://yara.readthedocs.org/en/latest/modules/hash.html ) for the
whitelist system, and greedy regexps. Please note that if you plan to build
yara from sources, libssl-dev must be installed on your system in order to
have support for hashes.
Oh, and by the way, you can run the *comprehensive* testsuite with `make tests`.
### Docker
If you want to avoid having to install Go and libyara, you can also use our
docker image and simply mount the folder you want to scan to the container's
`/data` directory:
```
$ docker run --rm -v /folder/to/scan:/data ghcr.io/jvoisin/php-malware-finder
```
## Whitelisting
Check the [whitelist.yar](https://github.com/jvoisin/php-malware-finder/blob/master/php-malware-finder/whitelist.yar) file.
If you're lazy, you can generate whitelists for entire folders with the
[generate_whitelist.py](https://github.com/jvoisin/php-malware-finder/blob/master/php-malware-finder/utils/generate_whitelist.py) script.
## Why should I use it instead of something else?
Because:
- It doesn't use [a single rule per sample](
https://github.com/Neo23x0/signature-base/blob/e264d66a8ea3be93db8482ab3d639a2ed3e9c949/yara/thor-webshells.yar
), since it only cares about finding malicious patterns, not specific webshells
- It has a [complete testsuite](https://github.com/jvoisin/php-malware-finder/actions), to avoid regressions
- Its whitelist system doesn't rely on filenames
- It doesn't rely on (slow) [entropy computation]( https://en.wikipedia.org/wiki/Entropy_(information_theory) )
- It uses a ghetto-style static analysis, instead of relying on file hashes
- Thanks to the aforementioned pseudo-static analysis, it works (especially) well on obfuscated files
## Licensing
PHP-malware-finder is
[licensed](https://github.com/jvoisin/php-malware-finder/blob/master/php-malware-finder/LICENSE)
under the GNU Lesser General Public License v3.
The _amazing_ YARA project is licensed under the Apache v2.0 license.
Patches, whitelists or samples are of course more than welcome.