Dans cet article, vous apprendrez :
- Comment fonctionne le Whitelabel de la zone WEDOS
- Comment intégrer WEDOS Zone à votre système ?
- Comment les services sont-ils facturés ?
- Problèmes courants
- Questions fréquemment posées
WEDOS Zone Whitelabel
Le Whitelabel vous permet d'utiliser votre propre interface et DNS tout en utilisant notre infrastructure pour gérer le trafic réel. Pour ce faire, vous devez utiliser nos serveurs DNS comme secondaires par rapport à vos serveurs faisant autorité. Une telle configuration vous permet de gérer les DNS des domaines dans notre système et dans le vôtre, et de les faire communiquer via AXFR. Vous ou vos utilisateurs continuez à tout gérer dans votre système, et les changements sont répercutés en fonction du TTL défini dans l'enregistrement SOA.
Intégration de la zone WEDOS
Avant de commencer à intégrer WEDOS Zone, assurez-vous que vous remplissez les conditions préalables suivantes :
- Vous avez créé un compte de crédit WEDOS conformément à ce guide. Il n'est pas nécessaire de créditer le compte, mais il doit être actif.
- Vous avez autorisé Transferts AXFR de vos serveurs DNS primaires pour la plage IPv4
46.28.104.64/27
.
Pour tirer le meilleur parti de votre marque blanche de la zone WEDOS, procédez comme suit :
- Mise en place et test de l'API WEDOS
- Automatiser la création de fichiers de zone DNS secondaires sur WEDOS NS
- Mise à jour des paramètres du serveur DNS
1. Configuration de l'API WEDOS
L'API WEDOS, WAPI en abrégé, vous permet de gérer certaines parties de notre système à partir de votre propre application. Pour activer WAPI à partir du panneau d'administration de WEDOS Global et l'inclure dans votre application, suivez le guide WAPI - Manuel.
2. Automatiser le DNS WEDOS
Une fois que l'interface WAPI est correctement configurée, passez à la configuration de l'application dns-domain-add
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 le dns-domain-add
Lire la commande WAPI - DNS article.
3. Mise à jour des serveurs DNS
Lorsque vous êtes en mesure de créer de manière fiable des fichiers de zone DNS secondaires via WAPI, contactez-nous &boxbox ; afin de procéder à une double vérification de notre part et d'envoyer des instructions supplémentaires. Nous vous enverrons une liste de nouvelles adresses IP que vous devrez configurer sur vos serveurs. Par exemple, si votre serveur ns.domain.tld
utilise l'adresse 46.28.104.67
Dans ce cas, vous devrez changer d'adresse IP, ce que nous vous indiquerons.
Une fois les changements propagés, votre DNS bénéficiera de notre réseau mondial de serveurs.
Exemple
Voici un exemple de script PHP permettant d'ajouter des fichiers de zone secondaire pour les domaines chargés à partir d'un fichier domains.txt
fichier.
<?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";
}
}
?>
Facturation
La facturation est gérée par le compte de crédit de WEDOS dans un mode spécial :
- Chaque transaction est enregistrée dans le système.
- Le 1er jour de chaque mois, les transactions du mois précédent sont comptabilisées et facturées.
- La facture est due le 15 de ce mois.
Problèmes courants
Les problèmes les plus courants avec WEDOS Zone Whitelabel sont les suivants :
Erreur de communication AXFR
Problème : le transfert AXFR n'a pas lieu, ce qui provoque une erreur de communication axfr : not doing AXFR of an NSEC3 narrow zone (pas de transfert AXFR d'une zone étroite NSEC3).
Cause : Nous avons rencontré ce problème sur des serveurs utilisant PowerDNS avec DNSSEC et la sémantique nsec3 activée.
Solution : Si vous avez activé le DNSSEC dans votre serveur PowerDNS, vous devrez peut-être aussi désactiver la sémantique nsec3 pour vous assurer que le transfert est correctement autorisé et accepté. Si vous utilisez Cpanel, la commande suivante permet d'effectuer 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 représentant commercial lors de la négociation du service pour plus de détails.
Quelles sont les fonctionnalités prises en charge par votre DNS ?
Nous supportons IPv4/IPv6, DNSSEC et l'enregistrement ALIAS/ANAME.
Où sont situés vos serveurs ?
Vous pouvez consulter la liste actuelle des sites sur la page du produit WEDOS Global &boxbox ;.
Comment revenir à ma propre solution ?
Remettez les IP de vos serveurs DNS dans l'état où ils se trouvaient avant que vous ne passiez au nôtre.