Zone – B2B Whitelabel

W tym artykule dowiedzą się Państwo:

• Jak działa WEDOS Zone Whitelabel
• Jak zintegrować WEDOS Zone z własnym systemem
• Jak rozliczane są usługi
• Typowe problemy
• Najczęściej zadawane pytania

WEDOS Zone Whitelabel

Whitelabel pozwala korzystać z własnego interfejsu i własnego DNS, a jednocześnie używać naszej infrastruktury do obsługi rzeczywistego ruchu. Wymaga to używania naszych serwerów DNS jako wtórnych wobec Twoich serwerów autorytatywnych. Taka konfiguracja umożliwia zarządzanie DNS domen zarówno w naszym, jak i w Twoim systemie oraz ich komunikację przez AXFR. Ty lub Twoi użytkownicy nadal zarządzacie wszystkim w swoim systemie, a zmiany są odzwierciedlane zgodnie z TTL ustawionym w rekordzie SOA.

Ogólne kroki, które obecnie wykonuje się przy konfiguracji whitelabel DNS, to:

1. Podaj własne nazwy NS. Mogą to być istniejące serwery nazw albo całkiem nowe (sub)domeny, np. ns1.yourdomain.tld, ns2.yourdomain.tld. To są nazwy, które nasze serwery uznają za prawidłowe, dlatego prosimy o przesłanie kompletnej listy bez literówek.
2. Dodaj domeny secondary do WEDOS DNS. Aby dana domena korzystała z infrastruktury WEDOS DNS, musi zostać dodana do systemu. Można to zrobić na kilka sposobów; zalecamy ten opisany w rozdziale Integracja WEDOS Zone.
3. Skonfiguruj adresy IP serwerów NS. W zamian za własne nazwy NS przekażemy Państwu odpowiadającą im liczbę adresów IP. Mogą być współdzielone, dedykowane (z puli IP WEDOS) lub własne (z Państwa własnej puli IP). Proszę przypisać te adresy IP do domen serwerów nazw i poprosić nas o zweryfikowanie konfiguracji w naszym systemie.
4. Zaktualizuj rekordy NS domeny. Ten krok dotyczy tylko sytuacji, gdy w kroku 1 wybrano nowe nazwy NS. Zaktualizuj rekordy NS (serwery DNS) wszystkich odpowiednich domen na nowe nazwy NS.

Integracja WEDOS Zone

Zanim zaczniesz integrować WEDOS Zone, upewnij się, że spełniasz następujące wymagania:

• Masz skonfigurowane konto kredytowe WEDOS zgodnie z tym przewodnikiem. Nie musisz doładowywać konta kredytem, ale musi ono być aktywne.
• Zezwoliłeś Transfery AXFR z Twoich podstawowych serwerów DNS dla zakresu IPv4 46.28.104.64/27.

Aby maksymalnie wykorzystać whitelabel WEDOS Zone, wykonaj następujące czynności:

1. Konfiguracja i test WEDOS API
2. Automatyzacja tworzenia plików stref DNS secondary na WEDOS NS
3. Zaktualizuj ustawienia serwera DNS

1. Konfiguracja WEDOS API

WEDOS API, w skrócie WAPI, pozwala zarządzać wybranymi częściami naszego systemu z poziomu własnej aplikacji. Aby aktywować WAPI w panelu administracyjnym WEDOS Global i włączyć je do swojej aplikacji, postępuj zgodnie z przewodnikiem WAPI – podręcznik.

2. Automatyzacja WEDOS DNS

Gdy WAPI jest już poprawnie skonfigurowane, proszę przejść do konfiguracji dns-domain-add polecenie do automatyzacji tworzenia plików stref wtórnego DNS na naszych serwerach. Użyj następującego szablonu JSON:

{
  "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. Aktualizacja serwerów DNS

Gdy będą już Państwo w stanie niezawodnie tworzyć pliki stref wtórnego DNS przez WAPI, prosimy o kontakt, ⧉ aby zweryfikować to po naszej stronie i przesłać dalsze instrukcje. Odezwiemy się z listą nowych adresów IP do skonfigurowania na Państwa serwerach. Na przykład jeśli Państwa serwer ns.domain.tld używa adresu 46.28.104.67, trzeba będzie zmienić go na inny adres IP, który Państwu podamy.

Po propagacji zmian Państwa DNS skorzysta z naszej ogólnoświatowej sieci serwerów.

Przykład

Oto przykładowy skrypt PHP dodający pliki stref wtórnych dla domen wczytanych z pliku domains.txt .

<?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

Fakturację obsługuje konto kredytowe WEDOS w trybie specjalnym:

• Każda transakcja jest zapisywana w systemie.
• Pierwszego dnia każdego miesiąca transakcje z poprzedniego miesiąca są sumowane i fakturowane.
• Faktura jest płatna do 15. dnia danego miesiąca.

Typowe problemy

Typowe problemy z WEDOS Zone Whitelabel to:

• Błąd komunikacji AXFR

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

FAQ