Mattermost - Shodan Slash command
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
files
LICENSE
README.md
mattershodan.py
requirements.txt

README.md

Shodan-mattermost

Based on this project, you will be able to create a simple Slash command to use in Mattermost (and maybe in Slack too) for Shodan.io.

Preview

Pro-tip: For a quick overview, you can spin up a Mattermost Preview instance using Docker (Link to the Hub).

docker run --name mattermost-preview -d --publish 8065:8065 mattermost/mattermost-preview

The instance is then accessible at: http://0.0.0.0:8065

Installation

As soon as your Mattermost instance is up and running, you should go to the System console and enable Custom Slack Commands.

Enabling Custom Slash commands

Then, go to Menu > Integrations > Custom Slash Command.

Creating a Custom Slash command

Fill in the information regarding your Slash command appropriately.

Filling in the information Filling in the information

Your Slash command has now been created.

Custom Slash Command created

Make sure that you copy token generated by Mattermost and edit respectively both tokens (Shodan and Mattermost ones) in mattershodan.py.

SHODAN_API_KEY = "XXXXXXXXXXXXXXXXXXXXXXXX"
MATTERMOST_TOKEN = "YYYYYYYYYYYYYYYYYYYYYYYY"

Usage

Launch your web server:

✗ python mattershodan.py
Starting matterslash server, use <Ctrl-C> to stop

And finally you can start typing your commands in the Mattermost Channel of your choice, like:

/shodan_search_host 115.203.10.170

Usage of the command

Contributing

The code has been released under MIT License. Feel free to send your Pull Requests over if you need a specific method. You can also ping me at @PaulWebSec if you need anything.

This code has highly been inspired from MatterSlash source code, available here