Censys Platform

View as Markdown

Community Platform

runZero supports importing assets from the Censys Platform API.

Censys Platform API

To get started with the Censys Platform API, you will need to register for a Censys Platform account. Once you have done so, you can 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, and enter your API ID and API secret.

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

Configuration

There are two modes for connecting runZero to the Censys Platform API.

  • Custom Query mode - runZero runs a Censys query you specify and then imports all the results into runZero. The search query should be in Censys Query Language. It is a good idea to test your query using the main Censys Platform interface before running an import task.

  • All Assets mode - runZero assembles a list of public IP addresses from all the assets in the selected site, and then uses the API to find Censys information for those addresses. The information found is imported into runZero and merged into the appropriate assets.

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

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

Troubleshooting

If you are having trouble using this integration, the questions and answers below may assist in your troubleshooting.

Why is the Censys Platform integration unable to connect?

  1. Are you getting any data from the Censys Platform integration?
    • Make sure to query the inventory rather than look at the task details to review all the data available from this integration.
    • In some cases, integrations have a configuration set that limits the amount of data that comes into the runZero console.
  2. Some integrations require very specific actions that are easy to overlook. If a step is missed when setting up the integration, it may not work correctly. Please review this integration documentation and follow the steps exactly.
  3. If the Censys Platform integration is unable to connect be sure to check the task log for errors. Some 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