---
title: "Censys"
slug: "censys"
updated: 2025-07-02T16:48:21Z
published: 2025-07-02T16:48:21Z
canonical: "docs.databee.buzz/censys"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt
> Use this file to discover all available pages before exploring further.

# Censys

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.](https://censys.com/platform).

**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]
> **Note:**
> 
> Censys is a continuously updated cloud-based service. As of this documentation, the latest update was on [March 2025](https://docs.censys.com/docs/asm-dashboard).

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

1. [Generate an API Key](/user-manual/docs/censys#censys-configuration) after logging in to Censys console.
2. Add the [Censys data feed](/user-manual/docs/censys#databee-configuration) 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:

1. Login to the [Censys](https://app.censys.io/api-docs) Console, enter your username / email ID and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-d381jm9e.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
2. Select **Attack Surface Management Platform** to login and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-nwgt2q6t.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
3. 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.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys1.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)

# 

## DataBee Configuration

1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-1nipnxbu.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
2. Search for **Censys** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-0tvaabju.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-s0b2nmca.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
4. Enter feed contact information and click **Next**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-ibmprgdr.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
5. In the configuration page, confirm the following:

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/censys-image-0uf9zepb.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A40Z&se=2026-10-30T12%3A30%3A40Z&sr=c&sp=r&sig=dlmc5GbIP8yQ%2B%2BRdp8QghRdEBLVPnWTkPQEpWXK6Sto%3D)
  - **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.
6. 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.

#