Cyberbro

Uma aplicação simples que extrai os seus IoCs de entradas de dados desorganizadas e verifica a sua reputação utilizando múltiplos serviços.
🌐 demo.cyberbro.net

---

---

Sobre

Inspirado em Cybergordon e IntelOwl.

Este projeto tem como objetivo fornecer uma forma simples e eficiente de verificar a reputação dos seus observáveis utilizando múltiplos serviços, sem ter de implementar uma solução complexa. Consulte a documentação em https://docs.cyberbro.net/

[!TIP] Para criar relatórios personalizados, utilize o Cyberbro com o seu LLM preferido (Claude, OpenAI gpt-5...) através do MCP (Model Context Protocol)
Consulte o Cyberbro MCP para mais informações.

Demonstração

Funcionalidades

• Entrada Fácil: Cole logs brutos ou IoCs - análise e extração automáticas.
• Verificações Multi-Serviço: Consulta de reputação para IPs, hashes, domínios, URLs e IDs de extensões do Chrome em vários serviços de threat intel.
• Relatórios Abrangentes: Pesquisa avançada, filtragem e exportação para CSV/Excel.
• Processamento Rápido: Multithreaded para maior velocidade.
• Pivoting Automatizado: Descubra domínios, URLs e IPs relacionados através de reverse DNS e RDAP / Whois.
• Informação Precisa de Domínio e Abuso: Consultas de RDAP / Whois e contactos de abuso.
• Integrações: Microsoft Defender for Endpoint, CrowdStrike, OpenCTI, Grep.App, Hudson Rock, e mais.
• Proxy e Armazenamento: Suporte de proxy e resultados armazenados em SQLite.
• Histórico e Grafos: Histórico de análises e vista de grafo experimental.
• Cache: Caching para consultas repetidas mais rápidas (ativado ao nível dos multi-engines, não em cada engine).

O Que Torna o Cyberbro Único

• Amigável para Iniciantes: Acessível para todos os níveis de experiência.
• Consulta de IDs de Extensões do Chrome: Obtenha nomes de extensões e dados de CTI a partir de IDs.
• Implementação Leve: Configuração e utilização simples.
• Extração Avançada de TLD: Deteção precisa do domínio raiz para melhores consultas.
• Recolha de Dados Pragmática: Utiliza o GitHub e o Google para encontrar IoCs negligenciados.
• Integração de Relatórios de CTI: Obtém relatórios relacionados com IoCs do IoC.One.
• Integração com EDR: Verifica observáveis contra as suas próprias ferramentas de segurança (MDE, CrowdStrike).

Começar - TL;DR

[!TIP] Se tem preguiça, precisa do Docker.
Faça um git clone ; copie .env.sample para .env ; docker compose up e depois vá a localhost:5000. Sim, é isso!

Começar

• Para começar, clone o repositório

git clone https://github.com/stanfrbd/cyberbro
cd cyberbro

Editar o ficheiro de configuração (obrigatório)

cp .env.sample .env

[!NOTE] Não tem chaves de API? Não há problema, basta copiar .env.sample para .env e deixar os valores opcionais vazios. Tenha cuidado se for utilizado um proxy.
Poderá utilizar todas as engines gratuitas!

• Preencha os valores (incluindo o proxy, se necessário) no ficheiro .env.

[!WARNING] O .env contém segredos sensíveis e nunca deve ser commitado. Para implementações em produção/equipa, utilize SOPS, Vault, ou um fluxo de trabalho equivalente de gestão de segredos.

ABUSEIPDB=token_here
ALIENVAULT=token_here
CRIMINALIP_API_KEY=token_here
CROWDSTRIKE_CLIENT_ID=client_id_here
CROWDSTRIKE_CLIENT_SECRET=client_secret_here
DFIR_IRIS_API_KEY=token_here
DFIR_IRIS_URL=https://dfir-iris.local
DFIR_IRIS_SEARCH_NOTES=false
GOOGLE_CSE_CX=cx_here
GOOGLE_CSE_KEY=key_here
GOOGLE_CSE_URL=https://www.googleapis.com/customsearch/v1
GOOGLE_SAFE_BROWSING=token_here
HISTER_TOKEN=token_here
HISTER_BASE_URL=https://hister.example.com
IPAPI=token_here
IPINFO=token_here
MDE_CLIENT_ID=client_id_here
MDE_CLIENT_SECRET=client_secret_here
MDE_TENANT_ID=tenant_here
MISP_API_KEY=token_here
MISP_URL=https://misp.local
MISP_FEEDBACK_SERVER_URL=https://misp-feedback.local
MISP_FEEDBACK_TOKEN=token_here
OPENCTI_API_KEY=token_here
OPENCTI_URL=https://demo.opencti.io
PROXY_URL=
RANSOMWARE_LIVE_API_KEY=token_here
RL_ANALYZE_API_KEY=token_here
RL_ANALYZE_URL=https://spectra_analyse_url_here
ROSTI_API_KEY=token_here
SHODAN=token_here
SPUR_US=token_here
THREATFOX=token_here
VIRUSTOTAL=token_here
WEBSCOUT=token_here

[!IMPORTANT] A partir da versão v0.13.0, o Cyberbro já não suporta secrets.json nem a página /config. Cf. discussão 165.
Se já tem um secrets.json legado, converta-o para .env com: python3 scripts/secrets_json_to_env.py

Consulte Opções avançadas de implementação na documentação.

Iniciar a aplicação

Simples e fácil - utilize docker

[!WARNING] Certifique-se de que instala o plugin compose como docker compose e não docker-compose. No Docker, a aplicação liga-se a 0.0.0.0 dentro do contentor mesmo que o seu .env local defina FLASK_HOST=127.0.0.1.

docker compose up # use -d to run in background and use --build to rebuild the image

• Vá a http://127.0.0.1:5000 e desfrute.

Não se esqueça de editar o .env antes de construir a imagem.

Consulte Opções avançadas de implementação na documentação para obter todas as opções de implementação com Docker.

O método antigo

• Clone o repositório e instale os requisitos.

Poderá querer criar um venv antes de instalar as dependências.

pip install -r requirements.txt

• Execute a aplicação com gunicorn (modo limpo).

gunicorn -c prod/gunicorn.conf.py app:app

• Execute a aplicação em modo de desenvolvimento.

python3 app.py

Capturas de Ecrã

Ver todas as capturas de ecrã