Frequency Unbiased SDR-based Sign Understanding and Reverse Engineering
FISSURE is an open-source RF and reverse engineering framework designed for all talent ranges with hooks for sign detection and classification, protocol discovery, assault execution, IQ manipulation, vulnerability evaluation, automation, and AI/ML. The framework was constructed to advertise the fast integration of software program modules, radios, protocols, sign knowledge, scripts, circulate graphs, reference materials, and third-party instruments. FISSURE is a workflow enabler that retains software program in a single location and permits groups to effortlessly stand up to hurry whereas sharing the identical confirmed baseline configuration for particular Linux distributions.
The framework and instruments included with FISSURE are designed to detect the presence of RF vitality, perceive the traits of a sign, acquire and analyze samples, develop transmit and/or injection methods, and craft customized payloads or messages. FISSURE accommodates a rising library of protocol and sign data to help in identification, packet crafting, and fuzzing. On-line archive capabilities exist to obtain sign recordsdata and construct playlists to simulate visitors and check techniques.
The pleasant Python codebase and consumer interface permits inexperienced persons to shortly study fashionable instruments and methods involving RF and reverse engineering. Educators in cybersecurity and engineering can make the most of the built-in materials or make the most of the framework to exhibit their very own real-world functions. Builders and researchers can use FISSURE for his or her every day duties or to show their cutting-edge options to a wider viewers. As consciousness and utilization of FISSURE grows in the neighborhood, so will the extent of its capabilities and the breadth of the know-how it encompasses.
Getting Began
Supported
There are two branches inside FISSURE to make file navigation simpler and cut back code redundancy. The Python2_maint-3.7 department accommodates a codebase constructed round Python2, PyQt4, and GNU Radio 3.7; whereas the Python3_maint-3.8 department is constructed round Python3, PyQt5, and GNU Radio 3.8.
Working System | FISSURE Department |
---|---|
Ubuntu 18.04 (x64) | Python2_maint-3.7 |
Ubuntu 18.04.5 (x64) | Python2_maint-3.7 |
Ubuntu 18.04.6 (x64) | Python2_maint-3.7 |
Ubuntu 20.04.1 (x64) | Python3_maint-3.8 |
Ubuntu 20.04.4 (x64) | Python3_maint-3.8 |
In-Progress (beta)
Working System | FISSURE Department |
---|---|
Ubuntu 22.04 (x64) | Python3_maint-3.8 |
Be aware: Sure software program instruments don’t work for each OS. Seek advice from Software program And Conflicts
Set up
git clone https://github.com/ainfosec/fissure.git
cd FISSURE
git checkout <Python2_maint-3.7> or <Python3_maint-3.8>
./set up
It will routinely set up PyQt software program dependencies required to launch the set up GUIs if they aren’t discovered.
Subsequent, choose the choice that finest matches your working system (needs to be detected routinely in case your OS matches an choice).
Python2_maint-3.7 | Python3_maint-3.8 |
---|---|
It is strongly recommended to put in FISSURE on a clear working system to keep away from current conflicts. Choose all of the really helpful checkboxes (Default button) to keep away from errors whereas working the varied instruments inside FISSURE. There will likely be a number of prompts all through the set up, largely asking for elevated permissions and consumer names. If an merchandise accommodates a “Confirm” part on the finish, the installer will run the command that follows and spotlight the checkbox merchandise inexperienced or pink relying on if any errors are produced by the command. Checked objects with no “Confirm” part will stay black following the set up.
Utilization
Seek advice from the FISSURE Assist menu for extra particulars on utilization.
Particulars
Parts
- Dashboard
- Central Hub (HIPRFISR)
- Goal Sign Identification (TSI)
- Protocol Discovery (PD)
- Circulation Graph & Script Executor (FGE)
Capabilities
Sign Detector
IQ Manipulation
Sign Lookup
Sample Recognition
Assaults
Fuzzing
Sign Playlists
Picture Gallery
Packet Crafting
Scapy Integration
CRC Calculator
Logging
Classes
FISSURE comes with a number of useful guides to grow to be accustomed to totally different applied sciences and methods. Many embrace steps for utilizing numerous instruments which can be built-in into FISSURE.
- Lesson1: OpenBTS
- Lesson2: Lua Dissectors
- Lesson3: Sound eXchange
- Lesson4: ESP Boards
- Lesson5: Radiosonde Monitoring
- Lesson6: RFID
- Lesson7: Knowledge Sorts
- Lesson8: Customized GNU Radio Blocks
- Lesson9: TPMS
- Lesson10: Ham Radio Exams
- Lesson11: Wi-Fi Instruments
Roadmap
Contributing
Solutions for bettering FISSURE are strongly inspired. Depart a remark within the Discussions web page if in case you have any ideas relating to the next:
- New function ideas and design adjustments
- Software program instruments with set up steps
- New classes or extra materials for current classes
- RF protocols of curiosity
- Extra {hardware} and SDR varieties for integration
- IQ evaluation scripts in Python
- Set up corrections and enhancements
Contributions to enhance FISSURE are essential to expediting its growth. Any contributions you make are enormously appreciated. If you happen to want to contribute by means of code growth, please fork the repo and create a pull request:
- Fork the undertaking
- Create your function department (
git checkout -b function/AmazingFeature
) - Commit your adjustments (
git commit -m 'Add some AmazingFeature'
) - Push to the department (
git push origin function/AmazingFeature
) - Open a pull request
Creating Points to carry consideration to bugs can also be welcomed.
Collaborating
Contact Assured Data Safety, Inc. (AIS) Enterprise Improvement to suggest and formalize any FISSURE collaboration alternatives–whether or not that’s by means of dedicating time in the direction of integrating your software program, having the gifted individuals at AIS develop options in your technical challenges, or integrating FISSURE into different platforms/functions.
License
GPL-3.0
For license particulars, see LICENSE file.
Contact
Comply with on Twitter: @FissureRF, @AinfoSec
Chris Poore – Assured Data Safety, Inc. – [email protected]
Enterprise Improvement – Assured Data Safety, Inc. – [email protected]
Acknowledgments
Particular because of Dr. Samuel Mantravadi and Joseph Reith for his or her contributions to this undertaking.