avatar2

Bienvenue sur Avatar², le cadre d'orchestration cible avec une analyse dynamique du firmware des appareils intégrés!

Avatar² est développé et maintenu par le groupe S3 d'Eurecom.

Bâtiment

Construire Avatar² est facile!

Tout d'abord, assurez-vous que toutes les dépendances sont présentes:

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

Ensuite, utilisez Python-Pip pour installer Avatar2:

 pip install avatar2

Maintenant, vous êtes tous prêts à partir. De plus, si vous souhaitez installer des points cibles spécifiques, veuillez exécuter l'Avatar2-Installer, qui essaie de récupérer et d'installer automatiquement les points de terminaison.

 python -m avatar2.installer

Bâtiment avec Docker

Un dockerfile est présent qui construit par défaut Avatar² avec des points de terminaison cibles Qemu et Panda:

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

Alternativement, vous pouvez utiliser generate_dockerfile.py pour créer une image Docker avec uniquement les points de terminaison cibles votre besoin:

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

Bâtiment manuellement

Avatar² peut également être construit manuellement. Les trois commandes suivantes sont suffisantes pour installer le noyau.

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

Ensuite, les différents points de terminaison cibles peuvent être construits, tels que Qemu ou Panda. Pour ce faire, nous fournissons des scripts de construction pour Ubuntu 20.04 - bien que d'autres distributions ne soient pas officiellement soutenues (encore), les scripts sont connus pour fonctionner également avec de légères modifications sur d'autres distributions.

 $ cd targets
$ ./build_*.sh

Veuillez noter: ces scripts ajoutent le référentiel restreint à /etc/apt/sources.list pour récupérer les dépendances. Si vous n'êtes pas à l'aise avec cela, envisagez de construire Avatar² dans une machine virtuelle / conteneur ou installer les dépendances manuellement et ajuster les scripts.

Commencer

Pour découvrir la puissance d'Avatar² et avoir une idée de son utilisation, nous vous recommandons de vérifier fortement le manuel ici sur GitHub. De plus, une documentation de l'API est fournie ici et certains scripts d'avatar² exemplaires peuvent être trouvés ici. De plus, une autre bonne façon de commencer avec Avatar² est de lire le papier Avatar² officiel ou de regarder le talk 34c3.

Pour plus de questions de soutien ou de suivi, n'hésitez pas à envoyer un courrier à Avatar2 [at] lists.eucom.fr, notre liste de diffusion publique, sur laquelle vous pouvez vous abonner ici.

De plus, vous pouvez nous trouver sur Slack pour des moyens de communication plus vivants - si vous voulez une invitation, envoyez-nous un courrier!

Publications

Les publications suivantes décrivent, utilisent ou étendent le cadre Avatar²:

1. M. Muench, D. Nisi, A. Francillon, D. Balzarotti. "Avatar²: une plate-forme d'orchestration multi-cible." Atelier sur la recherche sur l'analyse binaire (BAR), San Diego, Californie, février 2018.
   • Papier - code
2. M. Muench, J. Stijohann, F. Kargl, A. Francillon, D. Balzarotti. "Ce que vous corrompez n'est pas ce que vous vous écrasez: les défis dans les appareils intégrés de fuzz." Symposium de sécurité des systèmes (NDSS) du réseau et distribué, San Diego, Californie, 2018.
   • Papier - code
3. D. Maier, B. Radtke, B. Harren. "Unicorefuzz: sur la viabilité de l'émulation pour le fuzzing d'espace de grains." Atelier sur les technologies offensives (WOot), Santa Clara, Californie, août 2019.
   • Papier - code
4. E. Gustafson, M. Muench, C. Spensky, N. Redini, A. Machiry, A. Francillon, D. Balzarotti, Ye Choe, C. Kruegel, G. Vigna. "Vers l'analyse du micrologiciel intégré par réamorce automatisé." Symposium on Resarch in Attacks, Intrusions et Defenses (RAID), Pékin, Chine, septembre 2019.
   • Papier - code
5. AA Clements, E. Gustafson, T. Scharnowski, P. Gosen, D. Fritz, C. Kruegel, G. Vigna, S. Bagchi, M. Payer. "Halucinator: réhabilitation du micrologiciel par émulation de couche abstraction." Usenix Security Symposium, août 2020.
   • Papier - code
6. C. Cao, L. Guan, J. Ming, P. Liu. "L'exécution du firmware de périphérique est possible: une approche d'exécution concoclée pour l'émulation périphérique." Conférence annuelle sur les applications de sécurité informatique (ACSAC), décembre 2020.
   • Papier - code
7. G. Hernandez, M. Muench, D. Maier, A. Milburn, S. Park, T. Scharnowski, T. Tucker, P. Traynor, Krb Butler. "Firmwire: analyse dynamique transparente pour le firmware de bande de base cellulaire." Symposium sur le réseau et la sécurité du système distribué (NDSS), avril 2022.
   • Papier - code

Remerciements

Le projet Avatar² a été partiellement financé et soutenu par la technologie Siemens Ag -.