# Censys

{% hint style="info" %}
Censys 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 AI Platform integrates with Censys to get information about IP addresses such as services that are running without performing active scans.

## Create a Personal Access Token

Censys requires a Personal Access Token (PAT) to enable. For paid accounts, you will also need your Organization ID.

To obtain a Personal Access Token, do the following:

* Log into the [Censys Platform](https://platform.censys.io/home)
* Click on the icon in the upper right hand corner
* Navigate to "API Access"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-800d632b6fd26728d62b6c7ca98718ed317d30a0%2Fcensys-api-1.png?alt=media" alt=""><figcaption><p>Navigate to API Access</p></figcaption></figure>

* Underneath Personal Access Tokens click "Create New Token"
* Provide a Token Name
* Copy the Personal Access Token immediately (you won't be able to see it again)
* For paid accounts: Your Organization ID can be found in your account settings

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-a4959cc8d331598d66daa2f2d7e18f04321a0ed6%2Fcensys-api-2.png?alt=media" alt=""><figcaption><p>Copy Personal Access Token</p></figcaption></figure>

{% hint style="warning" %}
**Important**: The old API ID/Secret authentication method is deprecated. You must use a Personal Access Token. Free accounts only need the PAT (no Organization ID required). Paid accounts need both PAT and Organization ID for full API access.
{% endhint %}

## Enable Censys

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="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b3f07f902b1402dadc7abbd8bb62f9c204547390%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-434641ec6d4e45051842f86164f485d6bd289424%2Fapp_system_integrations_available.png?alt=media" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-d80f9ee58b9d5beb55decd73631c51c650328378%2Fapp_system_integrations_available_Censys.png?alt=media" alt=""><figcaption><p>The Censys Data Tile</p></figcaption></figure>

* Input the **Personal Access Token** (required)
* Input the **Organization ID** (required for paid accounts, leave blank for free accounts)
* Click "Test & Save" to finish

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-6fa1bff4aec6302c59839fc88a1e43001ceb4140%2Fapp_system_integrations_available_censys_config.png?alt=media" alt=""><figcaption><p>The Censys Data Source Configuration</p></figcaption></figure>

{% hint style="info" %}
**Free vs Paid Accounts**:

* **Free accounts**: Only the Personal Access Token is required. Leave Organization ID blank.
* **Paid accounts**: Both Personal Access Token and Organization ID are required for full API access.
  {% endhint %}

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