Censys - Enrich Asset Data

Prev Next

Censys - Enrich Asset Data (Enrich Device Data with Censys) enriches assets returned by the selected 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:

Required Fields

  • 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.

  • 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.
    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.
  • Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.

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.
  • Censys domain - Should be ‘censys.io' if you are using API Version 1, or 'search.censys.io’ if you are using API Version 2.

For more details about other Enforcement Actions available, see Action Library.