Axonius Documentation
Start typing to search…

Censys ASM

Learn about Censys ASM, its use cases, asset types fetched, setup, and connection parameters for Axonius.

Censys ASM is a tool designed to provide attack surface management by identifying and monitoring threats and exposures.

Asset Types Fetched

Devices, Software, Activities, SaaS Applications, Certificates, Application Resources

Before You Begin

Ports

  • TCP port 80/443

Authentication Method

API Key

APIs

Axonius uses the following APIs:

  • GET /v1​/assets​/hosts
  • GET /v1​/assets​/certificates
  • GET /v1​/assets​/domains
  • GET /v1​/assets​/subdomains
  • GET /v1​/logbook

For more information, see https://app.censys.io/api-docs.

Permissions

The following permissions are required:

The value supplied in API Key must be associated with credentials that have Teams API Key permissions in order to fetch assets.

Supported From Version

Supported from Axonius version 6.1

Connecting the Adapter in Axonius

Navigate to the Adapters page, search for Censys ASM, and click on the adapter tile.

Click Add Connection.

To connect the adapter in Axonius, provide the following parameters:

Required Parameters

  1. Host Name or IP Address - The hostname or IP address of the Censys ASM server.

  2. API Key - An API Key associated with a user account that has the Required Permissions to fetch assets.

Censys ASM

Optional Parameters

  1. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  2. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

  3. HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

  4. HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

📘

Note:

Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to ​Advanced Configuration for Adapters.

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.

Endpoints Config - Configure the Endpoints from which to fetch data

  1. Fetch ApplicationResources from application_resource - Select this option to fetch Application resources
  2. Fetch AuditActivities from logbook - Select this option to fetch Audit Activities.

Parser Config

Parse Host Name From Reverse DNS - Select this option to parse the hostname from the reverseDNs instead of from the forwardDNS

Updated about 8 hours ago