Bitcrook

Централизуйте и ускорьте OSINT-расследования
Посмотреть дорожную карту

Содержание

• Информация
  • Описание
  • Отказ от ответственности
  • История изменений
  • Превью
  • Благодарности
• Использование
  • Установка
  • CLI
  • GUI
  • Docker
  • Аутентификация

Информация

Описание

Bitcrook — это инструмент разведки по открытым источникам (OSINT), предназначенный для централизации всех средств, необходимых для проведения расследования. Хотя для соединения фактов всё равно потребуется участие человека, интерфейс можно адаптировать под индивидуальные нужды, чтобы ускорить процесс сбора информации. Некоторые пакеты требуют ключ аутентификации, другие — нет. Подробнее см. в таблицах Типы пакетов. Bitcrook может быть интегрирован в ваше приложение или использоваться непосредственно из терминала/веб-браузера.

Отказ от ответственности

Конечный пользователь несёт ответственность за соблюдение всех применимых местных, государственных и федеральных законов. Разработчики не несут ответственности за любое неправомерное использование или ущерб, причинённый данной программой. Используя Bitcrook, вы соглашаетесь с вышеизложенными условиями.

История изменений

Bitcrook v2.0.0 был выпущен 11 октября 2023 года, всего через день после v1.0.0, из-за значительных изменений в структуре проекта. Ниже приведены основные изменения в релизах v1.0.0 и v2.0.0:

• Переход веб-фреймворка с Fiber на Go (сделал Bitcrook более лёгким)
• Полное перепроектирование CLI и GUI
• Правильная реализация Docker
• Бинарный релиз для поддержки go install
• Переход конфигурации секретов с .json на .env, см. Аутентификация
• Поддержка API-ключей в веб-приложении
• Исправлена ошибка CORS при доступе к веб-приложению через локальную сеть
• Команда проверки имени пользователя теперь отображает только действительные результаты
• Добавлена проверка утечек через HaveIBeenPwned для команд поиска email и домена
• Добавлена проверка существования аккаунта для email (Wordpress, Gravatar, Twitter и Pinterest пока)
• Добавлен поиск по телефону и email в веб-приложении
• Повторная реализация поиска Case.Law (запись)
• Пакеты теперь сгруппированы по типу поля, а не по типу аутентификации
• Исправлены тесты и часть документации
• Исправления ошибок и общие оптимизации

Превью

Благодарности

• Социальная превью-картинка создана с помощью Canva.
• Форматирование вывода CLI вдохновлено Echo.

Использование

Установка

• Клонируйте репозиторий через 'git clone': git clone https://github.com/ax-i-om/bitcrook.git

или

• Установите через 'go install': go install github.com/ax-i-om/bitcrook@latest

CLI

1. Перейдите в корневую директорию Bitcrook с помощью cd
2. В предпочитаемом терминале введите и выполните: go run main.go
3. После выполнения указанной команды будут установлены все зависимости, а в консоль будет выведена справка по использованию.

GUI

1. Перейдите в корневую директорию Bitcrook с помощью cd
2. В предпочитаемом терминале введите и выполните: go run main.go server
3. В предпочитаемом веб-браузере перейдите по адресу http://127.0.0.1:6174

Docker

Вы также можете разместить веб-приложение Bitcrook через Docker:

1. Перейдите в корневую директорию Bitcrook с помощью cd
2. Соберите Docker-образ: docker build -t bitcrook .
3. Запустите Bitcrook через Docker: docker run --restart always --env-file .env --name bitcrook -d -p 6174:6174 bitcrook
4. Откройте интерфейс по адресу http://127.0.0.1:6174

Аутентификация

Некоторые пакеты требуют API-ключ. Bitcrook будет работать и без указания API-ключей; однако, если вы хотите задействовать эти функции, создайте файл с именем .env и оформите его следующим образом:

BITCROOK_MLSA=UNSPECIFIED
BITCROOK_HIBP=UNSPECIFIED
BITCROOK_IPTL=UNSPECIFIED

Замените экземпляры UNSPECIFIED на соответствующие API-ключи.

Сверху вниз эти переменные окружения должны соответствовать API-ключам для сервисов Melissa, HaveIBeenPwned и IP2Location. Убедитесь, что переменные окружения переданы/экспортированы после внесения изменений. Для Docker добавьте --env-file .env в аргументы. В Linux выполните команду: export $(xargs <.env). Результаты могут различаться в зависимости от вашей операционной системы/оболочки.