
Uma plataforma moderna para investigações visuais, flexíveis e extensíveis baseadas em grafos. Para analistas e investigadores de cibersegurança.
# Flowsint
[](./LICENSE)
[](./ETHICS.md)
[](https://www.buymeacoffee.com/dextmorgn)
[](https://ko-fi.com/P5P01W3GPJ)
[](https://discord.gg/aST9HMQr)
O Flowsint é uma ferramenta de exploração de grafos OSINT de código aberto, projetada para investigação ética, transparência e verificação.
**Ética:** Leia [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md) para diretrizes de uso responsável.
<img width="1439" height="899" alt="hero-dark" src="https://assets.kitploit.com/production/public/readmes/686/f5a57590ea93594ae8e116b21cd83f8f90cb1344833f7c41594f3fd02f06d61a.png" />
https://github.com/user-attachments/assets/eaabfa81-d7b3-414d-8cf7-f69b4e37bab6
https://github.com/user-attachments/assets/7457d94a-cf1d-4a97-949f-f9b1d8d92644
https://github.com/user-attachments/assets/65c3f26e-7132-4853-be45-21b8933688bd
## Contribuindo
O Flowsint ainda está em desenvolvimento inicial e definitivamente precisa da ajuda da comunidade! Sinta-se à vontade para abrir issues, propor funcionalidades, etc.
## Começando
Não quer ler? Entendido. Aqui estão suas instruções de instalação:
### Linux / macOS
#### 1. Instale os pré-requisitos
- Docker
- Make
#### 2. Execute o comando de instalação
```bash
git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod
```
### Windows
Não precisa de Make. Funciona tanto no **Command Prompt (cmd)** quanto no **PowerShell**.
#### 1. Instale os pré-requisitos
- [Docker Desktop](https://docs.docker.com/desktop/setup/install/windows-install/) (certifique-se de que esteja **em execução** antes do próximo passo)
- Git
#### 2. Clone e configure os arquivos de ambiente
```bat
git clone https://github.com/reconurge/flowsint.git
cd flowsint
copy .env.example .env
copy .env.example flowsint-api\.env
copy .env.example flowsint-core\.env
copy .env.example flowsint-app\.env
```
#### 3. Inicie
```bat
docker compose -f docker-compose.prod.yml up -d
```
Isso baixa as imagens pré-construídas do GitHub Container Registry — nenhuma compilação local é necessária.
### Primeiro login
Em seguida, acesse [http://localhost:5173/register](http://localhost:5173/register) e crie uma conta. Não há credenciais ou conta por padrão.
> ✅ Investigações de OSINT exigem um alto nível de privacidade. Tudo é armazenado na sua máquina.
### Implantação em uma rede (equipe / servidor)
A mesma configuração funciona pronta para uso em um servidor: o frontend serve a interface **e** faz proxy de todas as chamadas de API internamente, portanto nenhuma configuração extra é necessária para os clientes.
```bash
git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# Edite o .env — veja "Antes de expor a uma rede" abaixo
docker compose -f docker-compose.prod.yml up -d
```
Qualquer pessoa na rede pode então acessar o Flowsint em `http://<ip-do-servidor>:5173`.
**Antes de expor a uma rede, altere os segredos padrão no `.env`:**
- `AUTH_SECRET` — assina os tokens de autenticação. Gere um: `openssl rand -hex 32`
- `MASTER_VAULT_KEY_V1` — criptografa as chaves de API armazenadas. Gere uma: `python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"`
- `NEO4J_PASSWORD` — senha do banco de dados Neo4j.
**Também adicione o hostname/IP do seu servidor à lista de permissões do cabeçalho Host** em `flowsint-app/nginx.conf` (procure por `map $http_host $is_flowsint_host`). A lista de permissões padrão aceita apenas `localhost` / `127.0.0.1` / `[::1]`, o que protege instalações de usuário único contra DNS rebinding; implantações em LAN e públicas devem optar por incluir seu próprio hostname. Duas linhas de modelo comentadas no mesmo bloco de map mostram o formato.
Apenas a porta `5173` é exposta à rede. PostgreSQL, Redis, Neo4j e a API estão vinculados a `127.0.0.1` no servidor e são acessíveis somente através do proxy do frontend.
Para fixar uma versão específica em vez de `latest`, defina `FLOWSINT_VERSION` no `.env` (ex.: `FLOWSINT_VERSION=1.2.10`).
**HTTPS (recomendado além de uma LAN confiável):** coloque qualquer proxy reverso na frente da porta 5173. Exemplo com [Caddy](https://caddyserver.com/):
```
flowsint.example.com {
reverse_proxy 127.0.0.1:5173
}
```
Ao usar um proxy reverso na frente, também vincule a porta do aplicativo ao localhost no `docker-compose.prod.yml` (`"127.0.0.1:5173:8080"`) para que os clientes só possam acessar via HTTPS.
## O que é?
O Flowsint é uma ferramenta de investigação baseada em grafos, focada em reconhecimento e OSINT (Inteligência de Fontes Abertas). Ele permite explorar relações entre entidades por meio de uma interface visual de grafos e enriquecedores automatizados.
### Enriquecedores disponíveis
**Enriquecedores de Domínio**
- Resolução DNS Reversa - Encontra domínios apontando para um IP
- Resolução DNS - Resolve domínio para endereços IP
- Descoberta de Subdomínios - Enumera subdomínios
- Consulta WHOIS - Obtém informações de registro de domínio
- Domínio para Site - Converte domínio em entidade de site
- Domínio para Domínio Raiz - Extrai o domínio raiz
- Domínio para ASN - Encontra o ASN associado ao domínio
- Histórico de Domínio - Recupera dados históricos do domínio
**Enriquecedores de IP**
- Informações de IP - Obtém geolocalização e detalhes de rede
- IP para ASN - Encontra o ASN para um IP
**Enriquecedores de ASN**
- ASN para CIDRs - Obtém faixas de IP para um ASN
**Enriquecedores de CIDR**
- CIDR para IPs - Enumera IPs em uma faixa
**Enriquecedores de Mídias Sociais**
- Maigret - Busca de nome de usuário em plataformas sociais
**Enriquecedores de Organização**
- Organização para ASN - Encontra ASNs pertencentes à organização
- Informações de Organização - Obtém detalhes da empresa
- Organização para Domínios - Encontra domínios pertencentes à organização
**Enriquecedores de Criptomoedas**
- Carteira para Transações - Obtém histórico de transações
- Carteira para NFTs - Encontra NFTs pertencentes à carteira
**Enriquecedores de Site**
- Rastreador de Site - Rastreia e mapeia a estrutura do site
- Site para Links - Extrai todos os links
- Site para Domínio - Extrai o domínio da URL
- Site para Rastreadores Web - Identifica scripts de rastreamento
- Site para Texto - Extrai conteúdo de texto
**Enriquecedores de E-mail**
- E-mail para Gravatar - Encontra perfil do Gravatar
- E-mail para Vazamentos - Verifica bancos de dados de violações de dados
- E-mail para Domínios - Encontra domínios associados
**Enriquecedores de Telefone**
- Telefone para Vazamentos - Verifica número de telefone em violações
**Enriquecedores de Indivíduo**
- Indivíduo para Organização - Encontra afiliações organizacionais
- Indivíduo para Domínios - Encontra domínios associados à pessoa
**Enriquecedores de Integração**
- Conector N8n - Conecta a fluxos de trabalho N8n
## Estrutura do projeto
O projeto é organizado em módulos autônomos:
### Módulos principais
- **flowsint-core**: Utilitários principais, orquestrador, cofre, tarefas celery e classes base
- **flowsint-types**: Modelos Pydantic e definições de tipos
- **flowsint-enrichers**: Módulos de enriquecedores, lógica de varredura e ferramentas
- **flowsint-api**: Servidor FastAPI, rotas de API e schemas apenas
- **flowsint-app**: Aplicação frontend
### Dependências entre módulos
```
flowsint-app (frontend)
↓
flowsint-api (servidor de API)
↓
flowsint-core (orquestrador, tarefas, cofre)
↓
flowsint-enrichers (enriquecedores e ferramentas)
↓
flowsint-types (tipos)
```
## Configuração de desenvolvimento
### Pré-requisitos
- Docker
### Executar
**Linux / macOS** (requer **Make**):
```bash
make dev
```
**Windows** (cmd ou PowerShell, sem Make — crie os arquivos `.env` primeiro, veja [Começando](#windows)):
```bat
docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f
```
### Desenvolvimento
O aplicativo está acessível em [http://localhost:5173](http://localhost:5173).
## Detalhes dos módulos
### flowsint-core
Utilitários principais e classes base usadas por todos os outros módulos:
- Conexões de banco de dados (PostgreSQL, Neo4j)
- Autenticação e autorização
- Registro de logs e tratamento de eventos
- Gerenciamento de configuração
- Classes base para enriquecedores e ferramentas
- Funções utilitárias
### flowsint-types
Modelos Pydantic para todos os tipos de dados:
- Domínio, IP, ASN, CIDR
- Indivíduo, Organização, E-mail, Telefone
- Site, Perfis sociais, Credenciais
- Carteiras de criptomoedas, Transações, NFTs
- E muitos outros...
### flowsint-enrichers
Módulos de enriquecedores que processam dados:
- Enriquecedores de domínio (subdomínios, WHOIS, resolução)
- Enriquecedores de IP (geolocalização, consulta ASN)
- Enriquecedores de mídias sociais (Maigret, Sherlock)
- Enriquecedores de e-mail (violações, Gravatar)
- Enriquecedores de cripto (transações, NFTs)
- E muitos outros...
### flowsint-api
Servidor FastAPI que fornece:
- Endpoints de API REST
- Autenticação e gerenciamento de usuários
- Integração com banco de dados de grafos
- Streaming de eventos em tempo real
### flowsint-app
Aplicação frontend.
- Interface moderna e amigável
- Construída para desempenho (sem lag mesmo com milhares de nós)
## Fluxo de trabalho de desenvolvimento
1. **Adicionar novos tipos**: Adicione ao módulo `flowsint-types`
2. **Adicionar novos enriquecedores**: Adicione ao módulo `flowsint-enrichers`
3. **Adicionar novos endpoints de API**: Adicione ao módulo `flowsint-api`
4. **Adicionar novos utilitários**: Adicione ao módulo `flowsint-core`
## Testes
Cada módulo tem seu próprio conjunto de testes (incompleto):
```bash
# Testar módulo core
cd flowsint-core
uv run pytest
# Testar módulo de tipos
cd ../flowsint-types
uv run pytest
# Testar módulo de enriquecedores
cd ../flowsint-enrichers
uv run pytest
# Testar módulo de API
cd ../flowsint-api
uv run pytest
```
## Contribuindo
1. Siga a estrutura modular
2. Use [uv](https://docs.astral.sh/uv/) para gerenciamento de dependências
3. Escreva testes para novas funcionalidades
4. Atualize a documentação conforme necessário
5. Veja [CONTRIBUTING.md](https://github.com/reconurge/flowsint/blob/main/CONTRIBUTING.md) para as verificações a executar antes de commitar
---
## ⚖️ Uso Legal e Ético
**Ética:** Leia [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md) para diretrizes de uso responsável.
O Flowsint é projetado **estritamente para fins de investigação e pesquisa éticos e legais**.
Foi criado para auxiliar:
- Pesquisadores e analistas de segurança cibernética
- Jornalistas e investigadores de OSINT
- Equipes de aplicação da lei ou investigação de fraudes
- Organizações que realizam inteligência de ameaças interna ou análise de risco digital
**O Flowsint não deve ser usado para:**
- Intrusão, vigilância ou coleta de dados não autorizada
- Assédio, doxxing ou direcionamento de indivíduos
- Manipulação política, desinformação ou violação de leis de privacidade
Qualquer uso indevido deste software é estritamente proibido e vai contra os princípios éticos definidos em [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md).
## ❤️ Apoio
[](https://www.buymeacoffee.com/dextmorgn)
[](https://ko-fi.com/P5P01W3GPJ)Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.