What is runZero? #
runZero Network Discovery (formerly Rumble Network Discovery) provides visibility into your external attack surface and internal networks, revealing potential vulnerabilities, insecure configurations, and other risks before they can be exploited.
Why Should You Use the runZero Connector? #
The runZero connector provides visibility into the assets in your environment. You can use this visibility to:
-
ensure assets are managed per your security policies
-
derive relationships between assets, users, applications, and data
How Does This Connector Work? #
Lucidum executes read-only requests to the runZero REST API and ingests only meta-data about runZero devices. Lucidum does not retrieve any data stored on your assets.
Configuring the Connector in Lucidum #
Field |
Description |
Example |
---|---|---|
URL |
The URL of the runZero server. Default is https://console.runzero.com |
https://console.runzero.com |
Export Token |
API key that provides read-only access to a single organization. |
**************** |
Account Key |
API key that provides read-write access to all user data. |
**************** |
Data Lookback in Days |
Number of previous days to ingest data for. Default value is 30 |
30 |
Proxy |
If you are using a proxy server to allow this connector to communicate with on-premises devices, enter the IP address: port for the proxy server, usually 192.168.255.6:3128 |
192.168.255.6:3128 |
Source Documentation #
Creating Credentials #
To retrieve data about users, generate an Account API. To do this:
-
Login to the runZero web console as an administrator.
-
Follow the steps in the section on Export API Tokens in https://help.runzero.com/docs/leveraging-the-api/#export-and-organization-apis .
To retrieve all other runZero data, generate an Export API Token. To do this:
-
Login to the runZero web console as an administrator.
-
Follow the steps in the section on Export API Tokens in https://help.runzero.com/docs/leveraging-the-api/#account-api.
API Documentation #
https://help.runzero.com/docs/leveraging-the-api/#account-api
https://app.swaggerhub.com/apis/runZero/runZero/4.0.231027.0