Zone - B2B-Whitelabel

In diesem Artikel erfahren Sie mehr:

• So funktioniert WEDOS Zone Whitelabel
• Wie Sie WEDOS Zone in Ihr System integrieren
• Wie Dienstleistungen in Rechnung gestellt werden
• Gemeinsame Probleme
• Häufig gestellte Fragen

WEDOS Zone Whitelabel

Mit Whitelabel können Sie Ihre eigene Schnittstelle und Ihr eigenes DNS verwenden und gleichzeitig unsere Infrastruktur für die Abwicklung des eigentlichen Datenverkehrs nutzen. Dies setzt voraus, dass Sie unsere DNS-Server als sekundäre zu Ihren autoritativen Servern verwenden. Auf diese Weise können Sie die Domänen-DNS sowohl in unserem als auch in Ihrem System verwalten und über AXFR kommunizieren. Sie oder Ihre Benutzer verwalten weiterhin alles in Ihrem System, und die Änderungen werden entsprechend der im SOA-Eintrag festgelegten TTL berücksichtigt.

Die allgemeinen Schritte zur Einrichtung eines Whitelabel-DNS sind derzeit folgende:

1. Geben Sie benutzerdefinierte NS-Namen an. Dabei kann es sich entweder um bestehende Nameserver oder um völlig neue (Sub-)Domains handeln, wie z. B. ns1.yourdomain.tld, ns2.yourdomain.tld. Dies sind die Namen, die unsere Server als legitim erkennen. Achten Sie also darauf, dass Sie eine vollständige Liste ohne Tippfehler senden.
2. Fügen Sie sekundäre Domänen zu WEDOS DNS hinzu. Stellen Sie sicher, dass jede Domäne, die die WEDOS DNS-Infrastruktur nutzen soll, zum System hinzugefügt wird. Es gibt mehrere Möglichkeiten, dies zu erreichen. Wir empfehlen die im Kapitel Integration der WEDOS-Zone beschriebene Methode.
3. Konfigurieren Sie NS-IP-Adressen. Im Gegenzug für Ihre benutzerdefinierten NS-Namen stellen wir Ihnen die entsprechende Anzahl von IP-Adressen zur Verfügung. Diese können gemeinsam genutzt, dediziert (aus dem WEDOS-IP-Bereich) oder benutzerdefiniert (aus Ihrem eigenen IP-Bereich) sein. Weisen Sie diese IP-Adressen den Nameserver-Domains zu und bitten Sie uns, die Einrichtung in unserem System zu validieren.
4. Aktualisieren Sie die NS-Einträge der Domäne. Dieser Schritt gilt nur, wenn Sie in Schritt 1 neue NS-Namen ausgewählt haben. Aktualisieren Sie die NS-Einträge (DNS-Server) aller betroffenen Domänen auf die neuen NS-Namen.

Integration der WEDOS-Zone

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

• Sie haben ein WEDOS-Guthabenkonto gemäß dieser Anleitung eingerichtet. Sie müssen das Konto nicht mit Guthaben aufladen, aber es muss aktiv sein.
• Sie haben erlaubt AXFR-Überweisungen 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. DNS-Server-Einstellungen aktualisieren

1. WEDOS-API-Einrichtung

Mit WEDOS API, kurz WAPI, können Sie ausgewählte Teile unseres Systems von Ihrer eigenen Anwendung aus verwalten. Um WAPI über das WEDOS Global Admin Panel zu aktivieren und in Ihre Anwendung einzubinden, folgen Sie der Anleitung WAPI - Manual.

2. WEDOS DNS automatisieren

Sobald WAPI korrekt konfiguriert ist, fahren Sie mit dem Einrichten des dns-domain-add Befehl, um die Erstellung sekundärer DNS-Zonendateien 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 in der Lage sind, sekundäre DNS-Zonendateien über WAPI zuverlässig zu erstellen, Kontakt aufnehmen ⧉ um dies von unserer Seite aus zu überprüfen und weitere Anweisungen zu übermitteln. Wir werden Ihnen dann eine Liste mit neuen IP-Adressen zusenden, die Sie auf Ihren Servern konfigurieren können. Zum Beispiel, wenn Ihr Server ns.domain.tld verwendet die Adresse 46.28.104.67müssen Sie eine andere IP-Adresse wählen, die wir Ihnen mitteilen werden.

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

Beispiel

Hier ist ein Beispiel für ein PHP-Skript zum Hinzufügen sekundärer Zonendateien für Domains, die von einem domains.txt Datei.

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

Rechnungsstellung

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

• Jede Transaktion wird im System erfasst.
• Am 1. eines jeden Monats werden die Transaktionen des Vormonats zusammengezählt und in Rechnung gestellt.
• Die Rechnung ist am 15. des jeweiligen Monats fällig.

Gemeinsame Probleme

Häufige Probleme mit WEDOS Zone Whitelabel sind:

• AXFR-Kommunikationsfehler

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

FAQ