Skip to main content

Get intelligence on malicious Telegram channels using bot Token

Project description

Telemal

While threat hunting, you may come across a Telegram bot token embedded in an infostealer, used to transmit stolen data to a Telegram channel. By utilizing Telemal, you can efficiently gather intelligence on the malicious channel, leveraging the bot's token to uncover more information.

Installation

pip install telemal

Features

  • List channels the bot is part of (Based on messages received in the last 24 hours).
  • Get basic information on a channel.
  • List all messages on a channel.
  • Leave channel.
  • Download files.
  • Send a message.
  • Send a file.
  • Delete all messages in the last 48 hours.
  • Export all text messages.

How does it work ?

There are two angles of intelligence in this tool :

First, using the getUpdates API method, we can retrieve messages that the bot can read from the last 24 hours. From that, we can possibly find other channels the bot is in.

Then, to retrieves all messages from a channel, we use the forwardMessage API method, which is the only way (that I know of) to retrieve a message from a message_id. The tool first sends a message to retrieve the last message id. It then forwards all messages from 1 to last_message_id to the same channel. Obviously, all messages sent for recon are deleted as soon as they are sent. All messages are also sent with the disable_notification option. I will not write that it's impossible for a user to notice the messages being sent then deleted, but it's really hard.

Limitations

  • All messages sent with the protect_content option will not be retrieved.
  • The bot has to have the can_delete_messages permission, or the channel will be flooded with messages from the bot. It shouldn't be a big deal as the goal of this tool is to stop criminals' actions, but it's better to know this.

Teletracker vs Telemal example

Teletracker vs Telemal

Don't hesitate to ask for more features :)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

telemal-1.2.20.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

telemal-1.2.20-py2.py3-none-any.whl (13.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file telemal-1.2.20.tar.gz.

File metadata

  • Download URL: telemal-1.2.20.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.0

File hashes

Hashes for telemal-1.2.20.tar.gz
Algorithm Hash digest
SHA256 9619e33c0efa4ac9ceb8b4c5b7bcbacb24c3a6404d8ec47fcc76b4c19cdade90
MD5 5b37eec3b29738ed4094edaf275bcfe8
BLAKE2b-256 68ab91734516221db12546a584533583d0d3e343715330611e0abcc628a4d01a

See more details on using hashes here.

File details

Details for the file telemal-1.2.20-py2.py3-none-any.whl.

File metadata

  • Download URL: telemal-1.2.20-py2.py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.0

File hashes

Hashes for telemal-1.2.20-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 fd80c75da6d7a58fe88d34c1903d62712b7f99bc234d05cd0ad7fff351423b5d
MD5 98f959c9c2ca93d3505db58cf290132a
BLAKE2b-256 22dd03ee115d2b62781ebfaaaa1fea3af90dd110a4cbfd4b3361a89dee5663f6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page