{"id":13594384,"url":"https://github.com/RCayre/mirage","last_synced_at":"2025-04-09T07:31:48.497Z","repository":{"id":52820120,"uuid":"203883338","full_name":"RCayre/mirage","owner":"RCayre","description":"  Mirage is a powerful and modular framework dedicated to the security analysis of wireless communications.","archived":false,"fork":false,"pushed_at":"2023-01-26T03:06:32.000Z","size":388,"stargazers_count":248,"open_issues_count":17,"forks_count":44,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-08-02T16:52:03.233Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://homepages.laas.fr/rcayre/mirage-documentation","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RCayre.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-22T22:36:00.000Z","updated_at":"2024-07-28T16:34:57.000Z","dependencies_parsed_at":"2023-01-31T07:30:52.439Z","dependency_job_id":null,"html_url":"https://github.com/RCayre/mirage","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RCayre%2Fmirage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RCayre%2Fmirage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RCayre%2Fmirage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RCayre%2Fmirage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RCayre","download_url":"https://codeload.github.com/RCayre/mirage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223375314,"owners_count":17135348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T16:01:32.668Z","updated_at":"2024-11-06T16:31:15.275Z","avatar_url":"https://github.com/RCayre.png","language":"Python","funding_links":[],"categories":["Python","ZigBee","♻️ Projects Using micro:bit as a Dev Board"],"sub_categories":["Tools","🎓 Machine Learning Resources \u0026 Projects"],"readme":"MIRAGE - 1.2\n=============\n\nThis framework is released as an opensource project using the MIT License.\n\nMirage is a powerful and modular framework dedicated to the security analysis of wireless communications. It currently provides :\n\n  * multiple **lightweight and hackable wireless protocol stacks** (e.g. Bluetooth Low Energy, Enhanced ShockBurst, WiFi, Zigbee ...)\n  * multiple **highly customizable offensive modules** (e.g. Man-in-the-Middle, sniffing, jamming, hijacking, cloning ...)\n  * mutiple **modules dedicated to information gathering** (e.g. applicative layers dumping, scanning ...)\n  * mutiple **experimental offensive modules based on InjectaBLE attack** (e.g. Bluetooth Low Energy injection, Slave and Master hijacking, MiTM ...)\n  * a **chaining operator** allowing to easily combine attack modules in order to **build complex attack workflows**\n  * support of **multiple devices**, such as HCI devices, Crazy Radio PA, RZUSBStick, BTLEJack, Nordic, Sniffle, ButteRFly and Ubertooth sniffers\n  * an **user-friendly development environment** allowing to easily **write new modules** or **customize existing ones**\n  * an experimental **Software defined radio** architecture, allowing to sniff and inject packets using HackRF One\n\nUseful links\n------------\n\n * Documentation: http://homepages.laas.fr/rcayre/mirage-documentation/index.html\n * Documentation (sphinx source code): https://redmine.laas.fr/projects/mirage-documentation\n * Mirage can manipulate IR signals using an opensource hardware called IRma, the schematics and firmware source code can be found here: https://redmine.laas.fr/projects/mirage-irma-device\n * Mirage can perform experimental Bluetooth Low Energy attacks using ButteRFly device (nRF52840 dongle): https://github.com/RCayre/injectable-firmware. This new device allows to inject packets into an established connection, hijack the slave role, hijack the master role or perform a Man-in-the-Middle attack.\n * Mirage can use a custom BTLEJack firmware for the BBC Micro:Bit, adding some specific features for manipulating advertisements: https://redmine.laas.fr/projects/btlejack-custom-firmware\n\nThe original BTLEJack firmware, written by Damien Cauquil, is available on github :\n\n * BTLEJack: https://github.com/virtualabs/btlejack\n * BTLEJack firmware: https://github.com/virtualabs/btlejack-firmware\n\nPublications\n------------\n\nThis framework is developed in the context of research works focused on IoT security by Romain Cayre, who is a PhD student at LAAS-CNRS and Apsys.Lab. His PhD thesis is supervised by Guillaume Auriol, Vincent Nicomette and Mohamed Kaâniche.\n\nWe published two papers describing this tool:\n\n * Romain Cayre, Jonathan Roux, Eric Alata, Vincent Nicomette, Guillaume Auriol. [Mirage : un framework offensif pour l'audit du Bluetooth Low Energy](https://hal.laas.fr/hal-02268774). *Symposium sur la Sécurité des Technologies de l'Information et des Communications (SSTIC 2019)*, Jun 2019, Rennes, France. pp.229-258. **\\[fr\\]**\n * Romain Cayre, Vincent Nicomette, Guillaume Auriol, Eric Alata, Mohamed Kaâniche, et al.. [Mirage: towards a Metasploit-like framework for IoT](https://hal.laas.fr/hal-02346074). *2019 IEEE 30th International Symposium on Software Reliability Engineering (ISSRE)*, Oct 2019, Berlin, Germany. **\\[en\\]**\n\nWe also published two papers describing a new Bluetooth Low Energy attack, named InjectaBLE, allowing to inject malicious traffic into an established BLE connection. Mirage (v1.2) adds support for a new device, named ButteRFly, allowing to perform this attack:\n\n* Romain Cayre, Florent Galtier, Guillaume Auriol, Vincent Nicomette, Mohamed Kaâniche, et al.. [InjectaBLE : injection de trafic malveillant dans une connexion Bluetooth Low Energy](https://hal.laas.fr/hal-03221143). *Symposium sur la sécurité des technologies de l'information et des communications (SSTIC 2021)*, Jun 2021, Rennes (en ligne), France. **\\[fr\\]**\n* Romain Cayre, Florent Galtier, Guillaume Auriol, Vincent Nicomette, Mohamed Kaâniche, et al.. [InjectaBLE: Injecting malicious traffic into established Bluetooth Low Energy connections](https://hal.laas.fr/hal-03193297). *IEEE/IFIP International Conference on Dependable Systems and Networks (DSN)*, Jun 2021, Taipei (virtual), Taiwan. **\\[en\\]**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRCayre%2Fmirage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRCayre%2Fmirage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRCayre%2Fmirage/lists"}