Pulsar

O que é?

Pulsar é um scanner automatizado de footprint de rede para Red Teams, Pentesters e Caçadores de Recompensas (Bounty Hunters). Seu foco é a descoberta de ativos públicos de uma organização com conhecimento mínimo sobre sua infraestrutura. Juntamente com a visualização de dados de rede, ele tenta fornecer uma pontuação básica de vulnerabilidade para encontrar pontos fracos na infraestrutura e sua relação com outros recursos. Também pode ser usado como um scanner de vulnerabilidades personalizado para escopos amplos e desconhecidos. Este software foi criado com disponibilidade e abertura em mente, portanto é 100% gratuito e não requer nenhuma chave de API para usar seus recursos.

O que não é?

• Plataforma de Gerenciamento de Vulnerabilidades
• Scanner completo de framework OSINT
• Ferramenta orientada a velocidade com resultados imediatos

Projeto descontinuado / arquivado

Devido ao baixo interesse e falta de apoio da comunidade, não darei continuidade a este projeto. Apenas patches de segurança e correções. Sinta-se à vontade para fazer um fork.

Principais recursos

• Descoberta de subdomínios
• Descoberta de TLDs
• Descoberta de recursos na nuvem
• Varredura básica de vulnerabilidades
• Políticas de varredura e otimização
• Visualização de dados
• Colaboração e exportação de dados
• Agendamento e notificações
• API REST
• Integração com APIs externas
• Integração OAUTH
• Extensões personalizadas de scanner

Projetos integrados

• OWASP Amass
• ZMap
• Nmap
• RIPEstat API
• CloudEnum
• SSH Audit
• WhatWeb
• NVD Data Feed

Ideias futuras

• Cliente CLI
• Mais integrações open source.
• Melhorias de estabilidade e velocidade.
• Configurações de varredura mais detalhadas.
• Descoberta de sub-redes IPv4.
• Testes adicionais de confiança.
• Controles adicionais de usuário no frontend.
• Coleta de metadados de falsos positivos para modelo de machine learning.

Instruções de instalação

Se você deseja usar APIs externas, veja USAGE.md

Para usar notificações por e-mail, edite EMAIL_BACKEND SETTINGS em portal/portal/settings.py antes da instalação ou o container web precisará ser reconstruído.

Em caso de problemas de build (veja a flag de build do repositório), use o branch release

Windows

Pré-requisitos

1. Ferramentas Git

• O instalador está disponível aqui.

2. Docker engine e docker-compose

• As instruções de instalação do Docker estão disponíveis aqui.
• As instruções de instalação do docker-compose estão disponíveis aqui.

Os pré-requisitos serão verificados durante o processo de instalação.

⚠️ Para usuários do Windows 10 Home: Como o Docker Desktop não pode ser instalado no Windows 10 Home, instale o Hyper-V manualmente. As instruções podem ser encontradas aqui

Instalação

1. Clone ou baixe o repositório mais recente do pulsar

git clone https://github.com/FooBallZ/pulsar

3. Execute o instalador do PowerShell

PS> .\install.ps1

4. Siga as instruções do instalador

⚠️ Certifique-se de armazenar a senha gerada antes das próximas etapas de instalação. A senha de administrador pode ser alterada no console admin do Django em /admin/.

5. Faça login no console do pulsar em https://localhost:8443/ com as credenciais padrão geradas

Linux

Pré-requisitos

1. Ferramentas Git Instale o git pelo gerenciador de pacotes da sua distribuição, ex.:

sudo apt install git

2. Docker engine e docker-compose

• As instruções de instalação do Docker estão disponíveis aqui.
• As instruções de instalação do Docker-compose estão disponíveis aqui.

Os pré-requisitos serão verificados durante o processo de instalação.

Instalação

1. Clone ou baixe o repositório mais recente do pulsar

git clone https://github.com/FooBallZ/pulsar

3. Execute o instalador bash

# ./install.sh

4. Siga as instruções do instalador

⚠️ Certifique-se de armazenar a senha gerada antes das próximas etapas de instalação. A senha de administrador pode ser alterada no console admin do Django em /admin/.

5. Faça login no console do pulsar em https://localhost:8443/ com as credenciais padrão geradas

Guia em vídeo

Caso você tenha dificuldades para instalar o Pulsar ou esteja se perguntando como instalar as dependências:

Game Flexer criou um tutorial de instalação no Linux disponível aqui.

⚠️ Não me responsabilizo por nenhum conteúdo, incluindo links na descrição.

Contribuição

Tem uma ideia ou uma ferramenta que gostaria de integrar? Sinta-se à vontade para abrir um pull request.

Os problemas e recursos atuais podem ser encontrados na seção projects. Sinta-se à vontade para escolher algo.

Atualmente, a maior ajuda necessária é com o frontend Vue.js e a otimização do Docker.

Caso goste da ideia

• Marque com estrela e conte para seus amigos!
• Clique no botão de patrocinador!

Em caso de problemas

• Sinta-se à vontade para relatar um bug.
• Veja a seção de solução de problemas aqui.

Em caso de ideias

• Sinta-se à vontade para solicitar uma mudança.
• Sinta-se à vontade para abrir um pull request.
• Envie-me uma mensagem privada.

Caso gostaria de vê-lo hospedado

• Estou considerando lançar uma campanha de financiamento.

Em caso de críticas gerais sobre qualidade de código e arquitetura

• Você não precisa usá-lo.
• Sinta-se à vontade para abrir um pull request.

Documentação

Guia do usuário

O guia básico de uso pode ser encontrado aqui.

API REST

A API auto-descritiva está disponível no endpoint /pulsar/api/v1/.

Desenvolvimento

Atualmente, a única documentação disponível está no endpoint /admin/doc/.

A documentação completa de desenvolvimento estará disponível em uma versão futura.

Arquitetura

Pulsar é um PaaS baseado em um arquivo docker-compose com requisitos pré-instalados. A arquitetura fornecida pode ser facilmente escalada, convertida e implantada em vários ambientes comuns de nuvem. O servidor da aplicação web é baseado em serviços como Nginx, Gunicorn e Django Rest Framework.

Estrutura do container Docker

Para mais informações, veja docker-compose.yml

Legal

⚠️ Embora o Pulsar foque em fingerprinting básico de serviços, varredura de portas e captura de banners podem ser ilegais em alguns países. Certifique-se de que você está autorizado a realizar varreduras de rede no recurso alvo antes de usar esta ferramenta.