piof

PIOF - PHP Instrumentation Open Framework

Was

PIOF - ist ein dynamisches und modulares Instrumentierungsrahmen für PHP.

Warum

Es ist nützlich für Entwickler, Reverse -Ingenieure, Malware -Analysten und Verwundbarkeitsforscher. Mit Piof können Sie:

• Führen Sie Debugging, Tracing und Leistungsanalyse durch
• Instrument -PHP -Code auf der Interpreterschicht
• Instrument verschleierten PHP -Code
• Virtuelles Patching
• Prototyp IAST- und RASP -Technologien

Wo

Getestet auf:

 PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

WHO

Martino - Twitter.com/Martinolessio

Alessandro - Twitter.com/RHPCO

Schneller Start

 git clone https://github.com/ingenuity-ninja/piof.git
cd piof
./run.sh

Docker

Ein Docker -Container wird für die Gebäude- und Testphase verwendet. Verwenden Sie die Behälterschale, um mit der PIOF -Umgebung zu interagieren:

 root@4e7b7dd9f362:/opt/piof/modules#

Verlängerung

Die generierte PHP -Erweiterung ist in /opt/piof/modules verfügbar

 root@4e7b7dd9f362:/opt/piof/modules# ls -lah
total 100K
drwxr-xr-x 2 root root 4.0K Feb 19 20:55 .
drwxr-xr-x 1 root root 4.0K Feb 19 20:55 ..
-rwxr-xr-x 1 root root  91K Feb 19 20:55 piof.so

Sie können es entweder in Ihr Php.ini aufnehmen oder aus der Befehlszeile verwenden.

Befehlszeile

Wenn die Erweiterung in php.ini aktiviert ist, können Sie beispielsweise PHP wie gewohnt ausführen:

 root@4e7b7dd9f362:/etc# php -r "system("ls");"

adduser.conf
aliases
alternatives
apache2
apt
bash.bashrc
bindresvport.blacklist
ca-certificates
ca-certificates.conf
cron.d
[...]

Um das Modul zur Laufzeit zu verwenden, können Sie den folgenden Befehl verwenden:

 php -dextension=/opt/piof/modules/piof.so -r "system("ls");"

Logger

Piof logs in /var/log/piof*

Information

Die Hooking -Module protokolliert Informationen zur Sink -Ausführung:

 root@4e7b7dd9f362:/etc# tail -f /var/log/piof.info.log

Feb 19 21:05:15 4e7b7dd9f362 piof - system - hook[155]: Arguments 1
Feb 19 21:05:15 4e7b7dd9f362 piof - system - hook[155]: Parameter ls
Feb 19 21:12:17 4e7b7dd9f362 piof - md5 - hook[160]: Arguments 1
Feb 19 21:12:17 4e7b7dd9f362 piof - md5 - hook[160]: Parameter admin

Fehler

Alle internen Fehler sind in /var/log/piof.error.log protokolliert

Hakenmodule

Hakenmodule befinden sich in /opt/piof/hooks . Diese Module werden von der PIOF -Kernverlängerung dynamisch erstellt und geladen, sodass sie immer mit piof.so verfügbar sein müssen. Die Module sind in Verzeichnissen hierarchisch organisiert: Jedes Verzeichnis ist einer Spüle zugeordnet, und jede enthält eine hook.c und eine hook.h -Datei.

 root@42e0da0df931:/opt/piof/hooks# ls -lah
total 28K
drwxrwxr-x 1 root root 4.0K Feb 19 20:55 .
drwxr-xr-x 1 root root 4.0K Feb 19 20:55 ..
drwxr-xr-x 2 root root 4.0K Feb 19 20:55 build
drwxrwxr-x 2 root root 4.0K Feb 19 20:24 eval
drwxrwxr-x 2 root root 4.0K Feb 19 20:24 include
drwxrwxr-x 2 root root 4.0K Feb 19 20:24 md5
drwxrwxr-x 2 root root 4.0K Feb 19 20:24 system

Und

 root@42e0da0df931:/opt/piof/hooks# ls -lah include/
total 16K
drwxrwxr-x 2 root root 4.0K Feb 19 20:24 .
drwxrwxr-x 1 root root 4.0K Feb 19 20:55 ..
-rw-rw-r-- 1 root root  943 Feb 19 20:24 hook.c
-rw-rw-r-- 1 root root  356 Feb 19 20:24 hook.h

Während der Gebäudestufe erstellt PIOF alle Module und verschieben Sie die generierten .so -Dateien in /opt/piof/hooks/build

 root@42e0da0df931:/opt/piof/hooks/build# ls -lah
total 184K
drwxr-xr-x 2 root root 4.0K Feb 19 20:55 .
drwxrwxr-x 1 root root 4.0K Feb 19 20:55 ..
-rwxr-xr-x 1 root root  43K Feb 19 20:55 eval.so
-rwxr-xr-x 1 root root  43K Feb 19 20:55 include.so
-rwxr-xr-x 1 root root  44K Feb 19 20:55 md5.so
-rwxr-xr-x 1 root root  44K Feb 19 20:55 system.so

Manuelles Erweiterungsgebäude

 make clean
phpize
./configure
make

Manual -Module Gebäude

 cd /opt/piof/hooks/eval/
gcc -shared -o eval.so -fPIC hook.c -g -Wall -I -I/usr/local/include/php -I/usr/local/include/php/main -I/usr/local/include/php/Zend -I/usr/local/include/php/TSRM -I/usr/local/include/php/Zend -I/usr/local/include/php/ext -I/usr/local/include/php/ext/date/lib -I/usr/include/php/20170718 -I/usr/include/php/20170718/main -I/usr/include/php/20170718/TSRM -I/usr/include/php/20170718/Zend -I/usr/include/php/20170718/ext -I/usr/include/php/20170718/ext/date/lib -I ../../
mv eval.so ../build

Manuelle Tests

Hakenfunktion md5

 php -dextension=/opt/piof/modules/piof.so -r "echo md5("admin");"

system

 php -dextension=/opt/piof/modules/piof.so -r "system("ls");"

Lizenz

3-Klausel BSD-Lizenz (BSD-3-Klausel)