.png?sv=2022-11-02&ss=b&srt=o&spr=https&st=2024-04-26T03%3A44%3A34Z&se=2024-04-26T03%3A54%3A34Z&sp=r&sig=ttyQfEM2UjHVKa%2FGdfUdOGkI3VCQhwyAgt6K%2BNNDUBI%3D){kind=logo}
Censys - Enrich Asset Data
- 21 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
Censys - Enrich Asset Data
- Updated on 21 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
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.
NOTE
You can use the IPv4 Public Subnets devices saved query as the trigger for the enforcement set that executes the Censys - Enrich Asset Data action.
For more details, see Configuring Triggers.
For more details, see Configuring Triggers.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- 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.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- 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.
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.
Instance Name - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Settings
- Is paid tier - Select if your API key is associated with a paid Censys account with a higher API quota.
HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
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.
For more details about other Enforcement Actions available, see Action Library.
Was this article helpful?