Zone – B2B Whitelabel

In diesem Artikel erfahren Sie:

• So funktioniert WEDOS Zone Whitelabel
• So integrieren Sie WEDOS Zone in Ihr System
• So werden Dienste abgerechnet
• Häufige Probleme
• Häufig gestellte Fragen

WEDOS Zone Whitelabel

Whitelabel ermöglicht es Ihnen, eine eigene Oberfläche und eigenes DNS zu nutzen und gleichzeitig unsere Infrastruktur für die Abwicklung des tatsächlichen Verkehrs zu verwenden. Dazu müssen Sie unsere DNS-Server als sekundäre zu Ihren autoritativen einsetzen. Eine solche Konfiguration ermöglicht es, das DNS der Domain sowohl in unserem als auch in Ihrem System zu verwalten und beide über AXFR kommunizieren zu lassen. Sie oder Ihre Nutzer verwalten weiterhin alles in Ihrem System, und die Änderungen werden entsprechend der im SOA-Eintrag gesetzten TTL übernommen.

Die allgemeinen Schritte zur Einrichtung von Whitelabel-DNS lauten derzeit:

1. Eigene NS-Namen angeben. Dies können entweder bestehende Nameserver oder völlig neue (Sub-)Domains sein, wie zum Beispiel ns1.yourdomain.tld, ns2.yourdomain.tld. Dies sind die Namen, die unsere Server als legitim erkennen, achten Sie daher darauf, eine vollständige Liste ohne Tippfehler zu senden.
2. Fügen Sie sekundäre Domains zu WEDOS DNS hinzu. Damit eine Domain die Infrastruktur von WEDOS DNS nutzen kann, muss sie im System angelegt sein. Dafür gibt es mehrere Wege, wir empfehlen den im Kapitel Integration von WEDOS Zone.
3. IP-Adressen der NS konfigurieren. Im Gegenzug für Ihre eigenen NS-Namen stellen wir Ihnen die entsprechende Anzahl an IP-Adressen bereit. Diese können geteilt, dediziert (aus dem IP-Bereich von WEDOS) oder eigen (aus Ihrem eigenen IP-Bereich) sein. Weisen Sie diese IP-Adressen den Nameserver-Domains zu und bitten Sie uns, die Konfiguration in unserem System zu validieren.
4. NS-Einträge der Domain aktualisieren. Dieser Schritt gilt nur, wenn Sie in Schritt 1 neue NS-Namen gewählt haben. Aktualisieren Sie die NS-Einträge (DNS-Server) aller betroffenen Domains auf die neuen NS-Namen.

Integration von WEDOS Zone

Bevor Sie mit der Integration von WEDOS Zone beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Sie haben ein WEDOS Guthabenkonto gemäß dieser Anleitung. Sie müssen kein Guthaben auf das Konto aufladen, es muss aber aktiv sein.
• Sie haben erlaubt AXFR-Transfers von Ihren primären DNS-Servern für den IPv4-Bereich 46.28.104.64/27.

Um das Maximum aus Ihrem WEDOS Zone-Whitelabel herauszuholen, gehen Sie wie folgt vor:

1. WEDOS API einrichten und testen
2. Automatisierte Erstellung sekundärer DNS-Zonendateien auf WEDOS NS
3. Einstellungen des DNS-Servers aktualisieren

1. Einrichtung der WEDOS API

WEDOS API, kurz WAPI, ermöglicht Ihnen, ausgewählte Teile unseres Systems aus Ihrer eigenen Anwendung zu verwalten. Um WAPI in der WEDOS Global Administration zu aktivieren und in Ihre Anwendung einzubinden, folgen Sie der Anleitung WAPI – Handbuch.

2. WEDOS DNS automatisieren

Sobald WAPI korrekt konfiguriert ist, gehen Sie weiter zur Einrichtung von dns-domain-add -Befehl, um das Anlegen von Zonendateien für sekundäres DNS auf unseren Servern zu automatisieren. Verwenden Sie die folgende JSON-Vorlage:

