Shodan

Version: 2.0.8

Shodan lets you search for devices that are connected to the Internet.

Connect Shodan with LogicHub

  1. Navigate to Automations > Integrations.
  2. Search for Shodan.
  3. Click Details, then the + icon. Enter the required information in the following fields.
    • Label: Enter a connection name.
    • Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.
    • Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
    • Remote Agent: Run this integration using the LogicHub Remote Agent.
    • API Key: The API key to connect to the Shodan.
  4. After you've entered all the details, click Connect.

Actions for Shodan

IP Lookup

Submit an IP to return all services that have been found on the given IP.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input NameDescriptionRequired
Column NameColumn name from parent table to lookup value for.Required

Output

A JSON object containing multiple rows of result:

  • result: Searches devices.
{
   "error": "Empty search query"
}

Lookup V2

Submit a lookup query to return all services that have been found on the given filter. Example to search by hostname use hostname:{comma separated hostname}, search by IP use {Malicious IP} or search by URL use url:{URL}

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input NameDescriptionRequired
Column NameColumn name from parent table to lookup value for.Required

Output

A JSON object containing multiple rows of result:

  • result: Json.
data":{9 items
"hostnames":[...]15 items
"services":[]0 items
"location":[...]15 items
"isps":[...]15 items
"os":[]0 items
"ports":[...]15 items
"has_error":boolfalse
"error":NULL
"ips":[...]15 items
}

Release Notes

  • v2.0.8 - Modified IP Lookup v2 to Lookup v2, to handle generic filter search while maintaining backward compatibility.
  • v2.0.0 - Updated architecture to support IO via filesystem
  • v1.1.2 - Added documentation link in the automation library.
  • v1.1.1 - New action created which returns valid json

© 2017-2021 LogicHub®. All Rights Reserved.