avatar2

Willkommen bei Avatar², dem Zielorchestrierungsrahmen mit Schwerpunkt auf der dynamischen Analyse der Firmware der eingebetteten Geräte!

Avatar² wird von der S3 -Gruppe von Eurecom entwickelt und gepflegt.

Gebäude

Das Gebäude Avatar² ist einfach!

Stellen Sie zunächst sicher, dass alle Abhängigkeiten vorhanden sind:

 sudo apt-get install python-pip python-setuptools python-dev cmake

Verwenden Sie anschließend Python-Pip, um Avatar2 zu installieren:

 pip install avatar2

Jetzt seid ihr alle bereit zu gehen. Wenn Sie bestimmte Ziel-Entpoints installieren möchten, führen Sie bitte die Avatar2-Installation aus, die versucht, die Endpunkte automatisch abzurufen und zu installieren.

 python -m avatar2.installer

Bau mit Docker

Es ist eine Dockerfile vorhanden, die standardmäßig Avatar² mit QEMU- und Panda -Zielendpunkten erstellt:

 $ docker build -t avatar2 .
$ docker run --rm avatar2 python3 -c "import avatar2"

Alternativ können Sie generate_dockerfile.py verwenden, um ein Docker -Bild nur mit den Zielendpunkten zu erstellen, die Ihr Bedarf angeht:

 $ python3 generate_dockerfile.py --endpoint_list avatar-qemu --qemu_targets arm-softmmu
$ docker build -t avatar2 .

Manuell aufbauen

Avatar² kann auch manuell gebaut werden. Die folgenden drei Befehle reichen aus, um den Kern zu installieren.

 $ git clone https://github.com/avatartwo/avatar2.git
$ cd avatar2
$ sudo python setup.py install

Anschließend können die verschiedenen Zielendpunkte wie Qemu oder Panda gebaut werden. Dazu bieten wir Build -Skripte für Ubuntu 20.04 an - während andere Verteilungen (noch) nicht offiziell unterstützt werden, sind die Skripte bekannt, dass auch die Skripte auch mit geringfügigen Änderungen an anderen Verteilungen funktionieren.

 $ cd targets
$ ./build_*.sh

Bitte beachten Sie: Diese Skripte fügen das eingeschränkte Repository zu /etc/apt/sources.list hinzu, um die Abhängigkeiten abzurufen. Wenn Sie damit nicht vertraut sind, sollten Sie Avatar² in einem VM/Container erstellen oder die Abhängigkeiten manuell installieren und die Skripte einstellen.

Erste Schritte

Um die Kraft von Avatar² zu entdecken und ein Gefühl für die Nutzung zu bekommen, empfehlen wir, das Handbuch hier auf Github zu überprüfen. Zusätzlich wird hier eine Dokumentation der API bereitgestellt und einige vorbildliche Avatar²-Skripte finden Sie hier. Eine weitere gute Möglichkeit, mit Avatar² zu beginnen, besteht darin, das offizielle Avatar²-Papier zu lesen oder das 34c3-Talk zu beobachten.

Für weitere Unterstützung oder Follow-up-Fragen senden Sie eine E-Mail an avatar2 [at] lists.eurecom.fr, unsere öffentliche Mailingliste, auf die Sie sich hier abonnieren können.

Darüber hinaus finden Sie uns auf Slack, um lebendigere Kommunikationsmittel zu erhalten. Wenn Sie eine Einladung wünschen, senden Sie uns einfach eine Post!

Veröffentlichungen

Die folgenden Veröffentlichungen beschreiben, verwenden oder erweitern den Avatar² -Framework:

1. M. Muench, D. Nisi, A. Francillon, D. Balzarotti. "Avatar²: Eine Multi-Target-Orchestrierungsplattform." Workshop on Binary Analysis Research (Bar), San Diego, Kalifornien, Februar 2018.
   • Papier - Code
2. M. Muench, J. Stijohann, F. Kargl, A. Francillon, D. Balzarotti. "Was Sie beschädigen, ist nicht das, was Sie abstürzen: Herausforderungen bei der Verschmelzung eingebetteter Geräte." Netzwerk- und Distributed System Security Symposium (NDSS), San Diego, Kalifornien, 2018.
   • Papier - Code
3. D. Maier, B. Radtke, B. Harren. "Unicorefuzz: Über die Lebensfähigkeit der Emulation für Kernelspace -Fuzzing." Workshop über Offensivtechnologien (WOOT), Santa Clara, Kalifornien, August 2019.
   • Papier - Code
4. E. Gustafson, M. Muench, C. Spensky, N. Redini, A. Machiry, A. Francillon, D. Balzarotti, Ye Choe, C. Krugel, G. Vigna. "Auf dem Weg zu der Analyse der eingebetteten Firmware durch automatisiertes Wiederholungsveranstalter." Symposium über Resarch in Angriffen, Intrusionen und Verteidigungen (RAID), Peking, China, September 2019.
   • Papier - Code
5. Aa Clements, E. Gustafson, T. Scharnowski, P. Grosen, D. Fritz, C. Krugel, G. Vigna, S. Bagchi, M. Zahler. "Halucinator: Firmware-Wiederholung durch Abstraktionsschichtemulation." Usenix Security Symposium, August 2020.
   • Papier - Code
6. C. Cao, L. Guan, J. Ming, P. Liu. "Geräte-agnostische Firmware-Ausführung ist möglich: ein konkolischer Ausführungsansatz für die periphere Emulation." Jährliche Konferenz für Computersicherheitsanwendungen (ACSAC), Dezember 2020.
   • Papier - Code
7. G. Hernandez, M. Muench, D. Maier, A. Milburn, S. Park, T. Scharnowski, T. Tucker, P. Traynor, KRB Butler. "Firmwire: Transparente dynamische Analyse für die Firmware für Mobilfunkbasisband." Symposium in Netzwerk- und Distributed System Security (NDSS), April 2022.
   • Papier - Code

Anerkennung

Das Avatar² -Projekt wurde teilweise durch die Siemens AG -Technologie finanziert und unterstützt.