censys.md
Censys
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.
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
- Click on the icon in the upper right hand corner
- Navigate to "API Access"
Navigate to API Access
- 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
Copy Personal Access Token
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.
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
Integrations Dropdown
- Click "Available"
Click Available
- In the Search bar, search Censys, then click "Configure"
The Censys Data Tile
- Input the Personal Access Token (required)
- Input the Organization ID (required for paid accounts, leave blank for free accounts)
- Click "Test & Save" to finish
The Censys Data Source Configuration
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.
If you have any errors engage your Dropzone AI support representative.