# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dropzone.ai/integrations/data/shodan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.