BunnyDNS Manager for WHMCS Print

1. What is BunnyDNS Manager?

BunnyDNS Manager is a WHMCS module that connects your billing system to Bunny.net's DNS service. It automates DNS management for your customers with full DNSSEC support and BunnyDNS's advanced features.

Key features:

• Creates and deletes DNS zones automatically
• DNSSEC with one-click activation and DS record management
• Zone records importer/exporter for easy migrations (BIND format)
• Lets customers manage their DNS records
• Works with standard DNS records: A, AAAA, CNAME, MX, TXT, SRV, NS, CAA, PTR, TLSA
• BunnyDNS proprietary records: RDR (HTTP redirect), PZ (Pull Zone), SCR (Script)
• Real-time nameserver propagation checking
• Protects nameserver records from accidental deletion
• Fully translated in 8 languages

Bunny.net API access? Get your API Key from Bunny.net → Account Settings → API Key.

2. Features

Automation

• Creates zones when domains are registered
• Links to existing zones on domain transfer
• Deletes zone associations when services are terminated (zones remain in BunnyDNS)
• Automatically configures nameservers
• DNSSEC key management with automatic DS record generation

Supported DNS Records

Standard DNS:

• A, AAAA, CNAME, MX, TXT, SRV, NS, CAA, PTR, TLSA

BunnyDNS Proprietary:

• RDR - HTTP redirects (301/302)
• PZ - Pull Zone integration
• SCR - Script records

DNSSEC Features

• One-click DNSSEC activation
• Automatic key generation and management
• Real-time DS records for registrar integration
• DNSSEC validation status display
• One-click copy DS records to clipboard

Zone Import/Export

• Import from BIND/RFC1035 format
• Export zones to BIND format
• Validation before import
• Useful for migrations and backups

Nameserver Validation

• Real-time propagation checking
• Queries public DNS resolvers (Cloudflare/Google/Quad9)
• Status indicators in admin and client interfaces
• Helps troubleshoot delegation issues

User Interface

• Admin panel for managing all zones
• Client area for customers to manage their own DNS Zones
• DNSSEC status indicators
• Nameserver propagation status
• Bulk zone synchronization
• Zone export functionality

Languages

• Client area fully translated in 8 languages
• Included: English, Dutch, French, German, Italian, Portuguese (PT), Russian, Spanish
• Easy to add more languages

WHMCS Integration

• Works as an addon module for domain management
• Integrates with domain lifecycle hooks
• Logs all actions
• Automated zone creation and deletion

Security

• Encrypts API keys in database
• CSRF token protection
• Client ownership validation
• Protected domain filtering
• Blocks direct file access
• Permission-based access control
• Protected nameserver records

3. Requirements

• WHMCS 8.9 or newer
• Bunny.net account with API access
• PHP 7.4+ with curl extension
• MySQL 5.7+
• Network access from WHMCS to Bunny.net API (HTTPS)
• Valid BunnyDNS Manager license

First time using Bunny.net? Create an account at bunny.net and get your API credentials from Account → Security → API.

4. Installation

Step 1: Upload Files

Extract the archive to your WHMCS root directory. This creates:

/modules
└─ addons
    └─ bunnydns_manager
/includes
└─ hooks
    └─ bunnydns_manager.php

Important: Don't rename folders. Maintain the exact structure.

Step 2: Activate the Addon

1. Go to Setup → Addon Modules
2. Find "BunnyDNS Manager" and click Activate
3. Click Configure
4. Enter your license key and Bunny.net API key
5. Configure default TTL and DNS resolver
6. Click Save Changes

Step 3: Set Permissions

Choose which admin groups can use the module.

Step 4: DNS Hosting Integration

BunnyDNS Manager works directly with domain registrations through automation hooks. No separate server module needed.

How It Works

• New domain registered: Creates DNS zone automatically
• Domain transferred: Associates with existing zone or creates new one
• Domain deleted: Removes zone association (zone remains in BunnyDNS)
• Service terminated: Cleans up service associations
• DNSSEC enabled: Generates keys and provides DS records instantly

5. Configuration Options

License Key

Your ArkHost license key

Bunny.net API Key

AccessKey from Bunny.net dashboard (Account → Security → API)

Default TTL

