Skip to main content

Shodan

Visualize Shodan Organization, Alert, Host, Scan, and User changes through queries and alerts.

Installation Guide

Prerequisites​

To ingest organization and user entities, you will need an enterprise license.

Configuring Shodan​

Authentication​

Collect API key to authorize API requests.

Collect API Key​

  1. Log in to your Shodan account.
  2. Click on Account in the top-right corner.
  3. Click Show API Key.
  4. Copy the API key and store it in a safe location.

Configuring in JupiterOne​

  1. In the J1 Search homepage, navigate to the Integrations section from the top navigation bar.

  2. Search for Shodan and select it.

  3. Click the Add Instance button and configure the following:

    • Shodan API Key: Enter the API Token generated in Shodan.
    • Account Name: Assign a name to identify this Shodan instance in JupiterOne. If the Tag with Account Name option is enabled, ingested entities will include this value in tag.AccountName.
    • Description: Add a description to assist your team in identifying this integration instance.
    • Polling Interval (optional): Select a polling interval appropriate for your monitoring needs. Leave this as DISABLED for manual execution if unsure.

  4. Click Create Configuration to save the settings.

Next Steps​

Your integration instance will now run based on the configured polling interval, populating data within JupiterOne. Refer to our Instance Management Guide to learn more about managing and editing integration instances.