Censys Search & Data

View as Markdown

Community Platform

runZero can import assets from the Censys Search API. For the Censys Platform API, see Censys Platform.

Censys Search API

To use the Censys Search API, register for a Censys Search account. Your API credentials are in the My Account section.

In runZero, go to the Credentials page and click Add Credential. Select Censys Search API Key as the credential type, and enter your API ID and API secret.

Then go to your asset inventory, click the Connect button, and choose Censys Search API. Select the credential you just created from the Censys Search credential dropdown.

Configuration

runZero connects to the Censys Search API in one of two modes.

  • In Custom Query mode, runZero runs a Censys search query you specify and imports all of the results. Write the query in Censys Search Language, and test it in the main Censys Search 2.0 interface before running an import task.

  • In All Assets mode, runZero assembles a list of public IP addresses from all of the assets in the selected site, then uses the API to find Censys Search information for those addresses. It imports what it finds and merges it into the matching assets.

As with a runZero scan, select a site to hold the scan data. The usual task scheduling options are available.

When you have finished editing the Censys Search configuration, click Activate Connection.

Troubleshooting

If the integration isn’t working, the questions and answers below may help.

Why is the Censys Search integration unable to connect?

  1. Check whether the Censys Search integration is returning any data.
    • Query the inventory rather than the task details to review all the data available from this integration.
    • In some cases, an integration’s configuration limits how much data reaches the runZero console.
  2. Some integrations require specific actions that are easy to overlook. If you miss a step during setup, the integration may not work correctly. Review this page and follow the steps exactly.
  3. If the Censys Search integration can’t connect, check the task log for errors. Common errors include:
    • 500: server error, unable to connect to the endpoint
    • 404: hitting an unknown endpoint on the server
    • 403: not authorized, likely a credential issue
Updated