MarkMonitor

MarkMonitor provides domain management, security, and consulting.

Use Cases the Adapter Solves

• Domain Security and Compliance Monitoring: Track and manage domain health, expiration dates, renewal status, and SSL certificate information to ensure compliance with security policies and prevent service disruptions.
• Consolidated Domain and DNS Management: Collect domain registration details, DNS zone information, and user contact profiles from MarkMonitor to correlate with assets across your organization.

Asset Types Fetched

This adapter fetches the following types of assets:

• Devices, Users, Domains & URLs

• 
  

  Data Retrieved through the Adapter

  Devices (Domains) - Fields such as Domain Name, Domain ID, Status, Renewal Status

  Users (Contacts) - Fields such as Phone, Fax, Country Code, Organization

  URLs - Fields such as Domain ID, Extension, Nameservers, Registrant ID, Registrant Profile Name

  Before You Begin

  Required Ports

  • TCP port 80 (HTTP)
  • TCP port 443 (HTTPS)

  Authentication Methods

  The MarkMonitor adapter supports the following authentication methods:

  • User Name and Password - Basic credentials for a user account with permissions to fetch assets via the MarkMonitor RestAPI v2 endpoint.
  • API Key (Optional) - An API Key associated with a user account that can be used to connect to the newer MarkMonitor V2 API at api.markmonitor.com/domains/v2 instead of the standard RestAPI endpoint.

  APIs

  Axonius uses the MarkMonitor RestAPI v2 and optionally the MarkMonitor V2 API. The following endpoints are called:

  • POST /login
  • GET /domains
  • GET /domains/{domainId}
  • GET /contacts
  • GET /contacts/{contactId}
  • POST /auth/v1/auth/authenticate
  • GET /auth/v1/auth/refresh
  • GET /dns/v1/zone
  • GET /certs/v1/order

  Required Permissions

  If using basic authentication (Username and Password), ensure the user account has read access to domains, contacts, DNS zones, and SSL certificates.

  If using the newer API Key method, the API Key enables access to the enhanced V2 API endpoints.

  Supported From Version

  Supported from Axonius version 4.7

• 
  

  Connecting the Adapter in Axonius

  Navigate to the Adapters page, search for MarkMonitor, 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 (required) - The hostname or IP address of the MarkMonitor server that Axonius can communicate with. Example: domains.markmonitor.com

2. User Name and Password (required) - The credentials for a user account that has the permissions to fetch assets.

3. API Key - An optional API Key associated with a user account that can be used to connect to the MarkMonitor V2 API at api.markmonitor.com/domains/v2 instead of the RestAPI endpoint. When provided, the adapter will use the enhanced V2 API for improved performance and access to additional features.

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

5. Fetch Users (default: true) - By default Axonius fetches user/contact records from MarkMonitor. Clear this option to skip user collection.

6. Fetch DNS Zones (default: false) - Enable this option to fetch DNS zone information from MarkMonitor and enrich domain records with DNS zone details (requires API Key).

7. Fetch SSL Certificates (default: false) - Enable this option to fetch SSL certificate order information from MarkMonitor and enrich domain records with SSL certificate details (requires API Key).

8. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

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

10. HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

11. Fetch Users (default: true) - By default Axonius fetches users. Clear this option to not fetch users.

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

📘

Note

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

APIs

Axonius uses the MarkMonitor RestAPI v2.

Required Ports

Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:

• TCP port 80
• TCP port 443

Version Matrix

This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.

Supported From Version

Supported from Axonius version 4.7