Zum Inhalt

Domains & DNS

Übersicht

Die Polycrate API unterstützt die zentrale Verwaltung von Domain-Namen und DNS-Zonen. Domains werden auf Business-Ebene verwaltet; die technische DNS-Auflösung erfolgt über einen PowerDNS-Service.

graph LR
    Domain[Domain<br/>Business-Ebene] -->|optional verknüpft| DNSZone[DNSZone<br/>PowerDNS]
    DNSZone --> DNSRecord[DNS Records<br/>A, AAAA, CNAME, TXT, etc.]
    Domain --> Registrar[Domain Registrar<br/>CentralNic]
Konzept Beschreibung
Domain Domain-Name, den die Organisation besitzt oder verwaltet (z. B. example.com)
DNSZone Technische DNS-Zone in PowerDNS – kann einer Domain zugeordnet sein
DNSRecord Einzelne DNS-Einträge (A, AAAA, CNAME, TXT, NS, SOA) innerhalb einer Zone

Domain-Registrare

CentralNic (RRPProxy)

CentralNic ist der erste unterstützte Domain-Registrar. Domains können über die Polycrate API registriert und verwaltet werden:

  • Registrierung: Neue Domains direkt anlegen
  • Portfolio-Import: Bestehende Domains aus dem Registrar-Konto importieren
  • Status & Verwaltung: Ablaufdatum, Nameserver, Kontakte einsehen und bearbeiten

Weitere Registrar-Anbindungen

Weitere Domain-Registrare sind in Arbeit und werden schrittweise ergänzt.

Die Konfiguration des Domain-Registrars erfolgt über Administration → Domain Registrar bzw. System Config → Integration.

PowerDNS-Integration

Die Polycrate API nutzt PowerDNS für die technische DNS-Auflösung. Änderungen an Zonen und Records werden synchron an PowerDNS übermittelt.

Voraussetzung: PowerDNS-Bereitstellung

PowerDNS muss separat bereitgestellt werden

PowerDNS wird nicht von der Polycrate API mitgeliefert. Der DNS-Service muss über einen Polycrate Block oder eine andere Infrastruktur-Komponente bereitgestellt werden.

Die Polycrate API verbindet sich mit einem konfigurierten PowerDNS-Endpoint und überträgt alle Zone- und Record-Änderungen dorthin.

Funktionsumfang

  • DNS-Zonen anlegen, bearbeiten und löschen
  • DNS-Records in Zonen verwalten (A, AAAA, CNAME, TXT, NS, SOA und weitere Typen)
  • Synchroner Ablauf: Änderungen werden sofort an PowerDNS geschrieben – keine Wartezeit oder Reconciliation

Nutzung für Administratoren

  1. PowerDNS über einen Block bereitstellen (z. B. im gleichen Kubernetes-Cluster wie die API)
  2. System Config konfigurieren: PowerDNS-Endpoint und API-Schlüssel hinterlegen
  3. DNS-Zonen in der Web-UI unter Networking → DNS-Zonen anlegen
  4. Domains mit Zonen verknüpfen (optional) – eine Domain kann auf eine DNSZone zeigen

Wo finden Sie was?

Aufgabe Ort in der Web-UI
Domains verwalten Networking → Domains
DNS-Zonen verwalten Networking → DNS-Zonen
Records in einer Zone bearbeiten Zone öffnen → Records-Sektion
Domain-Registrar konfigurieren Administration → Domain Registrar
PowerDNS-Verbindung konfigurieren System Config → Integration

Siehe auch