Zone – B2B Whitelabel

V tomto článku se dozvíte:

• Jak funguje WEDOS Zone Whitelabel
• Jak integrovat WEDOS Zone do svého systému
• Jak se služby účtují
• Časté problémy
• Často kladené otázky

WEDOS Zone Whitelabel

Whitelabel vám umožňuje používat vlastní rozhraní a DNS a zároveň využívat naši infrastrukturu pro samotné odbavení provozu. Vyžaduje to použít naše DNS servery jako sekundární k vašim autoritativním. Takové nastavení umožňuje spravovat DNS domén v našem i vašem systému a jejich komunikaci přes AXFR. Vy nebo vaši uživatelé vše nadále spravujete ve svém systému a změny se projeví podle TTL nastaveného v SOA záznamu.

Obecné kroky, kterými se aktuálně nastavuje whitelabel DNS, jsou:

1. Zadejte vlastní názvy NS. Může jít buď o stávající nameservery, nebo o zcela nové (sub)domény, například ns1.yourdomain.tld, ns2.yourdomain.tld. Právě tyto názvy budou naše servery považovat za legitimní, proto nám pošlete kompletní seznam bez překlepů.
2. Přidejte sekundární domény do WEDOS DNS. Aby každá doména mohla využívat infrastrukturu WEDOS DNS, musí být přidána do systému. Lze toho dosáhnout několika způsoby, doporučujeme postupovat podle toho, který je popsán v kapitole Integrace WEDOS Zone.
3. Nastavte IP adresy NS. Výměnou za vlastní NS jména vám poskytneme odpovídající počet IP adres. Ty mohou být sdílené, dedikované (z rozsahu IP WEDOS), nebo vlastní (z vašeho vlastního rozsahu IP). Přiřaďte tyto IP adresy doménám nameserverů a požádejte nás o ověření nastavení v našem systému.
4. Aktualizujte NS záznamy domény. Tento krok se týká pouze případu, kdy jste v kroku 1 zvolili nové názvy NS. Aktualizujte NS záznamy (DNS servery) všech dotčených domén na nové názvy NS.

Integrace WEDOS Zone

Než začnete integrovat WEDOS Zone, ujistěte se, že splňujete tyto předpoklady:

• Nastavili jste zálohový účet WEDOS podle tohoto návodu. Na účet nemusíte nabíjet kredit, ale musí být aktivní.
• Povolili jste Přenosy AXFR ze svých primárních DNS serverů pro IPv4 rozsah 46.28.104.64/27.

Chcete-li ze svého whitelabelu WEDOS Zone vytěžit maximum, udělejte následující:

1. Nastavení a otestování WEDOS API
2. Automatizujte vytváření sekundárních souborů DNS zóny na WEDOS NS
3. Aktualizace nastavení DNS serveru

1. Nastavení WEDOS API

WEDOS API, zkráceně WAPI, umožňuje spravovat vybrané části našeho systému z vaší vlastní aplikace. Chcete-li WAPI aktivovat ze zákaznické administrace WEDOS Global a zapojit je do své aplikace, postupujte podle návodu WAPI – Manuál.

2. Automatizace WEDOS DNS

Jakmile máte WAPI správně nastavené, přejděte k nastavení dns-domain-add příkaz pro automatizaci vytváření souborů sekundárních DNS zón na našich serverech. Použijte tuto JSON šablonu:

{
  "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. Aktualizace DNS serverů

Jakmile budete schopni spolehlivě vytvářet sekundární zónové soubory DNS pomocí WAPI, kontaktujte nás, ⧉ abychom to ověřili na naší straně a poslali další pokyny. Ozveme se vám se seznamem nových IP adres, které si nastavíte na svých serverech. Pokud například váš server ns.domain.tld používá adresu 46.28.104.67, budete ji muset změnit na jinou IP adresu, kterou vám sdělíme.

Jakmile se změny propagují, bude vaše DNS těžit z naší celosvětové sítě serverů.

Příklad

Zde je ukázkový PHP skript pro přidávání sekundárních zónových souborů pro domény načtené z domains.txt souboru.

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

Fakturaci zajišťuje zálohový účet WEDOS ve zvláštním režimu:

• Každá transakce je v systému zaznamenána.
• Prvního dne každého měsíce se sečtou transakce za předchozí měsíc a vystaví se faktura.
• Faktura je splatná 15. den daného měsíce.

Časté problémy

Mezi časté problémy s WEDOS Zone Whitelabel patří:

• Chyba komunikace AXFR

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

FAQ