{
  "request": {
    "user": "your-login-email@adress.tld",
    "auth": "generated-authentication-string",
    "command": "dns-domain-add",
    "clTRID": "your-own-id",
    "data": {
      "name": "domainname.tld",
      "type": "secondary",
      "primary_ip": "authoritative.server.ipv4.address"
    }
  }
}

3. DNS-Server aktualisieren

Sobald Sie über WAPI zuverlässig sekundäre DNS-Zonendateien erstellen können, nehmen Sie bitte Kontakt mit uns auf, ⧉ um es von unserer Seite zu prüfen und weitere Anweisungen zu senden. Wir melden uns mit einer Liste neuer IP-Adressen, die Sie auf Ihren Servern konfigurieren. Wenn zum Beispiel Ihr Server ns.domain.tld verwendet die Adresse 46.28.104.67, müssen Sie sie auf eine andere IP-Adresse ändern, die wir Ihnen mitteilen.

Sobald sich die Änderungen verbreitet haben, profitiert Ihr DNS von unserem weltweiten Servernetz.

Beispiel

Hier finden Sie ein Beispiel für ein PHP-Skript, das sekundäre Zonendateien für Domains anlegt, die aus einer domains.txt Datei geladen werden.

<?php
// Set CEST timezone for timestamp verification
date_default_timezone_set('Europe/Prague'); 

// WEDOS WAPI credentials and settings
$wapiUrl = 'https://api.wedos.com/wapi/json';
$wapiLogin = 'your_wapi_login';
$wapiPassword = 'your_wapi_password';

// Function to make WAPI requests
function wapiRequest($command, $data) {
    global $wapiUrl, $wapiLogin, $wapiPassword;

    // Construct the authorization string
    $dateHour = date('H', time());
    $auth = sha1($wapiLogin . sha1($wapiPassword) . $dateHour);

    // Construct the request payload
    $payload = array(
        'request' => array(
            'user' => $wapiLogin,
            'auth' => $auth,
            'command' => $command,
            'data' => $data,
            'clTRID' => 'custom-client-identifier-' . date('YmdHis'),
        )
    );

    // Initialize cURL session
    $ch = curl_init($wapiUrl);

    // Set cURL options
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array('request' => json_encode($payload))));

    // Execute cURL session
    $response = curl_exec($ch);

    // Close cURL session
    curl_close($ch);

    return json_decode($response, true);
}

// Read domains from the TXT file
$domains = file('domains.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

// Process each domain for secondary DNS creation
foreach ($domains as $domain) {
  // Placeholder for secondary DNS settings according to WAPI documentation
  $secondaryDnsSettings = array(
    'type'        => 'secondary',
    'primary_ip'  => 'authoritative_dns_server_ip',
  );
    $response = wapiRequest('dns-domain-add', array_merge(array('name' => $domain), $secondaryDnsSettings));

    // Handle the response
    if (isset($response['response']) && $response['response']['code'] == '1000') {
        echo 'Successfully added secondary DNS for domain: ' . $domain . "\n";
    } else {
        echo 'Failed to add secondary DNS for domain: ' . $domain . '. Response: ' . json_encode($response) . "\n";
    }
}
?>

Billing

Die Fakturierung erfolgt über WEDOS Guthabenkonto in einem speziellen Modus:

• Jede Transaktion wird im System erfasst.
• Am ersten Tag jedes Monats werden die Transaktionen des Vormonats zusammengerechnet und in Rechnung gestellt.
• Die Rechnung ist am 15. des betreffenden Monats fällig.

Häufige Probleme

Zu den häufigen Problemen mit WEDOS Zone Whitelabel gehören:

• AXFR-Kommunikationsfehler

/usr/local/cpanel/bin/whmapi1 unset_nsec3_for_domains domain=domain.tld

FAQ