Real-Time Monitoring and Notifications using Shodan

by Shodan 5 years ago

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

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 range (ex. 198.20.0.0/16):

shodan alert create "My Production Network" 198.20.0.0/16

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

Download Shodan results using the API 03:24

by Shodan 7 years ago

Finding the most popular services in a country 01:25

by Shodan 7 years ago

Analyzing SSL Certificate Fingerprints 01:14

by Shodan 8 years ago

Shodan Firehose 01:46

by Shodan 8 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 228746.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/228746.cast',
      document.getElementById('player'),
      { cols: 90, rows: 26 }
    );
  </script>
</body>
</html>

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

While this site doesn't offer 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 run the following command to create GIF file:

agg https://asciinema.org/a/228746 228746.gif

Or, if you already downloaded the recording file:

agg 228746.cast 228746.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.