Concepts

The mental model behind ScaiDNS. Read these once before you write code against the API — the rest of the documentation assumes the vocabulary defined here.

Pages in this section#

• Architecture — how the API, PowerDNS, MariaDB, and ScaiKey fit together.
• Authentication — JWTs for humans, API keys for machines.
• Zones and Records — the foundational resource model.
• Tenants and Users — the identity hierarchy sourced from ScaiKey.
• Permissions and Access — how authorization resolves at request time.
• Domain Validation — proving ownership before a zone goes live.
• DNSSEC — cryptographic signing, key lifecycle.
• Errors — the response shape and common patterns.

Where to go next#

Once you've read the concepts, head to Tutorials for task-oriented walkthroughs, or jump straight into the API Reference if you already know what you want to call.