shellbot

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #android #rust #macos #windows #awesome #cli #awesome-list #ios #mcp #open-source

(★ 25)

Slack/Microsoft Teams notification for new Empire/Meterpreter checkins

shellbot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ShellBot
ShellBot is a bot that will post a notification to Slack and/or Microsoft Teams whenever a new Empire or Meterpreter agent connection is received.
A blog post on the bot can be found here: https://www.swordshield.com/2016/11/slackshellbot

![alt text](https://raw.githubusercontent.com/Ne0nd0g/shellbot/master/images/ShellBot.PNG "ShellBot Output")

### Install
sudo pip -r requirements.txt
OR
sudo apt-get update && sudo apt-get install python-requests python-msgpack -y

### ShellBot Usage
```
usage: shellbot.py [-h] [--debug] [-v]

optional arguments:
  -h, --help  show this help message and exit
  --debug     Enable debug output to console
  -v          Enable verbose output to console
```

### ShellBot Configuration File
ShellBot uses a configuration file, shellbot.conf, that must be located in the same directory as shellbot.py.
The Metasploit RPC interface must be available to check for Meterpreter Agents.
The Empire database must be available to check for Empire Agents.

Example configuration:
```
[slack]
slackHook = https://hooks.slack.com/services/<randomstuff>
botName = ShellBot
channel = #shellbot
[teams]
teamsHook = https://outlook.office.com/webhook/<randomstuff>
[ShellBot]
sleepTime = 60
[empire]
db = /opt/Empire/data/empire.db
[msf]
msfRpcHost = 127.0.0.1
msfRpcPort = 55552
msfRpcUser = msf
msfRpcPass = SuperSecret
```

### MSFRPC
https://help.rapid7.com/metasploit/Content/api-rpc/getting-started-api.html

You'll likely want to issue `load msgrpc`
```
msf > load msgrpc
[*] MSGRPC Service:  127.0.0.1:55552
[*] MSGRPC Username: msf
[*] MSGRPC Password: JZXiLwT4
[*] Successfully loaded plugin: msgrpc
```

You can use the msfrpc dameon `msfrpcd -P BxunCyDD -U msf -a 127.0.0.1 -S -p 55552`
```
Usage: msfrpcd <options>

OPTIONS:

-P <opt>  Specify the password to access msfrpcd
    -S        Disable SSL on the RPC socket
    -U <opt>  Specify the username to access msfrpcd
    -a <opt>  Bind to this IP address
    -f        Run the daemon in the foreground
    -h        Help banner
    -n        Disable database
    -p <opt>  Bind to this port instead of 55553
    -t <opt>  Token Timeout (default 300 seconds
    -u <opt>  URI for Web server
```

## Screenshots
### Slack
Empire Agent Checkin on Slack

![alt text](https://raw.githubusercontent.com/Ne0nd0g/shellbot/master/images/Slack_Empire.PNG "Slack - Empire Agent Checkin")

Meterpreter Agent Checkin on Slack

![alt text](https://raw.githubusercontent.com/Ne0nd0g/shellbot/master/images/Slack_Meterpreter.PNG "Slack - Empire Agent Checkin")

### Microsoft Teams
Empire Agent Checkin on Microsoft Teams

![alt text](https://raw.githubusercontent.com/Ne0nd0g/shellbot/master/images/Teams_Empire.PNG "Teams - Empire Agent Checkin")

Meterpreter Agent Checkin on Microsoft Teams

![alt text](https://raw.githubusercontent.com/Ne0nd0g/shellbot/master/images/Teams_Meterpreter.PNG "Teams - Empire Agent Checkin")

shellbot

shellbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

shellbot

shellbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README