dns_integrations

Integrations for SecondDNS — a secondary DNS service that keeps your zones in sync via AXFR zone transfers. This repository contains hosting panel plugins and monitoring templates that automate zone registration and health checks.

---

How it works

All integrations use the same pattern: catch the panel event, call the SecondDNS API, let AXFR do the rest.

---

Hosting panels

Panel	Mechanism	Tested on
cPanel/WHM	Standardized Hooks via manage_hooks (4 events)	cPanel/WHM v82+
CyberPanel	Django signals (postWebsiteCreation, postZoneCreation)	CyberPanel 2.4.5
DirectAdmin	Custom hooks (dns_create_post, dns_delete_post)	DirectAdmin 1.699
Plesk	Event Manager (12 events, incl. rename + aliases)	Plesk Obsidian 18.0.77.2

Quick install

All installers accept --api-key=YOUR_API_KEY and are safe to run as root:

# cPanel/WHM
curl -sL https://raw.githubusercontent.com/seconddns/dns_integrations/main/hosting-panels/cpanel/install.sh \
  | bash -s -- --api-key=YOUR_API_KEY

# CyberPanel
curl -sL https://raw.githubusercontent.com/seconddns/dns_integrations/main/hosting-panels/cyberpanel/install.sh \
  | bash -s -- --api-key=YOUR_API_KEY

# DirectAdmin
curl -sL https://raw.githubusercontent.com/seconddns/dns_integrations/main/hosting-panels/directadmin/install.sh \
  | bash -s -- --api-key=YOUR_API_KEY

# Plesk
curl -sL https://raw.githubusercontent.com/seconddns/dns_integrations/main/hosting-panels/plesk/install.sh \
  | bash -s -- --api-key=YOUR_API_KEY

See the README in each directory for options, AXFR configuration, and troubleshooting.

---

Monitoring

Tool	Type	What it checks
Nagios / Icinga	Check plugin (bash)	Zone sync status, stale zones, master reachability
Zabbix	HTTP Agent template	Zone counters, triggers, graphs — no agent required

Both integrations use the SecondDNS API key. See the README in each directory for installation and configuration.

---

Requirements

• SecondDNS account and API key — get one here
• TCP port 53 open from your server to the SecondDNS secondary nameserver IP
• BIND or PowerDNS configured with allow-transfer and also-notify for the secondary IP

---

License

Dual-licensed:

• GPL-3.0 — free for open-source and personal use
• Commercial — available for commercial deployments; contact SecondDNS for details