Zone – Whitelabel B2B

Sur cette pageWEDOS Zone WhitelabelIntégration de WEDOS ZoneBillingProblèmes courantsFAQ

Dans cet article, vous découvrirez :


WEDOS Zone Whitelabel

Le whitelabel vous permet d’utiliser votre propre interface et votre propre DNS tout en vous appuyant sur notre infrastructure pour gérer le trafic réel. Vous devez pour cela utiliser nos serveurs DNS comme serveurs secondaires de vos serveurs autoritaires. Une telle configuration vous permet de gérer le DNS des domaines aussi bien dans notre système que dans le vôtre, et de les faire communiquer via AXFR. Vous ou vos utilisateurs gérez tout dans votre système, et les modifications sont répercutées selon le TTL défini dans l’enregistrement SOA.

Les étapes générales à suivre actuellement pour configurer un DNS en marque blanche sont les suivantes :

  1. Indiquez des noms NS personnalisés. Il peut s’agir de serveurs de noms existants ou de (sous-)domaines entièrement nouveaux, par exemple ns1.yourdomain.tld, ns2.yourdomain.tld. Ce sont les noms que nos serveurs reconnaîtront comme légitimes ; veillez donc à envoyer une liste complète et sans fautes de frappe.
  2. Ajoutez les domaines secondaires à WEDOS DNS. Pour qu’un domaine puisse utiliser l’infrastructure WEDOS DNS, il doit être ajouté au système. Plusieurs méthodes permettent d’y parvenir ; nous recommandons celle décrite au chapitre Intégration de WEDOS Zone.
  3. Configurez les adresses IP des NS. En contrepartie de vos noms NS personnalisés, nous vous fournirons le nombre correspondant d’adresses IP. Celles-ci peuvent être partagées, dédiées (issues de la plage IP WEDOS) ou personnalisées (issues de votre propre plage IP). Attribuez ces adresses IP aux domaines des serveurs de noms et demandez-nous de valider la configuration dans notre système.
  4. Mettez à jour les enregistrements NS du domaine. Cette étape ne s’applique que si vous avez choisi de nouveaux noms NS à l’étape 1. Mettez à jour les enregistrements NS (serveurs DNS) de tous les domaines concernés avec les nouveaux noms NS.

Les techniciens WEDOS répondent généralement aux demandes sous 1 à 2 jours ouvrés, selon la complexité de la demande et la charge du département.


Intégration de WEDOS Zone

Avant de commencer l’intégration de WEDOS Zone, assurez-vous de remplir les conditions préalables suivantes :

  • Vous avez configuré un compte de crédit WEDOS selon ce guide. Vous n’avez pas besoin de créditer le compte, mais il doit être actif.
  • Vous avez autorisé Transferts AXFR depuis vos serveurs DNS primaires pour la plage IPv4 46.28.104.64/27.

Pour tirer le meilleur parti de votre marque blanche WEDOS Zone, procédez comme suit :

  1. Configurer et tester l’API WEDOS
  2. Automatiser la création des fichiers de zone DNS secondaire sur les NS WEDOS
  3. Mettre à jour les paramètres du serveur DNS

1. Configuration de l’API WEDOS

L’API WEDOS, en abrégé WAPI, vous permet de gérer certaines parties de notre système depuis votre propre application. Pour activer WAPI depuis le panneau d’administration WEDOS Global et l’intégrer à votre application, suivez le guide WAPI – Manuel.

2. Automatiser le DNS WEDOS

Une fois WAPI correctement configuré, passez à la configuration de dns-domain-add commande pour automatiser la création de fichiers de zone DNS secondaires sur nos serveurs. Utilisez le modèle JSON suivant :

{
"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"
}
}
}

Pour plus d’informations sur dns-domain-add commande, consultez WAPI – DNS article.

3. Mettre à jour les serveurs DNS

Dès que vous êtes en mesure de créer de manière fiable des fichiers de zone DNS secondaire via WAPI, prenez contact avec nous ⧉ pour vérifier de notre côté et envoyer des instructions complémentaires. Nous reviendrons vers vous avec une liste de nouvelles adresses IP à configurer sur vos serveurs. Par exemple, si votre serveur ns.domain.tld utilise l’adresse 46.28.104.67, vous devrez la remplacer par une autre adresse IP, que nous vous communiquerons.

Une fois les modifications propagées, votre DNS bénéficiera de notre réseau de serveurs mondial.

Exemple

Voici un exemple de script PHP permettant d’ajouter des fichiers de zone secondaire pour les domaines chargés depuis le fichier 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

La facturation est assurée par compte de crédit WEDOS dans un mode spécial :

  • Chaque transaction est enregistrée dans le système.
  • Le premier jour de chaque mois, les transactions du mois précédent sont totalisées et facturées.
  • La facture est exigible le 15 du mois en question.

Problèmes courants

Les problèmes courants liés à WEDOS Zone Whitelabel sont notamment :

Erreur de communication AXFR

Problème : Le transfert AXFR n’a pas lieu et renvoie une erreur de communication axfr : ne pas effectuer d’AXFR d’une zone NSEC3 narrow.

Cause : Nous avons rencontré ce problème sur des serveurs utilisant PowerDNS avec DNSSEC et la sémantique nsec3 activée.

Solution : Si DNSSEC est activé sur votre serveur PowerDNS, vous devrez peut-être aussi désactiver la sémantique nsec3 afin que le transfert soit correctement autorisé et accepté. Si vous utilisez Cpanel, la commande suivante effectue cette opération pour un seul domaine (domain.tld).

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

FAQ

Existe-t-il une période d’essai pour le Whitelabel ?

Oui, consultez votre commercial lors de la négociation du service pour plus de détails.

Quelles fonctionnalités votre DNS prend-il en charge ?

Nous prenons en charge IPv4/IPv6, DNSSEC, ainsi que les enregistrements ALIAS et DNAME.

Prenez-vous en charge les zones de sous-domaines personnalisées ?

Zones de sous-domaines personnalisées, telles que com.eu sont à haut risque – elles peuvent être détournées pour générer de grands volumes de pseudo-domaines, entrer en conflit avec certains domaines et compliquer inutilement les interventions techniques. C’est pourquoi nous nous réservons la possibilité d’autoriser au cas par cas les partenaires de confiance à créer de telles zones personnalisées.

Où se trouvent vos serveurs ?

Vous pouvez consulter la liste actuelle des emplacements sur la page produit de WEDOS Global ⧉.

Comment revenir à ma propre solution ?

Rétablissez les IP de vos serveurs DNS telles qu’elles étaient avant de passer aux nôtres.

Cet article vous a-t-il été utile ?

Votre avis nous aide à améliorer nos articles.

Votre message est transmis à l'équipe de rédaction de la documentation, qui n'y répond pas. Si vous avez besoin d’aide, contactez-nous via le formulaire de contact. N'indiquez ni mots de passe ni données personnelles.

Vous n’avez pas trouvé ce que vous cherchiez ?

Envoyez-nous votre question via le formulaire de contact.