ainfosec/fissureO framework de RF e engenharia reversa para todos. Siga e ★ para mostrar seu apoio!
Compreensão de Sinais e Engenharia Reversa Baseada em SDR Independente de Frequência
Visão Geral Operacional do FISSURE |
Visão Geral do FISSURE (Slides) |
O FISSURE é um framework RF de código aberto que suporta tanto implantações operacionais quanto pesquisa e educação.
O FISSURE simplifica fluxos de trabalho complexos de SDR ao centralizar software, bibliotecas e material de referência em um único framework consistente que roda em desktops, laptops, computadores de placa única e sistemas robustecidos, ou escala para nós táticos distribuídos em rede no campo.
O Fracture é o sistema RF tático implantável da AIS construído sobre o framework de código aberto FISSURE.
O FISSURE fornece o ambiente de software subjacente para sensoriamento RF, análise de sinais, experimentação de protocolos, integração com TAK, coordenação de nós distribuídos e desenvolvimento de capacidades baseado em plugins. O Fracture estende essa fundação para configurações de hardware implantáveis projetadas para uso operacional.
O Fracture foca em sensoriamento RF distribuído, geolocalização, efeitos RF, fluxos de trabalho de guerra eletrônica e controle operacional em tempo real através do WinTAK e ATAK. Um hub central coordena nós de borda através de redes IP e links RF de longo alcance para suportar sensoriamento, direcionamento e execução de missões em ambientes distribuídos.
A arquitetura é projetada para suportar implantações em locais fixos, veículos, mochilas, sUAS e asas fixas, permanecendo extensível através do framework de plugins do FISSURE.
Para organizações que necessitam de uma capacidade RF tática integrada e com suporte, o Fracture oferece um caminho de comercialização que preserva a flexibilidade, transparência e extensibilidade do ecossistema FISSURE subjacente.
O roteiro do FISSURE evolui com a demanda dos clientes e feedback da comunidade.
Para a visão mais atualizada, explore o roteiro interativo (atualizado todo mês de julho):
O FISSURE é apoiado por uma série de white papers que exploram aplicações técnicas e operacionais em diferentes domínios.
A AIS publicou vários artigos destacando as aplicações, atualizações e casos de uso do FISSURE:
Veja todas as postagens do blog da AIS
Arquitetura de Plugins e Ações: O FISSURE está fazendo a transição para um framework unificado de plugins e ações que permite que capacidades sejam empacotadas, implantadas e executadas no Dashboard, nós sensores, WinTAK e ATAK.
Integração com WinTAK: O WinTAK agora suporta gerenciamento de nós, alertas, alvos, detecções, artefatos, seleção de plugins, execução de ações e operações de nós sensores distribuídos.
Integração com ATAK: A integração com ATAK está ativamente em desenvolvimento, estendendo as capacidades do FISSURE e Fracture para dispositivos móveis e operadores de borda tática.
Nós Táticos Distribuídos: Nós sensores suportam operação remota, fluxos de trabalho de sensoriamento distribuído, integração com TAK, coleta de artefatos, alertas e execução de plugins em redes conectadas por IP.
Geolocalização e Gerenciamento de Alvos: Os esforços de desenvolvimento continuam em geolocalização RF, gerenciamento de alvos, coordenação multi-nó e testes operacionais no mundo real.
Conteinerização Apptainer: O FISSURE pode ser implantado dentro de contêineres Apptainer para simplificar instalação, testes, portabilidade e implantação em plataformas suportadas.
Arquitetura Fracture e Fluxos de Trabalho TAK: Novos diagramas e documentação foram adicionados para ilustrar a arquitetura do sistema Fracture, fluxos de trabalho de integração com TAK e operações táticas distribuídas.
A seguir está uma lista de hardwares "suportados" com diferentes níveis de integração:
Suportado
Agora existem dois ramos no FISSURE: o ramo Python3 e o ramo Python2_maint-3.7. O ramo Python3 contém o código mais recente e tem suporte para PyQt5 e versões 3.8 e 3.10 do GNU Radio. O ramo Python2_maint-3.7 foi descontinuado e só será atualizado se ferramentas de terceiros específicas exigirem a versão 3.7 do GNU Radio ou um sistema operacional mais antigo. Apenas as versões menores mais recentes dos sistemas operacionais serão suportadas para instalações e faremos o possível para acompanhar. Sistemas operacionais que foram atualizados e ainda não foram totalmente testados serão listados em "Em Andamento".
Os lançamentos do GitHub fornecidos neste repositório são instantâneos periódicos do estado do projeto, destinados principalmente a fins de arquivamento. Esses lançamentos podem não incluir as últimas atualizações, correções de bugs ou recursos atualmente em desenvolvimento. Para acessar a versão mais atualizada do software, recomendamos fortemente usar o ramo principal Python3, que reflete o desenvolvimento contínuo e o estado atual do projeto.
O FISSURE é mais extensivamente testado no Ubuntu, tornando-o a plataforma mais validada.
Em Andamento (beta)
| Estes sistemas operacionais ainda estão em status beta. Eles estão em desenvolvimento e vários recursos conhecidamente faltam. Itens no instalador podem conflitar com programas existentes ou falhar ao instalar até que o status seja removido.Sistema Operacional |
|---|
Nota: Certas ferramentas de software não funcionam em todos os sistemas operacionais. Consulte Conflitos Conhecidos e Software de Terceiros
Instalações Apptainer
Testes estão em andamento com apptainer para containerizar instalações do FISSURE. Combinações de sistema operacional hospedeiro, sistema operacional do contêiner e modo de instalação do FISSURE (full, base, Dashboard, HIPRFISR, SensorNode) ainda estão em progresso. As seguintes são combinações suportadas.
| Sistema Operacional Hospedeiro | Sistema Operacional do Contêiner | Modo FISSURE |
|---|---|---|
| Ubuntu 24.04 | Ubuntu 24.04 | full |
Instalação
Para adicionar chaves SSH ao GitHub e clonar com SSH (necessário para contribuir):``` ssh-keygen -t ed25519 cat ~/.ssh/id_ed25519.pub Paste text into "Settings" > "SSH and GPG keys" > "New SSH Key" git clone [email protected]:ainfosec/FISSURE.git
Para clonagem com https:```
git clone https://github.com/ainfosec/FISSURE.git
Preparando o instalador:``` cd FISSURE git checkout Python3 # Optional, or Python2_maint-3.7 for select legacy third-party tools ./install
Notas:
- O instalador perguntará se deve instalar as dependências de software PyQt necessárias para executar as GUIs de instalação, caso não sejam encontradas.
- Selecione a opção de sistema operacional na GUI que melhor corresponda ao seu sistema operacional (deve ser detectado automaticamente se o seu SO corresponder a uma opção).
- Responda periodicamente às solicitações sobre software de terceiros durante a instalação. Use o seu melhor julgamento; as respostas provavelmente não afetarão o FISSURE.
- Certifique-se de que o relógio do sistema esteja configurado corretamente para evitar erros com o apt rejeitando atualizações de repositórios.
- Após a instalação, reinicie o computador ou faça logout e login novamente para que as alterações nos grupos de usuários tenham efeito.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/5588/ea812c13507dcd73629484d74bae5229caf78da4f8c48bcfd701d429c60bc392.png" width="257" height="379">
</p>
É recomendado instalar o FISSURE em um sistema operacional limpo para evitar conflitos com software existente. Esforços adicionais em relação à virtualização e gerenciamento de dependências serão continuados. Notas sobre o instalador:
- Os itens listados na categoria "Minimum Install" são o que é necessário para iniciar o Dashboard do FISSURE sem erros.
- O hardware de rádio e os módulos fora da árvore são necessários para realizar muitas ações no FISSURE.
- Os gráficos de fluxo precisam ser recompilados para evitar erros entre versões menores do GNU Radio.
- Programas de software fora da instalação mínima são opcionais e podem ser instalados conforme necessário.
- Selecione todas as caixas de seleção recomendadas (botão Default) para evitar erros ao operar as várias ferramentas dentro do FISSURE.
- Itens desmarcados por padrão podem não instalar corretamente ou possivelmente causar conflitos com programas existentes (sugira correções!).
- Haverá várias solicitações durante a instalação, principalmente pedindo permissões elevadas e nomes de usuário. Essas solicitações estão principalmente ligadas a ferramentas de terceiros; consulte as instruções de instalação fornecidas pelo mantenedor para obter detalhes.
- Se um item contiver uma seção "Verify" no final, o instalador executará o comando que se segue e destacará o item da caixa de seleção em verde ou vermelho, dependendo se algum erro for produzido pelo comando. Itens marcados sem uma seção "Verify" permanecerão pretos após a instalação.
- Para evitar erros de instalação e permissão, baixe o FISSURE para um diretório pertencente ao usuário, como o Home. Execute o script de instalação e o comando fissure sem usar sudo. Muitas ferramentas de terceiros serão baixadas e instaladas a partir do diretório `~/Installed_by_FISSURE`.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/5588/3c404a7fc456dc0a3346fc0ed7432381c57cf6f6db4358221010a5b66a3281f5.png" width="692" height="479">
</p>
O instalador do FISSURE é útil para preparar computadores ou instalar programas de software selecionados de interesse. O código pode ser rapidamente modificado para permitir instalações de software personalizadas. As estimativas de tamanho para os programas são leituras antes e depois de uma instalação completa. Os tamanhos para cada programa não são exatos, pois algumas dependências são instaladas em itens previamente marcados. Os tamanhos também podem mudar ao longo do tempo conforme os programas são atualizados.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/5588/e9722e4a18df1cdf579316e24ffd999e7f56f27c738340a5a997377453d4320c.png" width="692" height="479">
</p>
**Instalação do Nó Sensor Remoto**
Instale o FISSURE normalmente em um computador de uso geral. Instale o FISSURE no computador remoto no mesmo local de diretório que o computador local (até novo aviso) para evitar erros de caminho de arquivo com certas ações. Para configurar o nó sensor para operação remota, edite o arquivo "default.yaml" no diretório `./YAML/Sensor_Node_Config/` e edite os seguintes campos:
- nickname: (qualquer coisa, exceto "Local Sensor Node")
- hiprfisr_ip_address: (o endereço IP do HIPRFISR/hub ao qual o nó sensor se conecta)
- hardware: (preencha com as especificações do seu hardware)
Altere o campo "autorun" de `false` para `true` para executar o arquivo de reprodução automática padrão na inicialização e dispensar operações remotas. Novas listas de reprodução automática podem ser geradas e salvas na guia Dashboard Autorun.
O nó sensor remoto atua como um servidor e deve ter um conjunto de certificados válidos (gerados durante a instalação) que correspondam ao cliente (computador local). O servidor precisa dos arquivos "server.key_secret" e "client.key", enquanto o cliente precisa dos arquivos "client.key_secret" e "server.key". Se a pasta de certificados foi gerada no computador servidor, os arquivos do cliente devem ser transferidos manualmente para o outro computador.
**Uso do Dashboard Local**
Abra um novo terminal após a instalação e digite:```
fissure
O método pretendido para iniciar o FISSURE Dashboard é através do terminal sem sudo. O terminal fornece status e feedback importantes para algumas operações. Consulte a documentação do FISSURE para mais detalhes.
Um nó sensor local pode ser iniciado através dos botões superiores no FISSURE Dashboard e ajuda a manter toda a funcionalidade pré-existente do FISSURE em uma estação de trabalho autônoma. Apenas um nó local e quatro nós sensores remotos (ou cinco remotos) são suportados neste momento.
Se algum dos programas congelar ou travar ao fechar, os seguintes comandos podem ser usados para detectar um problema ou desligar à força:``` sudo ps -aux | grep fissure sudo pkill python3 sudo kill -9 sudo pkill python3 && sudo pkill -9 -f fissure
**Headless Hub**
O HIPRFISR pode ser iniciado sem a GUI do Dashboard para tornar os testes TAK e implantações operacionais mais eficientes. Abra um novo terminal após a instalação e digite:```
fissure-hiprfisr
O hub irá conectar-se automaticamente ao servidor TAK e os nós remotos poderão entrar sem interação.
Uso do Nó Sensor Remoto
Após configurar o arquivo de configuração do nó sensor (veja acima), o código do nó sensor pode ser executado usando este comando em um terminal:``` fissure-sensor-node
O código do nó sensor permanecerá ativo até que ctrl+c seja aplicado. A conexão ao nó sensor remoto é realizada através dos botões superiores do Painel FISSURE. Clicar com o botão direito nos botões superiores selecionará um nó sensor ativo para realizar operações. Operações futuras que utilizem mais de um nó por vez serão tratadas caso a caso nas guias individuais.
**Instruções para Windows 11 WSL2**
O FISSURE pode ser executado no Windows 11 usando o WSL2 para sistemas operacionais Linux suportados. A seguir estão as instruções para ajudar a instalar o WSL2, instalar um sistema operacional Linux, configurar o USB passthrough e instalar o FISSURE no sistema operacional Linux.
Instalar o WSL2:
1. Abra o PowerShell como Administrador
2. `wsl --install`
3. Ative a Virtualização na BIOS, verifique usando: Gerenciador de Tarefas>Desempenho>CPU>Virtualização
4. `wsl --set-default-version 2`
5. `wsl --list --online`
6. Instale uma versão específica (Ubuntu simples deve ser a versão mais recente listada): `wsl --install -d Ubuntu-22.04`
7. Abra o Menu Iniciar, procure por Ubuntu e inicie-o
8. Para desinstalar uma distribuição: `wsl --unregister Ubuntu-22.04`
Habilitar USB passthrough em um PowerShell como Administrador:
1. `winget install usbipd`
2. Adicione usbipd ao PATH do Sistema: Menu Iniciar>Variáveis de Ambiente>Editar as variáveis de ambiente do sistema>Propriedades do Sistema>Variáveis de Ambiente>Variáveis do Sistema>Path>Editar>Novo: `C:\Program Files\usbipd-win`
3. Feche e reabra o PowerShell como Administrador
4. `usbipd wsl list`
5. `usbipd wsl attach --busid <BUS_ID>` ou `usbipd wsl attach --busid <BUS_ID> --wsl <DistributionName>` (substitua <BUS_ID> pelo BUS ID real do dispositivo)
6. Para desanexar: `usbipd wsl detach --busid <BUS_ID>`
Instalar o FISSURE no Terminal Linux:
1. `sudo apt-get install git`
2. Clone o FISSURE e instale conforme detalhado acima
**Configuração TAK**
Para instalar e executar um servidor TAK local:
1. Registre-se e baixe o zip docker do servidor TAK do site: https://tak.gov/products/tak-server
2. Crie o diretório `~/Installed_by_FISSURE` se ele não existir
3. Coloque o arquivo .zip baixado em `~/Installed_by_FISSURE`
4. Execute o item Servidor TAK no instalador do FISSURE
5. Para WebTAK local, carregue o arquivo `~/Installed_by_FISSURE/taskerver-docker-#.#-RELEASE-##/tak/certs/files/webadmin.p12` no seu navegador (configurações>certificados)
6. Defina o campo "tak_on_startup" como True em `/FISSURE/YAML/User Configs/default.yaml` ou selecione "Start Docker Containers" no menu TAK do Painel FISSURE
7. Abra o WebTAK no menu TAK do FISSURE e verifique se o mapa carrega com conexão à internet
8. Defina o campo "connect_mode" (auto/manual/disabled) em `/FISSURE/YAML/User Configs/default.yaml`. Conecte-se ao servidor TAK no menu TAK do Painel FISSURE se definido como manual.
9. Execute um efeito do FISSURE que crie um alerta TAK (exemplos em breve)
Para conectar a um servidor TAK remoto:
1. Atualize os caminhos dos certificados em `/FISSURE/YAML/User Configs/default.yaml`
2. Defina o campo "connect_mode" (auto/manual/disabled) em `/FISSURE/YAML/User Configs/default.yaml`. Conecte-se ao servidor TAK no menu TAK do Painel FISSURE se definido como manual.
3. Execute um efeito do FISSURE que crie um alerta TAK (exemplos em breve)
**Configuração Apptainer**
Apptainer é usado para containerizar a maior parte da instalação do FISSURE, tornando a implantação e os testes mais simples em diferentes sistemas. Enquanto a maior parte do FISSURE é executada dentro do ambiente Apptainer, vários componentes ainda exigem configuração no **host**:
- **Contêineres Docker** (como o banco de dados PostgreSQL e o Servidor TAK) são executados no **host**, não dentro do Apptainer.
- **Regras udev, drivers USB e interfaces de hardware** também devem ser instalados no host para que SDRs, adaptadores Wi-Fi e outros periféricos funcionem corretamente.
Contêineres Apptainer pré-construídos e imagens ISO estão planejados para lançamentos futuros para simplificar a configuração. Estas instruções são destinadas a usuários que desejam **criar o contêiner Apptainer a partir da fonte** ou personalizar sua instalação.
1. **Clone o Repositório FISSURE**
2. **Configure o Instalador**
- Abra `FISSURE/install_apptainer.sh` em um editor de texto.
- Revise e ajuste as variáveis perto do topo do script.
Defina cada opção (`true` / `false`) de acordo com o que deseja incluir (ex.: `UHD`, `HackRF`, `Wi-Fi`, etc.).
- Escolha o modo de instalação desejado do FISSURE:
- `full` - Inclui todo o software SDR, ferramentas de rede e utilitários
- `base` - Apenas FISSURE principal + dependências de GUI (para acelerar a criação futura de contêineres)
- `Dashboard` - Apenas contêiner de GUI (sem ferramentas SDR)
- `HIPRFISR` - Build de servidor HIPRFISR headless
- `SensorNode` - Apenas build de nó sensor
3. **Execute o Instalador** ```bash
cd FISSURE/Installer
./install_apptainer.sh
Isso cria um sandbox Apptainer gravável no seu diretório pessoal e instala todo o software selecionado dentro do container e no host (quando aplicável).
Este comando abre um terminal dentro do contêiner FISSURE com portas USB, dispositivos de áudio e gráficos automaticamente vinculados para acesso a hardware e GUI.
O ambiente se comporta como uma instalação padrão, porém é mais isolado do host. Se você encontrar problemas ao usar o FISSURE dentro do Apptainer, informe-nos quais programas, hardware ou recursos não estão funcionando corretamente.
O FISSURE vem com vários guias úteis para se familiarizar com diferentes tecnologias e técnicas. Muitos incluem etapas para usar várias ferramentas que estão integradas ao FISSURE. Nosso objetivo é melhorar a qualidade e adicionar novos conteúdos ao longo do tempo.
O Desafio FISSURE é uma competição contínua de capture-the-flag construída em torno do framework FISSURE. Ele é projetado como uma ferramenta de aprendizado aberta onde qualquer pessoa pode praticar engenharia reversa de RF, explorar novos recursos e enfrentar desafios focados em protocolos.
Acesse os desafios em: Desafio FISSURE
Sugestões para melhorar o FISSURE são fortemente encorajadas. Boas áreas de contribuição incluem novos recursos, correções de instalação, protocolos de RF, suporte a hardware/SDR, ferramentas de terceiros, gráficos de fluxo GNU Radio, scripts de análise em Python, ações de plugins, lições, tutoriais e correções na documentação.
O melhor lugar para começar é a página de Discussões, o Servidor Discord, e-mail ou um Issue focado.
Contribuições de código são muito apreciadas:
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)Precisa de ideias mais específicas? Confira nosso roadmap e a lista contínua de possíveis itens a fazer.
O FISSURE é adequado para projetos de conclusão de curso, pesquisa de graduação, pesquisa de pós-graduação, cursos de RF/segurança cibernética e trabalhos de software de código aberto. Equipes de estudantes podem trabalhar em integração de hardware SDR, análise de protocolos de RF, detecção de sinais, análise de IQ, plugins, lições, visualização, integração com TAK ou documentação.
Estudantes, instrutores, grupos de pesquisa e organizações interessados em usar o FISSURE para projetos práticos de RF e engenharia reversa são incentivados a entrar em contato.
Entre em contato com o Desenvolvimento de Negócios da Assured Information Security, Inc. (AIS) para discutir o FISSURE e oportunidades de colaboração com o Fracture. A AIS pode ajudar na integração do FISSURE em plataformas e fluxos de trabalho existentes, desenvolvimento de plugins e capacidades personalizadas, expansão do suporte para novos hardwares e sensores, e construção de soluções de RF específicas para missões.
Organizações interessadas em sistemas Fracture implantáveis podem contratar a AIS para desenvolver e integrar configurações de nós táticos para aplicações em locais fixos, veículos, mochilas, sUAS e aeronaves de asa fixa. A AIS também pode oferecer suporte para integração com TAK, arquiteturas de sensores distribuídos, fluxos de trabalho de sensoriamento RF e geolocalização, capacidades de guerra eletrônica personalizadas, treinamento de operadores e sustentação de sistemas de longo prazo.
Seja seu objetivo pesquisa, educação, prototipagem, implantação operacional ou integração em uma arquitetura de sistema-de-sistemas maior, a AIS pode ajudar a acelerar o desenvolvimento e a implantação, preservando a flexibilidade do framework FISSURE subjacente.
GPL-3.0
Para detalhes da licença, consulte o arquivo LICENSE.
Junte-se ao Servidor Discord: https://discord.gg/JZDs5sgxcG
Siga no Twitter/X: @FissureRF, @AinfoSec
Siga no Bluesky: @fissurerf.bsky.social
Conecte-se no LinkedIn: FISSURE - The RF Framework
Chris Poore - Assured Information Security, Inc. - [email protected]
Desenvolvimento de Negócios - Assured Information Security, Inc. - [email protected]
“O FISSURE é uma plataforma de software RF poderosa e versátil, adequada tanto para educação quanto para aplicações práticas. Ele suporta uma ampla gama de hardwares comumente usados e oferece ferramentas intuitivas de análise de dados IQ. Esses recursos nos permitem visualizar, interpretar e modificar diretamente as mensagens de sinais RF em nosso projeto.”
– Dylan R.
“Nós realmente gostamos de usar o FISSURE em nosso projeto de engenharia. Este software é uma coleção incrivelmente abrangente de ferramentas para manipular radiofrequências e foi uma ajuda fantástica para nossos estudos envolvendo comunicações sem fio.”
– Equipe de Projeto de Final de Curso
Agradecimentos especiais ao Dr. Samuel Mantravadi e a Joseph Reith por suas contribuições a este projeto.
Veja nossos outros projetos de código aberto em: https://ainfosec.dev/
Gosta de trabalhar com sinais, engenharia reversa ou outras áreas da segurança cibernética? Navegue por nossas vagas atuais ou junte-se à nossa comunidade de talentos para consideração futura.
Se você tem interesse em hacking, confira nosso desafio Can You Hack It?® e teste suas habilidades! Envie sua pontuação para nos mostrar o que você sabe fazer. A AIS tem presença nacional com escritórios e funcionários remotos em todos os EUA. Oferecemos salários competitivos e benefícios excelentes. Junte-se a uma equipe que está comprometida não apenas com o futuro do ciberespaço, mas também com o sucesso de seus funcionários.
 |  |  |  |
 |  |  |  |
 |  |  |  |
 |  |  |  |
| Sistema Operacional | Ramo do FISSURE | Versão Padrão do GNU Radio |
|---|
| DragonOS Noble (24.04) | Python3 | maint-3.10 |
| Kali | Python3 | maint-3.10 |
| Raspberry Pi OS | Python3 | maint-3.10 |
| Ubuntu 18.04 | Python2_maint-3.7 | maint-3.7 |
| Ubuntu 20.04 | Python3 | maint-3.8 |
| Ubuntu 22.04 | Python3 | maint-3.10 |
| Ubuntu 22.04 | Python3 | maint-3.10 |
| Ubuntu 24.04 / Ubuntu ARM (Orange Pi) / Ubuntu for Raspberry Pi | Python3 | maint-3.10 |
| Windows 11 WSL2 | Veja a Versão Linux Suportada | Veja a Versão Linux Suportada |
| Ramo FISSURE |
|---|
| Versão Padrão do GNU Radio |
|---|
| BackBox Linux | Python3 | maint-3.10 |
| KDE neon | Python3 | maint-3.10 |
| Parrot Security 6.1 | Python3 | maint-3.10 |