Skip to main content

ECS Enterprise Self-Service: Adding a Domain from TinyDNS

User-added image How to register a new domain and perform an automatic DNS Validation in you ECS Enterprise account

Requirements:

  • Tinydns software from DjbDns
  • Linux OS with TinyDNs installed (in this example using Debian Linux version 9)
  • DNS Server has been setup and function properly

A. Registration of the new addition domain to your Entrust Certificate Portal

1. Login to your ECS Enterprise account.

2. On the dashboard click Administrator > Domain Management .

User-added image

3. Type your new domain name, then select the Client. After that select the verification method to DNS . Click Add to Request button.

4. Click Submit Request button on the corner of the bottom screen.

5. You will see your new domain request has been listed on the Pending domains list. Go to your new addition domain and click on the icon next to Install token to generate your DNS code.

You should see the random value for your DNS Server like the example below.

NOTE: The DNS Entry name and Random value are different from one request to another. Please DO NOT copy the codes or domain example below to your DNS Server.

User-added image

B. Step by step to add a TXT record into the active DNS zone on TinyDNS

1. Login to your DNS server using your login credentials.

2. Launch the terminal. Login as superuser type:

$ su –

You will be prompted for the password for your superuser. Type the password and you will be on the root prompt.

3. Locate your DNS zone data file. This file by default is located under /service/tinydns/root . The default zone data filename is data.

Example:

User-added image

4. WARNING! Before you continue on the step below, please make sure you make a copy of your working data zone file in order to avoid any mistakes or should you accidentally delete the file.

Edit the zone file using the line text editor tool such as nano or vi.

Example:

#root: nano /service/tinydns/root/data

Or if you have are inside the service/tinydns/root/ directory, just type the command:

Nano data

User-added image

The DNS zone data file will be opened. You should see some entries already exist.

User-added image

5. Go to the last entry and hit the Enter button on your keyboard to begin a new empty line.

User-added image

Create your TXT record using the Install DNS token information from Section A above.

NOTE: PLEASE DO NOT enter the token information from the sample below, you MUST use the one that issued to you from the steps on section A above.

Example, Install DNS Token information:

User-added image

Format:

‘_pki-validation.yourdomain:”your random value”:86400

User-added image

6. Press Ctrl-X to save the modification. Answer Yes and then hit Enter to overwrite it into the same filename.

User-added image

User-added image

7. Type the command below to re-compile your zone data.

NOTE: Before you run the make command, please make sure you are inside the directory where your data zone file located. In this example:  /service/tinydns/root.

make

User-added image

Your TXT record has been added.

At this point you have registered your domain with automatic DNS validation. As soon as your random value has propagated, the Entrust Datacard verification system will automatically capture and approve the domain for use. Note the time this will take will vary, depending on the propagation time of your DNS server.

If you have any questions or concerns please contact the Entrust Certificate Services Support department for further assistance:

Hours of Operation:
Sunday 8:00 PM ET to Friday 8:00 PM ET
North America (toll free): 1-866-267-9297
Outside North America: 1-613-270-2680 (or see the list below)
NOTE: Smart Phone users may use 1-800 numbers for one-touch dialing.
Otherwise, it is very important that international callers dial the UITF format exactly as indicated. Do not dial an extra "1" before the "800" or your call will not be accepted as an UITF toll free call.

Country Number
Australia 0011 - 800-3687-7863
1-800-767-513
Austria 00 - 800-3687-7863
Belgium 00 - 800-3687-7863
Denmark 00 - 800-3687-7863
Finland 990 - 800-3687-7863 (Telecom Finland)
00 - 800-3687-7863 (Finnet)
France 00 - 800-3687-7863
Germany 00 - 800-3687-7863
Hong Kong 001 - 800-3687-7863 (Voice)
002 - 800-3687-7863 (Fax)
Ireland 00 - 800-3687-7863
Israel 014 - 800-3687-7863
Italy 00 - 800-3687-7863
Japan 001 - 800-3687-7863 (KDD)
004 - 800-3687-7863 (ITJ)
0061 - 800-3687-7863 (IDC)
Korea 001 - 800-3687-7863 (Korea Telecom)
002 - 800-3687-7863 (Dacom)
Malaysia 00 - 800-3687-7863
Netherlands 00 - 800-3687-7863
New Zealand 00 - 800-3687-7863
0800-4413101
Norway 00 - 800-3687-7863
Singapore 001 - 800-3687-7863
Spain 00 - 800-3687-7863
Sweden 00 - 800-3687-7863 (Telia)
00 - 800-3687-7863 (Tele2)
Switzerland 00 - 800-3687-7863
Taiwan 00 - 800-3687-7863
United Kingdom 00 - 800-3687-7863
0800 121 6078
+44 (0) 118 953 3088