Zone – B2B Whitelabel

V tomto článku sa dozviete:

• Ako funguje WEDOS Zone Whitelabel
• Ako integrovať WEDOS Zone do vášho systému
• Ako sa služby účtujú
• Bežné problémy
• Často kladené otázky

WEDOS Zone Whitelabel

Whitelabel vám umožňuje používať vlastné rozhranie a DNS a zároveň využívať našu infraštruktúru na obsluhu samotného prenosu. Vyžaduje to, aby ste naše DNS servery používali ako sekundárne k svojim autoritatívnym. Takéto nastavenie umožňuje spravovať DNS domény v našom aj vo vašom systéme a ich vzájomnú komunikáciu cez AXFR. Vy alebo vaši používatelia stále spravujete všetko vo svojom systéme a zmeny sa prejavia podľa TTL nastaveného v zázname SOA.

Všeobecné kroky, ktorými sa aktuálne nastavuje whitelabel DNS, sú:

1. Zadajte vlastné názvy NS. Môžu to byť buď existujúce menné servery, alebo úplne nové (sub)domény, napríklad ns1.yourdomain.tld, ns2.yourdomain.tld. Toto sú názvy, ktoré naše servery rozpoznajú ako legitímne, preto nezabudnite odoslať úplný zoznam bez preklepov.
2. Pridajte sekundárne domény do WEDOS DNS. Aby každá doména využívala infraštruktúru WEDOS DNS, uistite sa, že je pridaná do systému. Dá sa to dosiahnuť viacerými spôsobmi, odporúčame postupovať podľa toho, ktorý je popísaný v kapitole Integrácia WEDOS Zone.
3. Nastavte IP adresy NS. Výmenou za vaše vlastné NS názvy vám poskytneme zodpovedajúci počet IP adries. Tie môžu byť zdieľané, dedikované (z IP rozsahu WEDOS) alebo vlastné (z vášho vlastného IP rozsahu). Priraďte tieto IP adresy doménam nameserverov a požiadajte nás o overenie nastavenia v našom systéme.
4. Aktualizujte NS záznamy domény. Tento krok sa týka iba prípadu, keď ste v kroku 1 zvolili nové názvy NS. Aktualizujte NS záznamy (DNS servery) všetkých príslušných domén na nové názvy NS.

Integrácia WEDOS Zone

Skôr než začnete integrovať WEDOS Zone, uistite sa, že spĺňate nasledujúce predpoklady:

• Nastavili ste kreditný účet WEDOS podľa tohto návodu. Na účet nemusíte dobíjať kredit, ale musí byť aktívny.
• Povolili ste Prenosy AXFR z vašich primárnych DNS serverov pre IPv4 rozsah 46.28.104.64/27.

Ak chcete zo svojho whitelabelu WEDOS Zone vyťažiť maximum, urobte nasledujúce:

1. Nastavenie a otestovanie WEDOS API
2. Automatizácia vytvárania sekundárnych DNS zónových súborov na WEDOS NS
3. Aktualizácia nastavenia DNS servera

1. Nastavenie WEDOS API

WEDOS API, skrátene WAPI, umožňuje spravovať vybrané časti nášho systému z vlastnej aplikácie. Ak chcete WAPI aktivovať v administrácii WEDOS Global a zapojiť ho do svojej aplikácie, postupujte podľa návodu WAPI – Manuál.

2. Automatizácia WEDOS DNS

Keď je WAPI správne nastavené, pokračujte nastavením dns-domain-add príkaz na automatizované vytváranie súborov sekundárnej DNS zóny na našich serveroch. Použite túto JSON šablónu:

{
  "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. Aktualizácia DNS serverov

Keď už dokážete spoľahlivo vytvárať sekundárne DNS zónové súbory cez WAPI, kontaktujte nás ⧉ pre overenie na našej strane a zaslanie ďalších pokynov. Ozveme sa vám so zoznamom nových IP adries, ktoré si nastavíte na svojich serveroch. Napríklad ak váš server ns.domain.tld používa adresu 46.28.104.67, budete ju musieť zmeniť na inú IP adresu, ktorú vám oznámime.

Po spropagovaní zmien bude vaše DNS ťažiť z našej celosvetovej siete serverov.

Príklad

Tu je ukážkový PHP skript na pridávanie sekundárnych zónových súborov pre domény načítané zdomains.txtsúbor.

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

Fakturácia

Fakturáciu zabezpečuje kreditný účet WEDOS v špeciálnom režime:

• Každá transakcia je zaznamenaná v systéme.
• Prvý deň každého mesiaca sa transakcie predchádzajúceho mesiaca spočítajú a vyfakturujú.
• Faktúra je splatná 15. dňa daného mesiaca.

Bežné problémy

Medzi bežné problémy s WEDOS Zone Whitelabel patria:

• Chyba komunikácie AXFR

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

FAQ