Markdown
English Deutsch

Veröffentlichen

DNS mit united-domains setzen

Einmal den united-domains-API-Key verbinden. MainPath schreibt A- und CNAME-Einträge in deine Zone.

Auf dieser Seite

Wenn deine Domain bei united-domains liegt, musst du die Einträge nicht mehr von Hand abtippen. Du hinterlegst einen API-Key unter Anbindungen; sobald ein Projekt Domains hat, schreibt MainPath die Einträge in die passende Zone.

Manuelles DNS bleibt möglich. Siehe DNS-Eintrag konfigurieren.

API-Key bei united-domains

Das ist die united-domains DNS-API (dnsapi.united-domains.de), dasselbe API-Modell wie bei IONOS Hosting DNS. Die Domain-Reselling-API und Keys aus IONOS Cloud funktionieren hier nicht.

  1. Im united-domains-Konto anmelden.
  2. Das Produkt DNS-API für das Portfolio buchen, falls es noch nicht aktiv ist.
  3. Die ersten Schritte mit den APIs öffnen und einen API-Key anlegen.
  4. Public Prefix und Secret kopieren. MainPath erwartet eine Zeile im Format prefix.secret (ein Punkt dazwischen). Die beiden Teile nicht mit Leerzeichen oder Zeilenumbruch einfügen.

Ohne gebuchte DNS-API lehnt united-domains den Key ab. Die API gilt für alle Domains im Portfolio, deren Nameserver auf united-domains zeigen (ns.udag.de, ns.udag.net, ns.udag.org).

Anbindung in MainPath

  1. Öffne Anbindungen und Anbindung hinzufügen.
  2. Wähle unter DNS die Kachel united-domains.
  3. Füge den API-Key ein und speichere. MainPath prüft, ob der Key gültig ist und welche Zonen er sieht.

Mehrere united-domains-Zugänge in einer Organisation sind möglich. Gehört eine Domain zu mehreren Zonen, nimmt MainPath die treffendste (zum Beispiel shop.example.com vor example.com).

Was gesetzt wird

MainPath übernimmt dieselben Hosts, die du unter Domains siehst.

  • Einträge werden nur gesetzt, wenn schon eine echte Server-Adresse da ist.
  • Bestehende Einträge desselben Typs werden aktualisiert, nicht die ganze Zone ersetzt.
  • Änderungen kommen schnell an.
flowchart LR
  org["united-domains-Anbindung"]
  domains["Domains in MainPath"]
  zone["united-domains-Zone"]
  server["Dein Server"]
  org --> zone
  domains -->|"A / CNAME"| zone
  zone --> server

Nach dem Speichern eines Projekts versucht MainPath, fehlende oder abweichende Einträge anzugleichen. Den Prüfstatus siehst du in der Domain-Übersicht.

SSL über DNS-01 (optional)

Erreicht Let’s Encrypt den Server nicht (kein öffentliches HTTP/443, Firewall, interne IP), öffne die Details dieser Anbindung und hake die betroffenen Domains an. MainPath schreibt dann den TXT-Eintrag _acme-challenge in diese Zone. Ohne Haken bleibt die bisherige TLS-Prüfung (ALPN) über den Server.

Fehlersuche

  • Key ungültig: Format prefix.secret prüfen (ein Punkt, keine Leerzeichen), DNS-API im Portfolio buchen und die Anbindung aktualisieren.
  • Kein Eintrag bei united-domains: Die Domain liegt in keiner Zone, die der Key sieht. Account oder Zonennamen prüfen.
  • Zone sichtbar, Domain nicht erreichbar: Die Zone existiert, aber die Nameserver der Domain zeigen woanders hin. MainPath markiert das in den Anbindungs-Details und unter Domains. Nameserver beim Registrar auf ns.udag.de, ns.udag.net und ns.udag.org umstellen.
  • Status in MainPath noch rot: DNS braucht oft ein paar Minuten, oder der Server hat noch keine bekannte Adresse.

Siehe auch