Configurer l'affichage de ses données dans le Whois
Pour suivre ce guide, vous devez déjà vous connecter à l'API OVHcloud. Vous trouverez plus de détails sur la page d'introduction à l'API.
Sommaire
- Introduction
- Commander un nom de domaine
- Gestion des tâches
- Gestion des contacts d'un nom de domaine
- Gestion des règles d'éligibilité
- Configurer l'affichage de ses données dans le Whois
- Configurer les DNS de son nom de domaine
- Transférer un nom de domaine
Introduction
Le Whois est un service de recherche permettant d'obtenir des informations sur un nom de domaine. Ces informations peuvent avoir des usages variés mais sont souvent utilisées pour retrouver et contacter le titulaire d'un nom de domaine. Celles-ci sont présentées sous forme de texte non standardisé et étaient jusqu'à récemment affichées en clair.
Le RDAP a été conçu comme un successeur au Whois et présente plusieurs avantages par rapport à celui-ci, notamment :
- La prise en charge de l’internationalisation
- Une standardisation du format de données
- La possibilité de fournir un accès différencié aux données
Cette section est dédiée aux routes d'API servant à configurer la divulgation et l'obfuscation des différentes données liées aux contacts d'un nom de domaine dans le Whois et le RDAP.
Divulgation des informations (optin)
Depuis la mise en place du RGPD, les données du Whois concernant les contacts admin, tech, billing et owner (titulaire) sont cachées par défaut
si ce sont des personnes physiques.
Cependant, si l'utilisateur le souhaite, il est possible de divulguer l'intégralité des données en fonction de
ce qui est permis par les règles d'optin appliquées sur le nom de domaine.
Récupération des règles d'optin
L'API suivante permet de connaître les règles de divulgation applicables sur un nom de domaine.
| Paramètre | Obligatoire | Description |
|---|---|---|
serviceName | oui | Le nom de domaine concerné |
La réponse ci-dessus indique les trois types de règles qu'il est possible de rencontrer :
- Le contact
adminest absent de la réponse, ce qui signifie qu'il n'est pas possible de configurer la divulgation des données Whois le concernant. - La présence du contact
techavec un tableau defieldvide signifie qu'il est possible de divulguer les informations. Le choix des informations divulguées n'est cependant pas personnalisable (c'est tout ou rien). - Concernant le contact
owner, la présence des champs dans le nœudfieldsignifie que les informations sont masquées. Le choix des informations divulguées n'est cependant pas personnalisable : l’affichage est soit intégral, soit inexistant.
Récupération de la configuration d'optin d'un nom de domaine
L'API suivante permet de récupérer la configuration de divulgation appliquée sur un nom de domaine.
| Paramètre | Obligatoire | Description |
|---|---|---|
serviceName | oui | Le nom de domaine concerné |
La réponse ci-dessus peut être interprétée de la manière suivante :
- Les contact
adminetbillingsont absents de la réponse, ce qui signifie qu'aucune information les concernant ne sera affichée dans le Whois. - La présence du contact
techavec un tableau vide dans le champfieldssignifie que toutes les informations du contact sont à divulguer et seront affichées dans le Whois. - Concernant le contact
owner, on peut voir que les champs sont configurés pour être divulgués et seront affichés dans le Whois.
Modification de la configuration optin
L'API suivante permet de modifier la configuration de divulgation appliquée sur un nom de domaine.
| Paramètre | Obligatoire | Défaut | Description |
|---|---|---|---|
serviceName | oui | Le nom de domaine concerné | |
optin (body) | oui | [] | Configuration de divulgation |
Obfuscation d'e-mail
Au-delà de la divulgation des données sur le Whois en fonction des différentes règles disponibles pour les extensions, OVHcloud donne la possibilité d'obfusquer les adresses e-mail des contacts dans le Whois.
Avec la mise en place du RGPD, cette fonctionnalité est activée par défaut pour tous les noms de domaine. Il est néanmoins possible de manipuler cette obfuscation pour la désactiver sur un nom de domaine spécifique.
Récupération des règles d'obfuscation
L'API suivante permet de connaître les règles d'obfuscation applicables sur un nom de domaine.
| Paramètre | Obligatoire | Description |
|---|---|---|
serviceName | oui | Le nom de domaine concerné |
La réponse ci-dessus indique que les e-mails peuvent être obfusqués sur les contacts admin, tech, billing et owner.
Récupération de la configuration d'obfuscation des e-mails d'un nom de domaine
L'API suivante permet de récupérer la configuration d'obfuscation appliquée sur un nom de domaine.
| Paramètre | Obligatoire | Description |
|---|---|---|
serviceName | oui | Le nom de domaine concerné |
La réponse ci-dessus peut être interprétée de la manière suivante :
- Le contact
billingest absent de la réponse, ce qui signifie qu'aucune obfuscation d'e-mail n'est présente sur ce contact. - Les contacts
techetownerpossèdent un statut (status) àdoneet une valeur (value) non nulle, cela indique que ces deux contacts ont leur e-mail obfusqué via cette valeur et que la redirection e-mail est active. - Concernant le contact
admin, on peut voir que la valeur existe mais que le statut est àtodo, ce qui signifie que le contact est configuré pour être obfusqué mais que la redirection de l'adresse e-mail n'est pas encore mise en place.
Modification de la configuration d'obfuscation des e-mails
L'API suivante permet de modifier la configuration d'obfuscation appliquée sur un nom de domaine.
| Paramètre | Obligatoire | Défaut | Description |
|---|---|---|---|
serviceName | oui | Le nom de domaine concerné | |
contacts (body) | oui | [] | Liste des types de contacts sur lesquels l'obfuscation doit être mise en place |
Regénération des e-mails obfusqués
L'API suivante permet de regénérer les e-mails obfusqués d'un nom de domaine.
| Paramètre | Obligatoire | Défaut | Description |
|---|---|---|---|
serviceName | oui | Le nom de domaine concerné | |
contacts (body) | oui | [] | Liste des types de contacts sur lesquels l'obfuscation doit être regénérée |
Status 200