Pulsar

Что это?

Pulsar — это автоматизированный сетевой сканер периметра для Red Teams, пентестеров и охотников за багами. Он ориентирован на обнаружение публичных активов организации при минимальных знаниях о её инфраструктуре. Наряду с визуализацией сетевых данных, он пытается дать базовую оценку уязвимостей для поиска слабых мест инфраструктуры и их связи с другими ресурсами. Его также можно использовать как кастомный сканер уязвимостей для широких и неизведанных областей. Это программное обеспечение создавалось с учётом доступности и открытости, поэтому оно на 100% бесплатно и не требует никаких API-ключей для использования своих функций.

Чем это не является?

• Платформой управления уязвимостями
• Полноценным OSINT-фреймворком-сканером
• Инструментом, ориентированным на скорость с немедленными результатами

Проект прекращён / заархивирован

Из-за низкого интереса и отсутствия поддержки сообщества я больше не буду продолжать этот проект. Только исправления безопасности и патчи. Не стесняйтесь форкать свою версию.

Ключевые возможности

• Обнаружение поддоменов
• Обнаружение TLD
• Обнаружение облачных ресурсов
• Базовое сканирование уязвимостей
• Политики сканирования и оптимизация
• Визуализация данных
• Совместная работа и экспорт данных
• Планирование и уведомления
• REST API
• Интеграция с внешними API
• Интеграция OAUTH
• Пользовательские расширения сканера

Интегрированные проекты

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

Идеи на будущее

• CLI-клиент
• Больше интеграций с открытым исходным кодом.
• Улучшения стабильности и скорости.
• Более детальные настройки сканирования.
• Обнаружение подсетей IPv4.
• Дополнительные тесты на достоверность.
• Дополнительные элементы управления пользователя во фронтенде.
• Сбор метаданных ложных срабатываний для модели машинного обучения.

Инструкции по установке

Если вы хотите использовать внешние API, см. USAGE.md

Для использования email-уведомлений отредактируйте EMAIL_BACKEND SETTINGS в portal/portal/settings.py до установки, иначе веб-контейнер придётся пересобрать.

В случае проблем со сборкой (см. флаг сборки репозитория) используйте ветку release

Windows

Предварительные требования

1. Git-tools

• Установщик доступен здесь.

2. Docker engine и docker-compose

• Инструкции по установке Docker доступны здесь.
• Инструкции по установке docker-compose доступны здесь.

Предварительные требования будут проверены в процессе установки.

⚠️ Для пользователей Windows 10 Home: Поскольку Docker Desktop нельзя установить на Windows 10 Home, установите Hyper-V вручную; инструкции можно найти здесь

Установка

1. Клонируйте или скачайте последний репозиторий pulsar

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

3. Запустите установщик PowerShell

PS> .\install.ps1

4. Следуйте инструкциям установщика

⚠️ Убедитесь, что вы сохранили сгенерированный пароль до дальнейших шагов установки. Пароль администратора можно изменить в консоли администрирования Django по адресу /admin/.

5. Войдите в консоль pulsar по адресу https://localhost:8443/ с сгенерированными учётными данными по умолчанию

Linux

Предварительные требования

1. Git-tools Установите git из менеджера пакетов вашего дистрибутива, например,

sudo apt install git

2. Docker engine и docker-compose

• Инструкции по установке Docker доступны здесь.
• Инструкции по установке Docker-compose доступны здесь.

Предварительные требования будут проверены в процессе установки.

Установка

1. Клонируйте или скачайте последний репозиторий pulsar

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

3. Запустите установщик bash

# ./install.sh

4. Следуйте инструкциям установщика

⚠️ Убедитесь, что вы сохранили сгенерированный пароль до дальнейших шагов установки. Пароль администратора можно изменить в консоли администрирования Django по адресу /admin/.

5. Войдите в консоль pulsar по адресу https://localhost:8443/ с сгенерированными учётными данными по умолчанию

Видео-руководство

Если у вас возникли трудности с установкой Pulsar или вы хотите узнать, как установить зависимости:

Game Flexer создал руководство по установке на Linux, доступное здесь.

⚠️ Я не несу ответственности за любой из этих материалов, включая ссылки в описании.

Вклад

Есть идея или инструмент, который вы хотели бы интегрировать? Не стесняйтесь создавать pull request.

Текущие проблемы и функции можно найти в разделе projects. Выбирайте что-нибудь.

На данный момент больше всего нужна помощь с фронтендом Vue.js и оптимизацией Docker.

Если вам нравится идея

• Поставьте звёздочку и расскажите друзьям!
• Нажмите кнопку спонсора!

В случае проблем

• Не стесняйтесь создавать отчёт об ошибке.
• См. раздел устранения неполадок здесь.

В случае идей

• Не стесняйтесь создавать запрос на изменение.
• Не стесняйтесь создавать pull request.
• Отправьте мне личное сообщение.

Если вы хотите видеть проект размещённым

• Я рассматриваю запуск кампании по сбору средств.

В случае общей критики качества кода и архитектуры

• Вы не обязаны его использовать.
• Не стесняйтесь создавать pull request.

Документация

Руководство пользователя

Базовое руководство по использованию можно найти здесь.

REST API

Самоописываемое API доступно по адресу /pulsar/api/v1/.

Разработка

В настоящее время единственная доступная документация находится по адресу /admin/doc/.

Полная документация по разработке будет доступна в будущем релизе.

Архитектура

Pulsar — это PaaS на основе файла docker-compose с предустановленными требованиями. Предоставленная архитектура может быть легко масштабирована, преобразована и развёрнута в нескольких распространённых облачных средах. Сервер веб-приложения основан на таких сервисах, как Nginx, Gunicorn и Django Rest Framework.

Структура Docker-контейнера

Дополнительную информацию см. в docker-compose.yml