Cbox DNS

Cbox DNS is the Laravel integration for the framework-agnostic cboxdk/dns engine. It wires that engine into the Laravel container, a config file, the console, and the validator, so DNS lookups, domain-ownership verification, DNSSEC validation, and intoDNS/MxToolbox-style diagnostics are one composer require away.

Mental model

The core cboxdk/dns package owns all DNS behaviour — the spoofing-resistant resolver, the SSRF-guarded authoritative reader, SPF/DMARC/CAA parsing, and DNSSEC chain validation. This package owns only the Laravel wiring:

• A service provider that binds Cbox\Dns\Dns (the front door) and the Cbox\Dns\Contracts\Resolver contract as container singletons, built from config/dns.php.
• A facade (Dns) proxying the front door.
• Thin Artisan commands that render the core's results.
• Validation rules for form-driven DNS checks.
• A testing trait that swaps in an in-memory fake resolver.

Sections

• Getting started — installation and first lookup.
• Usage — the facade, commands, and validation rules.
• Configuration — every config key.
• Testing — the InteractsWithDns trait and fake resolver.

Where things live

This package documents only its own Laravel integration. The DNS/DNSSEC engine, its threat model, and its security posture are documented in cboxdk/dns.