https://github.com/valsaven/ssh-login-telegram-notifier
Receive Telegram notifications upon SSH logins to your server
https://github.com/valsaven/ssh-login-telegram-notifier
notifications ssh telegram telegram-bot
Last synced: 3 months ago
JSON representation
Receive Telegram notifications upon SSH logins to your server
- Host: GitHub
- URL: https://github.com/valsaven/ssh-login-telegram-notifier
- Owner: valsaven
- License: mit
- Created: 2023-06-13T11:39:59.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-06-13T12:28:22.000Z (about 3 years ago)
- Last Synced: 2025-03-22T11:42:50.232Z (over 1 year ago)
- Topics: notifications, ssh, telegram, telegram-bot
- Language: Shell
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SSH Login Telegram Notifier
This script sends a Telegram notification whenever someone logs into your server via SSH.
## Requirements
- Bash
- curl
## Instructions
1. **Create a Telegram bot**: You can do this via [BotFather](https://t.me/BotFather).
2. **Create a Telegram channel**: This can be private or public, depending on your preference. This is where the alerts will be sent.
3. **Get the bot updates**: Create a URI in the following format:
```bash
https://api.telegram.org/bot*****:***-*****************/getUpdates
```
and invoke it.
4. **Add your bot to the channel**: This will allow the bot to send messages to the channel.
5. **Get the channel ID**: You can do this by visiting `https://api.telegram.org/bot*****:***-*****************/getUpdates` again. The channel ID will be listed there.
6. **Register at IPInfo**: You can do this at [ipinfo.io](https://ipinfo.io/). This will give you an API token.
7. **Update the script**: Fill in the variables in the script with your Telegram bot token, channel ID, and IPInfo token.
8. **Make the script executable**: You can do this with the following command:
```bash
chmod +x ssh_notifier.sh
```
9. **Test the script**: Run the script and check that everything works correctly.
10. **Update the SSHD PAM configuration**: Add the following line to the end of `/etc/pam.d/sshd`:
```bash
session optional pam_exec.so type=open_session seteuid /full/path/to/ssh_notifier.sh
```
This will run the script whenever someone logs into your server via SSH.
Now, try connecting to your server via SSH. You should receive a notification in your Telegram channel. Enjoy your new notification system!