> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/shodan.md).

# Shodan

{% hint style="info" %}
Shodan is a Threat Intelligence (TI) integration. TI Data Source integrations are 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.
{% endhint %}

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 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>
  * 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>

Next, retrieve your API key

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

<figure><img src="/files/JqtxFLSvawxCQoPet8Rr" alt=""><figcaption><p>Click on "Developer" in the menu bar</p></figcaption></figure>

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

<figure><img src="/files/CkO27B3OwdGf8mjS2dB7" alt=""><figcaption><p>Show API Key</p></figcaption></figure>

* 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

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="/files/brI7n2Ux40Tk0jTwBCVh" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

<figure><img src="/files/EYAltJa569Iof6ELVNPQ" alt=""><figcaption><p>The Shodan Data Tile</p></figcaption></figure>

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

<figure><img src="/files/UKmBrcdsyc1KzfEM9v2Y" alt=""><figcaption><p>The Shodan Data Source Configuration</p></figcaption></figure>

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