DNSMentor

Getting started

Connect your first DNS provider

1 min read · 2 related

How do I connect a DNS provider to DNSMentor?

Go to Admin → Providers & API keys, choose your provider, paste an API credential scoped to DNS, and press Test connection. DNSMentor then discovers every zone that account holds. Connecting is a read operation — nothing is written to any zone until somebody composes a change and applies it.

Connecting a provider is the first thing to do in a new tenant, and it is the only step that needs anything from outside DNSMentor.

# Before you start

  • An API credential from your DNS provider, scoped to DNS access only.
  • Permission in DNSMentor to administer providers — the Tenant administrator role by default.

# Steps

  • Open Admin → Providers & API keys.
  • Press Add connection and choose your provider from the list.
  • Give the connection a name you will recognise later — most MSPs name it after the account rather than the provider, because they end up with several accounts at the same provider.
  • Paste the credential fields. The help text under each field says exactly where in that provider to create it.
  • Press Test connection. DNSMentor makes a read-only call and reports what the provider said, not a generic failure.
  • Press Sync. Discovery finds every zone in the account and imports the records.

Scope the credential to the zones this connection should manage where the provider allows it. Cloudflare, AWS and Google all support this. A credential that can only touch what it needs is the difference between a mistake and an incident.

# What happens to the credential

It is encrypted at rest and stripped by name from logs, exports and the audit trail. The redaction list covers the awkward cases as well as the obvious ones — a Google Cloud DNS service-account JSON contains a private key and has nothing credential-shaped in its name, so it is redacted explicitly.

Was this helpful?

Related

Still stuck?

Raise a ticket from inside the platform and your tenant, plan and recent activity come attached automatically. A client currently offline is treated as urgent on every plan.

Last updated