Skip to content

DNS-01 on Azure DNS

Use a service principal limited to the DNS zone. Test connection before first issuance.

Answer first

Use a service principal limited to the DNS zone. Test connection before first issuance.

How the platform treats it

Document required RBAC roles in the integration page.

Operational checklist

Confirm the hostname or product is in the correct organization. Prefer scoped credentials. Record the audit event. Subscribe to the matching webhook. Do not enable production ACME from a guide.

Failure modes

Expect DNS propagation delay, CA rate limits, and expired tokens. The API returns stable error codes rather than HTML error pages. Retry with backoff; do not loop validate calls from a browser tab.

Related inventory

After a successful change, inspect certificates, orders, deployments and billing documents. Unexpected Certificate Transparency entries are observations, not compromise claims.

Sources and limits

This guide describes software behavior. It is not legal, tax or CA-policy advice. Provider capabilities are cited from official documentation and fact-checked in admin content. Fact-check date: 2026-09-19.