Censys - Enrich Asset Data
  • 05 Aug 2024
  • 1 Minute to read
  • Dark
    Light
  • PDF

Censys - Enrich Asset Data

  • Dark
    Light
  • PDF

Article summary

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.

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

Note:

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

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.


Was this article helpful?