Censys Platform

View as Markdown

Community Platform

runZero imports assets from the Censys Platform API.

Censys Platform API

You need a Censys Platform account to use the API. Once registered, find your API credentials in the My Account section.

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

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

Configuration

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

  • In Custom Query mode, runZero runs a Censys query you specify and imports all the results. Write the query in Censys Query Language. It’s a good idea to test it in the main Censys Platform interface before you run an import task.

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

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

When you’re done editing the Censys Platform configuration, click Activate Connection. After the task runs, look for the imported assets in your inventory.

Troubleshooting

If you’re having trouble with this integration, start with the questions and answers below.

Why is the Censys Platform integration unable to connect?

  1. Check whether the Censys Platform 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 Platform 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