Censys is a leading provider of Internet intelligence and attack surface management solutions. Censys Attack Surface Management (ASM), continuously identifies and assesses an organization's public-facing assets, from internet services to cloud storage, to uncover unknown assets and identify security and compliance issues. For more information, refer to Censys’ website..
Integration Method: API
Tables: Inventory Info (5001), Detection Finding (2004), Vulnerability Finding (2002)
This integration supports the following events.
Event | Description |
---|---|
Assets | Retrieve list of devices |
Risks | Retrieve all active risk instances in the attack surface. |
This integration supports the following versions.
Censys API Version | v1.0 & v2.0 |
Note:
Censys is a continuously updated cloud-based service. As of this documentation, the latest update was on March 2025.
Prerequisites
The user should have Administrator privileges and active subscription to Censys Attack Surface Management to create API tokens to retrieve data successfully.
The user should have access to the DataBee console.
Configuration Overview
Generate an API Key after logging in to Censys console.
Add the Censys data feed integration in the DataBee console with the required API token.
DataBee Parameter
Censys Parameter
Token
API Key
Censys Configuration
To generate the API Key, follow the below steps:
Login to the Censys Console, enter your username / email ID and click Next.
Select Attack Surface Management Platform to login and click Next.
Select the Integrations tab and generate a new API Key by clicking Regenerate API Key. If there is a key already available, click the Reveal API Key button to see it. Copy and save the API Key for future use.
DataBee Configuration
Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
Search for Censys and click it as shown below.
Click on the API Ingest option for collection method.
Enter feed contact information and click Next.
In the configuration page, confirm the following:
API Base URL: This is the base URL that DataBee will interact with.
Authorization Method: Bearer Token
Token: Paste the API Key generated earlier in the Censys console.
Event types: Preselected for all the event types that integration pulls.
Click on Submit.
Troubleshooting Tips
If you’re facing invalid_client or unauthorized_client issues this might be possibly due to incorrect credentials. Ensure the token is pasted correctly. Since you cannot view the token after the 1st time, re-create the token, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.