Constellix DNS

Constellix DNS is a managed authoritative DNS service that provides domain hosting, DNS record management, traffic routing, and monitoring through an API.

Use Cases the Adapter Solves

• Maintain DNS visibility: View managed DNS domains in Axonius.
• Review domain configuration: Monitor domain status, enabled state, and name servers.
• Investigate DNS records: Optionally collect DNS records and associated IP addresses for each domain.

Asset Types Fetched

• Domains & URLs

Data Retrieved through the Adapter

URLs - fields such as: Name, Status, Enabled, Name Servers

Before You Begin

Required Ports

• TCP port 443 (HTTPS)

Authentication Methods

The adapter uses API key and secret key authentication. Provide an API Key and Secret Key. The adapter signs each request with an HMAC-SHA1 signature of the current timestamp and sends it with the API key in the authorization header.

APIs

Axonius uses the Constellix DNS API. The following endpoints are called:

• GET /v4/domains - Retrieves domains.
• GET /v4/domains/{domain_id}/records - Retrieves DNS records for a domain when Fetch DNS Records is enabled.

Required Permissions

An API key with read and write permission on domains and records

Supported From Version

Supported from Axonius version 10.0.2

Connecting the Adapter in Axonius

1. Navigate to the Adapter Catalog, search for Constellix DNS, and select the adapter.
2. Click Add Connection.
3. Provide the following parameters.

Required Parameters

1. Host Name or IP Address - The Constellix DNS API base URL, including the https:// prefix. Do not add /v4 or an endpoint path. Example: https://api.dns.constellix.com
2. API Key - The API key for the Constellix DNS API.
3. Secret Key - The secret key used to sign each request.

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 value supplied in Host Name or IP Address.
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

• Fetch DNS Records - When enabled, retrieves the DNS records of every domain. This makes the DNS Records and IP Addresses fields available and makes one additional API call per domain. Disabled by default.