Zone – B2B Whitelabel

In diesem Artikel erfahren Sie:

• Wie WEDOS Zone Whitelabel funktioniert
• Integration von WEDOS Zone in Ihr System
• Wie Dienste abgerechnet werden
• Häufige Probleme
• Häufig gestellte Fragen

WEDOS Zone Whitelabel

Whitelabel ermöglicht es Ihnen, Ihre eigene Oberfläche und Ihr eigenes DNS zu nutzen und gleichzeitig unsere Infrastruktur für die Abwicklung des eigentlichen Datenverkehrs einzusetzen. Dafür müssen Sie unsere DNS-Server als sekundäre zu Ihren autoritativen verwenden. Eine solche Konfiguration ermöglicht es, das Domain-DNS sowohl in unserem als auch in Ihrem System zu verwalten und die Systeme ü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; achte also darauf, eine vollständige Liste ohne Tippfehler zu senden.
2. Fügen Sie sekundäre Domains zu WEDOS DNS hinzu. Damit jede Domain die WEDOS DNS-Infrastruktur nutzen kann, muss sie im System hinzugefügt sein. Dafür gibt es mehrere Wege; wir empfehlen den im Kapitel beschriebenen Integration von WEDOS Zone.
3. Konfigurieren Sie die NS-IP-Adressen. 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 WEDOS IP-Bereich) 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

Stellen Sie vor der Integration von WEDOS Zone sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Sie haben Folgendes eingerichtet: ein WEDOS Guthabenkonto gemäß dieser Anleitung. Sie müssen kein Guthaben auf das Konto einzahlen, 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. Erstellung sekundärer DNS-Zonendateien auf WEDOS NS automatisieren
3. Einstellungen des DNS-Servers aktualisieren

1. Einrichtung der WEDOS API

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

2. WEDOS DNS automatisieren

Sobald WAPI korrekt konfiguriert ist, fahren Sie mit der Einrichtung fort 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 zuverlässig sekundäre DNS-Zonendateien über WAPI anlegen können, kontaktieren Sie uns ⧉ um es von unserer Seite zu überprüfen und weitere Anweisungen zu senden. Wir melden uns bei Ihnen mit einer Liste neuer IP-Adressen, die Sie auf Ihren Servern konfigurieren. Wenn Ihr Server zum Beispiel ns.domain.tld verwendet die Adresse 46.28.104.67, musst du sie auf eine andere IP-Adresse ändern, die wir dir mitteilen.

Sobald die Änderungen propagiert sind, profitiert Ihr DNS von unserem weltweiten Servernetz.

Beispiel

Hier ein Beispiel-PHP-Skript zum Anlegen sekundärer Zonendateien für Domains, geladen aus einerdomains.txtDatei.

<?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";
    }
}
?>

Abrechnung

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

• Jede Transaktion wird im System erfasst.
• Am 1. Tag jedes Monats werden die Transaktionen des Vormonats zusammengefasst und abgerechnet.
• 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