Time to live for DNS records in seconds (default: 3600, range: 120-86400)

Protected Domains

Comma-separated list of domains to hide from client management (useful for internal infrastructure)

DNS Resolver

Public DNS server for nameserver propagation checks (Cloudflare: 1.1.1.1, Google: 8.8.8.8, Quad9: 9.9.9.9)

Clear Data on Deactivation

Removes WHMCS zone associations when disabling the module (zones stay in BunnyDNS)

Access Control

Which admin groups can use this module

6. Domain Integration

BunnyDNS Manager automatically works with your existing domain products. When domains are registered, transferred, or terminated, the module handles zone creation and management automatically through WHMCS hooks.

No additional product setup required. The module integrates directly with your existing domain registration process.

Automation hooks:

• AfterRegistrarRegistration - Creates zone automatically
• AfterRegistrarTransfer - Associates with existing zone or creates new
• DomainDelete - Removes zone association
• AfterModuleTerminate - Cleans service associations

7. Daily Use

Admin Features

• View and manage all DNS zones
• Link existing BunnyDNS zones to WHMCS domains
• Create zones manually
• Delete zones from BunnyDNS
• Edit any DNS record
• Import zones from BIND format
• Export zones to text files
• Manage DNSSEC for all zones
• Bulk zone synchronization
• Real-time nameserver validation
• Protected records show a padlock icon

Customer Features

• Access DNS management from client area
• Add, edit, delete DNS records for owned domains
• All standard DNS record types supported
• BunnyDNS proprietary records (RDR redirects, PZ pull zones, SCR scripts)
• Import zone records from external DNS (BIND format)
• Export zone data
• Enable/disable DNSSEC with one click
• View DS records for registrar submission
• One-click copy DS records to clipboard
• Check nameserver propagation status
• Can't modify protected nameserver records
• All features available in 8 languages

BunnyDNS Proprietary Records

• RDR (Redirect): HTTP redirects (301/302) without hosting
• PZ (Pull Zone): Integration with Bunny CDN pull zones
• SCR (Script): Script execution records

DNSSEC Management

• Enable DNSSEC: Click "Enable DNSSEC" button in admin or client area
• View Keys: Keys are generated automatically by BunnyDNS
• DS Records: Copy DS records to domain registrar
• Required fields displayed: Key Tag, Algorithm, Digest Type, Digest
• Propagation: Can take up to 48 hours after submitting to registrar

Zone Import/Export

• Import: Upload BIND/RFC1035 format zone files
• Export: Download zone data as BIND format
• Validation: Import validates records before adding
• Use cases: Migrations, backups, bulk record management

8. Best Practices

• Set reasonable TTL values (3600 is good default)
• Use protected domains feature for internal infrastructure
• Enable DNSSEC for enhanced security
• Export zones regularly for backups
• Check nameserver propagation after changes
• Use RDR records for simple redirects instead of hosting
• Verify DS records at registrar after enabling DNSSEC
• Test DNS changes with DNS resolver before updating production

9. Troubleshooting

Module won't activate

• Verify license key is correct
• Check WHMCS can reach arkhost.com for license validation
• Ensure all files uploaded correctly
• Check PHP curl extension is enabled

API connection fails

• Verify Bunny.net API key format (should be AccessKey)
• Test API key directly in Bunny.net dashboard
• Check server firewall allows outbound HTTPS to api.bunny.net
• Review WHMCS module debug log

Zones not auto-creating on registration

• Check module is active
• Test with manual zone creation first
• Review WHMCS activity log for hook errors

Client can't see DNS management

• Verify domain/service associated with zone in admin panel
• Check domain is active (not cancelled/suspended)
• Ensure client owns the domain in WHMCS
• Check domain not in protected domains list

Nameserver validation shows error

• DNS propagation takes time (up to 48 hours)
• Verify nameservers updated at registrar
• Test with different DNS resolver in module config
• Check domain isn't using registrar DNS lock

DNSSEC not working

• Verify DS records submitted to registrar
• Wait 24-48 hours for propagation
• Test with DNSSEC validators (dnsviz.net)
• Check registrar supports DNSSEC for the TLD

10. Support

Need help? Open a ticket at arkhost.com/submitticket.php

Purchase: BunnyDNS Manager for WHMCS

© ArkHost