Installing DNS connectors
Installation requirements
To install a DNS connector, the following requirements must be satisfied:
-
An SCM account and MRAO administrator permissions
-
Microsoft Windows Server 2016, 2019, or 2022 (64-bit) and local admin permissions to install the DNS connector
-
Hardware:
-
CPU — 1.4GHz 64-bit or 32-bit (minimum)
-
RAM — 2 GB (minimum)
-
-
Internet access:
-
Outbound network access to
https://cbcc.enterprise.sectigo.com
on TCP port443
-
Outbound network access to
https://dist.sectigo.com
on TCP port443
-
Outbound network access to the appropriate SCM instance on TCP port
443
:-
https://cert-manager.com
-
https://hard.cert-manager.com
-
https://eu.cert-manager.com
-
-
DNS provider requirements
In addition to the general prerequisites, there are requirements that must be met depending on which DNS provider you are using.
The following requirements must be met before using a DNS connector with Cloudflare:
-
You have an active Cloudflare account.
-
You have outbound network access to the Cloudflare API endpoint.
-
You have created a Cloudflare API token provided with at least the following permissions:
-
Zone.Zone:Read
-
Zone.DNS:Edit
For information about Cloudflare API tokens, see Create an API token.
-
Requires connector version 1.1 or later.
For instructions on updating to the latest version, see Update a DNS connector.
|
The following requirements must be met before using a DNS connector with Amazon Route 53:
-
You have an active AWS account.
-
You have outbound network access to the Amazon Route 53 API endpoint.
-
You have an IAM user provided with at least the following permissions:
-
route53:ChangeResourceRecordSets
-
route53:ListHostedZones
-
route53:GetChange
-
-
You have generated the Access Key ID and Secret Access Key for the IAM user.
For more information on Amazon Route 53, see Amazon Route 53 Developer Guide. |
Requires connector version 1.1 or later.
For instructions on updating to the latest version, see Update a DNS connector.
|
The following requirements must be met before using a DNS connector with Azure DNS:
-
You have an active Azure account.
-
You have configured DNS zones.
-
You have outbound network access to the Azure REST API endpoint.
-
You have registered an application in Azure with at least the following permission.
-
DNS Zone Contributor
-
For more information on Azure DNS, see What is Azure DNS?. |
Requires connector version 1.1 or later.
For instructions on updating to the latest version, see Update a DNS connector.
|
The following requirements must be met before using a DNS connector with GoDaddy DNS:
-
You have an active GoDaddy account with access to the DNS API.
-
You have outbound network access to the GoDaddy DNS API endpoint.
-
You have created an API Key and Secret.
For more information on GoDaddy DNS, see Getting Started with GoDaddy API. |
Requires connector version 1.1 or later.
For instructions on updating to the latest version, see Update a DNS connector.
|
The following requirements must be met before using a DNS connector with the Akamai Edge DNS:
-
You have an active Akamai account.
-
You have outbound network access to the Akamai API endpoint.
-
You have created an API client with at least the following permission.
-
DNS—Zone Record Management
withREAD-WRITE
-
For more information on Akamai Edge DNS, see Welcome to Edge DNS. |
Requires connector version 1.1 or later.
For instructions on updating to the latest version, see Update a DNS connector.
|
The following requirements must be met before using a DNS connector with DNSimple:
-
You have an active DNSimple account.
-
You have outbound network access to the DNSimple API endpoint.
-
You have generated an API access token with at least the following permission:
-
Zones:Full Access
-
For more information about DNSsimple, see DNSimple Developer Documentation. |
The following requirements must be met before using a DNS connector with OVHcloud:
-
You have an active OVHcloud account.
-
You have outbound network access to the OVHcloud API endpoint.
-
You have registered an application in OVHcloud and created a Consumer Key with permission to access all appropriate endpoints.
For information about OVHcloud APIs, see First Steps with the OVHcloud APIs. |
Add a DNS connector to SCM
-
Navigate to
and click the Add icon. -
In the Add DNS Connector dialog, provide a name to help identify the connector.
-
(Optional) Provide comments with additional details about the connector.
-
Specify the Delegation Mode based on the information in the following table.
Field Description General
When selected, the DNS connector is available for all organizations and departments.
Customized
When selected, the DNS connector is available for only the selected organizations and departments.
-
Click Next.
-
Copy the installation token for use during installation.
If your installation fails, subsequent attempts require the use of a new registration token. -
Click the Windows installation package link.
-
Click Save.
The connector should now be listed on the DNS Connectors page with a status of Pending.
Install a DNS connector
-
(Optional) If required, move the
SectigoDCS.msi
file to the DNS connector machine. -
Right-click
SectigoDCS.msi
and click Install. -
In the setup wizard, click Next.
-
Read the EULA, select I accept the terms in the License Agreement, and click Next.
-
(Optional) Specify an installation location.
If no destination folder is selected, the DNS connector and library will be installed in C:\Program Files\Sectigo Limited\SectigoDCS
. -
Click Next, and paste the connector installation token.
If needed, you can retrieve the installation token from the Edit DNS Connector dialog for your connector. -
Click Next.
-
In the Proxy Settings window, select Direct Internet connection (no proxy), or select Manual proxy configuration and enter your configuration details based on the information provided in the following table.
Field Description Address
The IP address or the DNS name of the proxy server.
Port
The listening port of the proxy server.
Username
The username used to connect to the proxy server.
Password
The password used to connect to the proxy server.
Click Test Connection to confirm your connection. -
Click Install.
-
Click Yes to allow the installation to complete on the server.
-
Click Finish.
The application’s configuration and log files are stored in C:\ProgramData\Sectigo Limited\SectigoDCS
.
The connector should now be listed on the DNS Connectors page with a status of Connected.
Once installed, the DNS connector must be configured to connect to your DNS provider. For more information, see Configure a DNS connector. |
To be notified in the event that a connector is disconnected, add the DNS Connector Disconnected notification. For more information, see Adding notifications. |
-
Open the Windows command prompt.
-
In the command line, navigate to the download location of the installation package.
-
Modify the installation command as needed.
msiexec.exe /i /q SectigoDCS.msi TOKEN= PROXY_TYPE= PROXY_ADDR= PROXY_PORT= PROXY_USER= PROXY_PASSWORD=
Unused options must be removed from the command. The command options are outlined in the following table.
Option Description /i
Initiates installation of the agent through the bootstrap application.
/q
Runs the installation in silent mode so no interaction is required.
TOKEN
The mandatory installation token.
PROXY_TYPE
Indicates whether you are using a proxy server.
-
1
(Yes) -
0
(No)
PROXY_ADDR
The hostname or IP address of your proxy server.
This option is required if you are using a proxy server.
PROXY_PORT
The port number used by your proxy server.
This option is required if you are using a proxy server.
PROXY_USER
The username for accessing the proxy server.
This option is required if your proxy server is configured to use credentials.
PROXY_PASSWORD
The password for accessing the proxy server, if configured to use credentials.
This option is required if your proxy server is configured to use credentials.
-
-
Run the modified installation command.
The application’s configuration and log files are stored in C:\ProgramData\Sectigo Limited\SectigoDCS
.
The connector should now be listed on the DNS Connectors page with a status of Connected.
Once installed, the DNS connector must be configured to connect to your DNS provider. For more information, see Configure a DNS connector. |
To be notified in the event that a connector is disconnected, add the DNS Connector Disconnected notification. For more information, see Adding notifications. |