Bibliothèque de scénarios OSINT pour Telegram

Description

Il existe de nombreuses bibliothèques API Telegram, mais aucune ne montre comment exécuter des scénarios complexes comme télécharger toutes les photos des chaînes, surveiller la présence des utilisateurs ou enregistrer un nouveau compte. Ce projet vise à corriger cette situation : vous pouvez désormais créer facilement de nouveaux scénarios et exécuter ceux existants en un clic.

Utilisation de l'API Telegram à partir du client Android officiel.

Rationale

Le protocole Telegram https://core.telegram.org/ possède une documentation techniquement complète et détaillée, mais ne couvre pas les scénarios d'utilisation. Notre objectif est de créer une bibliothèque qui implémente des scénarios d'utilisation OSINT réels, notamment :

• recherche d'utilisateurs dans des groupes spécifiques ;
• analyse des membres d'un groupe ;
• surveillance du statut en ligne des utilisateurs ;
• téléchargement de photos depuis une chaîne ;
• surveillance des changements de profil utilisateur (photo/bio/etc.) ;
• récupération de messages d'un utilisateur spécifique.

Requirements

• PHP 7.4+
• Composer
  • phpseclib

Docs

• Créer un scénario

QuickStart

Tout d'abord, ajoutez la bibliothèque à votre application avec Composer :

composer require postuf/telegram-api-lib

Pour voir des exemples d'utilisation, allez dans le répertoire examples. Vous devez générer des clés d'authentification, exécutez php registration.php pour les obtenir. Maintenant, vous êtes prêt, vous pouvez exécuter n'importe lequel des exemples, par exemple php parseGroupMembers.php, et vérifier la sortie.

La journalisation détaillée (tous les messages envoyés/reçus) est activée par défaut, ajoutez --info aux arguments pour la supprimer.

Conteneur Docker

docker build -t telegram-osint-lib .
docker run -d -t --name tg-osint-lib telegram-osint-lib
docker exec -it tg-osint-lib /bin/bash
php examples/registration.php

Lorsque vous obtenez une AuthKey dans le script d'enregistrement, vous pouvez l'utiliser de la manière suivante :

docker exec  --env BOT=your-auth-key -i tg-osint-lib php examples/monitorNumbers.php -n 123123123
# si vous enregistrez la clé dans un fichier
docker exec  --env BOT=@auth-key-filename-in-docker -i tg-osint-lib php examples/monitorNumbers.php -n 123123123

Limitations

2FA non pris en charge.