Bitcrook

Centralisez et accélérez les enquêtes OSINT
Voir la feuille de route

Table des matières

• Informations
  • À propos
  • Avertissement
  • Journal des modifications
  • Aperçu
  • Attributions
• Utilisation
  • Installation
  • CLI
  • GUI
  • Docker
  • Authentification

Informations

À propos

Bitcrook est un appareil de renseignement open source qui vise à centraliser tous les outils nécessaires pour mener une enquête. Bien que les enquêtes nécessitent toujours une interaction humaine pour relier les points, l'interface peut être adaptée aux besoins individuels afin d'accélérer le processus de diligence raisonnable. Certains paquets nécessitent une clé d'authentification et d'autres non. Consultez le tableau Types de paquets pour plus d'informations. Bitcrook peut être intégré dans votre application OU être utilisé directement depuis le terminal/navigateur web.

Avertissement

Il est de la responsabilité de l'utilisateur final de respecter toutes les lois locales, étatiques et fédérales applicables. Les développeurs déclinent toute responsabilité et ne sont pas responsables des mauvais usages ou dommages causés par ce programme. En utilisant Bitcrook, vous acceptez les déclarations précédentes.

Journal des modifications

Bitcrook v2.0.0 a été publié le 11 octobre 2023, un jour seulement après la v1.0.0 en raison de modifications importantes de la structure du projet. Voici quelques points saillants des changements récents dans les versions v1.0.0 et v2.0.0 :

• Passage du framework web de Fiber à Go (a permis à Bitcrook d'être plus léger)
• Refonte complète de l'interface CLI et GUI
• Implémentation correcte de Docker
• Publication binaire pour supporter go install
• Passage de la configuration secrète de .json à .env, voir Authentification
• Prise en charge des clés API dans l'application web
• Correction de l'erreur CORS lors de l'accès à l'application web via le réseau local
• La commande de recherche de nom d'utilisateur n'affiche désormais que les résultats valides
• Ajout de la vérification de fuite HaveIBeenPwned aux commandes de recherche d'email et de domaine
• Ajout de la vérification d'existence de compte pour les emails (Wordpress, Gravatar, Twitter et Pinterest pour l'instant)
• Ajout de la recherche par téléphone et email à l'application web
• Réimplémentation de la recherche Case.Law (enregistrement)
• Les paquets sont désormais regroupés par type de champ plutôt que par type d'authentification
• Correction des tests et de certaines documentations
• Corrections de bugs et optimisations générales

Aperçu

Attributions

• Aperçu social créé avec Canva.
• Formatage de la sortie CLI inspiré par Echo.

Utilisation

Installation

• Récupérez le dépôt via 'git clone' : git clone https://github.com/ax-i-om/bitcrook.git

ou

• Installez via 'go install' : go install github.com/ax-i-om/bitcrook@latest

CLI

1. Accédez au répertoire racine de Bitcrook via cd
2. Dans votre terminal préféré, saisissez et exécutez : go run main.go
3. Après avoir exécuté la commande mentionnée, toutes les dépendances seront installées et l'aide d'utilisation sera affichée dans la console.

GUI

1. Accédez au répertoire racine de Bitcrook via cd
2. Dans votre terminal préféré, saisissez et exécutez : go run main.go server
3. Dans votre navigateur web préféré, accédez à http://127.0.0.1:6174

Docker

Vous pouvez également héberger l'application web Bitcrook via Docker :

1. Accédez au répertoire racine de Bitcrook via cd
2. Construisez l'image Docker : docker build -t bitcrook .
3. Exécutez Bitcrook via Docker : docker run --restart always --env-file .env --name bitcrook -d -p 6174:6174 bitcrook
4. Accédez à l'interface via http://127.0.0.1:6174

Authentification

Certains paquets nécessitent une clé API. Bitcrook fonctionnera sans spécifier de clés API ; cependant, si vous souhaitez implémenter ces fonctionnalités, créez un fichier nommé .env et formatez-le comme suit :

BITCROOK_MLSA=UNSPECIFIED
BITCROOK_HIBP=UNSPECIFIED
BITCROOK_IPTL=UNSPECIFIED

Remplacez les occurrences de UNSPECIFIED par la clé API correspondante.

De haut en bas, ces variables d'environnement doivent correspondre aux clés API des services Melissa, HaveIBeenPwned et IP2Location. Assurez-vous que les variables d'environnement sont transmises/exportées après avoir effectué les modifications. Pour Docker, ajoutez --env-file .env aux arguments. Sous Linux, exécutez la commande : export $(xargs <.env). Les résultats peuvent varier en fonction de votre système d'exploitation/shell.