- 05 Aug 2024
- 1 Minute to read
- Print
- DarkLight
- PDF
Censys - Enrich Asset Data
- Updated on 05 Aug 2024
- 1 Minute to read
- Print
- DarkLight
- PDF
Censys - Enrich Asset Data (Enrich Device Data with Censys) enriches each of the devices that are the result of the query with additional data from Censys, such as: ports open to the world, address information (country, region, city), ASN and more.
The data enrichment is done per device based on its public IP address (IPv4) or its domain name.
For more details, see Configuring Triggers.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
General Settings
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
Required Fields
Censys domain - The Censys default domain is censys.io. You can change it, if required.
API ID and API secret - Specify the Censys API ID and API Secret. See Generating a Censys API ID and API Secret.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Generating a Censys API ID and API Secret
To generate a Censys API ID and API Secret:
1. Register for an account with Censys.
2. Log into Censys and navigate to /account/api.
3. Copy the API ID and Secret to use for the censys_api fields in the config.py file.
Additional Fields
These fields are optional.
- Is paid tier - Select if your API key is associated with a paid Censys account with a higher API quota.
- HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
For more details about other Enforcement Actions available, see Action Library.