Real-Time Network Monitoring via Shodan

by Shodan 5 years ago

GNU/Linux ◆ xterm-256color ◆ bash 138217 views

How to use the Shodan command-line interface to setup real-time network monitoring for your home IP address.

A quick guide on setting up network alerts using the Shodan command-line interface. To install the CLI run:

sudo pip install shodan

And then initialize the CLI using your API key:

shodan init APIKEY

Create a network alert to monitor your network ranges (ex. 198.20.0.0/16):

shodan alert create "My Production Networks" 198.20.0.0/16 8.20.5.0/24

Get a list of notification triggers that can be enabled:

shodan alert triggers

Get notified when malware or a compromised services is discovered (replace ALERTID with the one returned by the shodan alert create command):

shodan alert enable ALERTID malware

For questions please contact support@shodan.io

More by Shodan

Shodan Firehose 01:46

by Shodan 8 years ago

Shodan On-Demand Scan 00:51

by Shodan 7 years ago

Researching SSL for a country 02:53

by Shodan 8 years ago

Real-Time Monitoring and Notifications using Shodan 02:26

by Shodan 5 years ago

See all

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 231048.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/231048.cast',
      document.getElementById('player'),
      { cols: 90, rows: 27 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/231048 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.