You cannot enable DNSSEC if you have set up Secondary DNS enabled. They will not work in conjunction. Ensure you are not currently using Secondary DNS, or disable Secondary DNS before using DNSSEC. You can read more about why here.
Table of Contents
- DNSSEC scenarios
- Managing DNSSEC
- Enabling DNSSEC
- Disabling DNSSEC
- Managing DS records
- Key rotation
- Troubleshooting DNSSEC configurations
DNSSEC provides a way to cryptographically build a chain of trust from the root name servers to authoritative name servers. Authenticating resolvers may verify this chain of trust to ensure the DNS results weren’t tampered with while in transit.
There are a variety of scenarios that DNSimple facilitates to ensure that your zone is signed. Use the scenarios below to understand how to configure your domain/zone.
Scenario: Registered & DNS-hosted at DNSimple
- Enable DNSSEC for automatic zone signing, provisioning, and key rotation.
Scenario: Registered at DNSimple, but DNS-hosted elsewhere
- Set up DNSSEC through your DNS provider.
- When you have the DNSSEC details, add them to your domain’s registrar using our DS management page.
Scenario: Registered elsewhere, but DNS-hosted at DNSimple
- Enable DNSSEC to sign your zone. This initiates automatic key rotation.
- After enabling, copy the DS record details over to your domain’s registrar.
- When the key rotates every three months, we’ll send you an email with the details, which you’ll need to supply to your domain’s registrar.
DNSSEC is applied on a per-domain basis. You can manage DNSSEC by using the DNSSEC tab on a domain’s management page.
To enable DNSSEC, click on the “Configure” link on the DNSSEC management page.
Click on the “Enable DNSSEC” button.
If your domain is registered with DNSimple and using our name servers, the zone is signed, and the DS record will be provisioned in the appropriate domain registry.
If your domain is hosted with us but registered elsewhere, you need to provide the DS record we give you once your zone is signed to your domain registrar. You also need to update your DS record with your domain registrar once every 90 days, as we automatically rotate both zone signing keys and key signing keys.
A warning message may be shown to highlight potential issues with DNSSEC enablement, such as:
- The authoritative name servers for the zone are not all returning the same DNSKEY records.
- The authoritiatve name servers for the zone are not returning DNSKEY records that match up with the DS record or zone signing data.
- The DS record has not yet been provisioned at the registrar.
The warning does not necessarily mean that any action is needed on your part, because the issues may resolve on their own after changes from enabling DNSSEC have been propagated.
If your domain is registered with another domain registrar, you should ideally remove the DS record from that registrar before removing the zone signing from DNSimple. Failure to remove the DS record within 48 hours of disabling DNSSEC will result in DNSSEC validation failures and will stop your domain from resolving with all DNSSEC-aware resolvers.
To disable DNSSEC, go to the DNSSEC tab for the domain, and find the “Disable DNSSEC” card.
Click on the “Disable DNSSEC” button to remove the zone signing and the DS record if it is present.
Note: When you click on the “Disable DNSSEC” button for a domain that is registered with another domain registrar, you will also see a reminder message to remove the DS record within 48 hours to prevent DNSSEC validation failures.
Managing DS records
Whether the TLD of the domain requires the DS records to be set up with the DS-Data interface or the KEY-Data interface, you’ll be able to manage your records. More details on how to add and remove DS records can be found in this support article.
DNSimple rotates key signing keys and zone signing keys every 90 days. Auto-rotation is mandatory. You can’t disable it.
- If your domain is registered with us and uses our authoritative name servers: we handle rotation of keys automatically.
- If your domain is NOT registered with us or DOES NOT uses our authoritative name servers: you’ll receive an email notification with the new DS record whenever key rotation starts, and you’ll need to rotate the DS records (remove the old record and add the new record) at your domain registrar within 7 days.
Failure to update the DS record at your registrar will result in downtime
If your domain isn’t registered with DNSimple, carefully consider whether you’re willing and able to rotate DS records at your registrar. DS records MUST be updated whenever DNSSEC keys are rotated in your DNSimple zone. If you don’t update your DS record when your keys change, your domain will fail to resolve through resolvers that verify DNSSEC keys, including Google’s Public DNS. This will result in failed DNS resolution for your domains.
During the key rotation, old and new keys are attached to your zone for 7 days (the duration of the key rotation period). At the end of the rotation period, our system removes the old key, leaving only the new key in place.
Automating key rotation
If your domain registrar provides an API for managing DS records, you can automate rotation for domains registered outside DNSimple. To do this, use the
dnssec.rotation_complete webhook events. You can find more information in our developer documentation.
Manual key rotation
If your registrar requires the DNSKEY or other additional details, you can view your full DNSSEC configuration. First, find the “DNSSEC Configuration” card on the DNSSEC tab of a domain’s management page.
Click on the “View Configuration” button.
CDS and CDNSKEY are two record types that can be used to automatically provision and deprovision DS records at parent name servers. The parent name server provider must support CDS and/or CDNSKEY for these records to be used to automatically provision and deprovision DS records.
CDS and CDNSKEY record types are automatically generated for all DNSimple zones signed after January 1st, 2019, and for all new DNSSEC DNSKEY records created after January 1st, 2019. CDS and CDNSKEY records are managed by DNSimple. These records are not meant to be added or removed manually.
You can find details about how CDS/CDNSKEY work in RFC 8078.
Troubleshooting DNSSEC configurations
These tools are helpful for troubleshooting DNSSEC configuration issues:
You can also contact DNSimple support with additional questions.
DS records without a corresponding DNSKEY
When a DS record is present at your domain registrar, but there’s no corresponding DNSKEY in your zone, DNSSEC-aware resolvers will fail to resolve your domain. For example, with Google Public DNS this will result in a SERVFAIL. Clients using a non-DNSSEC-aware resolver will still be able to resolve your domain.
To fix this issue, remove the DS record from your registrar. This won’t immediately fix resolution for some clients, as they’ll see the cached DS record. DS record time-to-live values are set by domain registries and may be set to values of 12 hours or more.