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 fakturujú
• 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 spracovanie samotnej prevádzky. Vyžaduje si to používať naše DNS servery ako sekundárne k vašim autoritatívnym. Takéto nastavenie umožňuje spravovať DNS domény v našom aj vo vašom systéme a 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 SOA zázname.

Všeobecné kroky pri nastavení whitelabel DNS sú v súčasnosti tieto:

1. Zadajte vlastné názvy NS. Môže ísť o existujúce nameservery alebo o úplne nové (sub)domény, napríklad ns1.yourdomain.tld, ns2.yourdomain.tld. Práve tieto názvy budú naše servery považovať za legitímne, preto nám pošlite kompletný zoznam bez preklepov.
2. Pridajte sekundárne domény do WEDOS DNS. Aby každá doména mohla využívať infraštruktúru WEDOS DNS, musí byť pridaná do systému. Dá sa to dosiahnuť viacerými spôsobmi, odporúčame postupovať podľa toho, ktorý je opísaný v kapitole Integrácia WEDOS Zone.
3. Nastavenie IP adries NS. Výmenou za vaše vlastné NS názvy vám poskytneme zodpovedajúci počet IP adries. Môžu byť zdieľané, dedikované (z rozsahu IP adries WEDOS) alebo vlastné (z vášho vlastného 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én. Tento krok platí iba vtedy, ak ste v kroku 1 zvolili nové názvy NS. Aktualizujte NS záznamy (DNS servery) všetkých dotknutých domén na nové názvy NS.

Integrácia WEDOS Zone

Než začnete s integráciou WEDOS Zone, uistite sa, že spĺňate nasledujúce predpoklady:

• Nastavili ste zálohový účet WEDOS podľa tohto návodu. Na účte nemusíte mať kredit, musí však 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 toto:

1. Nastavenie a test WEDOS API
2. Automatizácia vytvárania súborov sekundárnych DNS zón na WEDOS NS
3. Aktualizujte nastavenia DNS servera

1. Nastavenie WEDOS API

WEDOS API, skrátene WAPI, vám 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ď budete vedieť spoľahlivo vytvárať sekundárne zónové súbory DNS pomocou WAPI, kontaktujte nás ⧉ na overenie z našej strany 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.

Keď sa zmeny rozšíria, vaše DNS bude ť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é z domains.txt súboru.

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

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

• Každá transakcia je zaznamenaná v systéme.
• Prvého dňa každého mesiaca sa spočítajú transakcie za predchádzajúci mesiac a vystaví sa faktúra.
• 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