# Shodan Integration Documentation

Shodan is a Threat Intelligence (TI) integration used during investigations to improve analysis and in interactive chat to help answer questions. They are optional, but enabling more tooling integrations enhances Dropzone analysis.

The Dropzone platform integrates with [Shodan](https://www.shodan.io/), a search engine for devices on the internet. Dropzone can use it for identifying IP device characteristics such as hosting ownership, open ports, or known vulnerabilities.

## Create an API Key

Shodan requires an API key to enable.

To obtain an API key, do the following:

If you do not already have a corporate Shodan account, create one and become a member:

- Create your account at [https://account.shodan.io/register](https://account.shodan.io/register)
  - Use social login or create an account
  - Shodan will send an email to your email address - follow the instructions to activate your account
- Become a member via [https://account.shodan.io/billing/member](https://account.shodan.io/billing/member)

Next, retrieve your API key:

- Go to the [Shodan Developer Portal](https://developer.shodan.io/)

Click on "Developer" in the menu bar:

- Click on "Show API Key" located in the far top right corner

- Record the API Key shown for use later in the Dropzone UI where it is called "API key".

## Enable Shodan

To enable the Data Source integration, do the following:

- Navigate to your Dropzone AI tenant home page e.g. https:// _mycompany_.dropzone.app
- In the bottom left hand corner, click Settings > Integrations

- Click "Available"

- In the Search bar, search Shodan, then click "Configure"

- Input the API Key
- Click "Test & Save" to finish

If you have any errors, engage your Dropzone AI support representative.