Configurer l'affichage de ses données dans le Whois

Utilisez l'API publique OVHcloud pour configurer l'affichage de vos données dans le Whois

Dernière mise à jour le 05/05/2022

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

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 propriétaire 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 propriétaire (owner) sont cachées par défaut si ce sont des personnes physiques. Cependant, si l'utilisateur le souhaite, il est possible de divulguer une partie ou 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é
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": [
      "address",
      "city",
      "country",
      "email",
      "fax",
      "name",
      "organisation",
      "phone",
      "province",
      "zip"
    ]
  }
]


La réponse ci-dessus indique les trois types de règles qu'il est possible de rencontrer :

  • Le contact admin est 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 tech avec un tableau de field vide 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, c'est la règle la plus personnalisable. La présence des champs dans le noeud field indique qu'il est possible de choisir quels champs seront divulgués dans le Whois.

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é
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": ["email", "phone"]
  }
]


La réponse ci-dessus peut être interprétée de la manière suivante :

  • Les contact admin et billing sont 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 tech avec un tableau vide dans le champ fields signifie que toutes les informations du contact sont à divulguer et seront affichées dans le Whois.
  • Concernant le contact owner, on peut voir que seuls l'email et le phone 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
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": ["email", "phone"]
  }
]
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": ["email", "phone"]
  }
]

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 domaines. Il est néanmoins possible de manipuler cette obfuscation pour la désactiver sur un 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é
[
  "admin",
  "tech",
  "billing",
  "owner"
]


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é
[
  {
    "value": "317ab3c7-6c58-4d6e-827c-2c2b3e82084d@v.o-w-o.info",
    "type": "admin",
    "status": "todo"
  },
  {
    "value": "c657476c-d55a-4412-a6dc-b0b3a4f8dbe5@i.o-w-o.info",
    "type": "tech",
    "status": "done"
  },
  {
    "value": "d2dd143a-46f2-4ffe-b52b-187fbca31478@g.o-w-o.info",
    "type": "owner",
    "status": "done"
  }
]


La réponse ci-dessus peut être interprétée de la manière suivante :

  • Le contact billing est absent de la réponse, ce qui signifie qu'aucune obfuscation d'e-mail n'est présente sur ce contact.
  • Les contacts tech et owner possèdent un statut (status) à done et 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
[
  "tech",
  "admin",
  "owner"
]
[
  {
    "value": "09ea1006-4ef9-4f76-b886-c6a333e3b000@v.o-w-o.info",
    "type": "tech"
  },
  {
    "value": "5db6354f-380b-46df-b09d-711c2eda3584@i.o-w-o.info",
    "type": "admin"
  },
  {
    "value": "1c59a37a-4148-4f34-a088-b02c35464482@g.o-w-o.info",
    "type": "owner"
  }
]

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
[
  "tech",
  "admin",
  "owner"
]

Status 200


Cette documentation vous a-t-elle été utile ?

N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.

Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !

Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .

Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..


Ces guides pourraient également vous intéresser...

OVHcloud Community

Accedez à votre espace communautaire. Posez des questions, recherchez des informations, publiez du contenu et interagissez avec d’autres membres d'OVHcloud Community.

Echanger sur OVHcloud Community

Conformément à la Directive 2006/112/CE modifiée, à partir du 01/01/2015, les prix TTC sont susceptibles de varier selon le pays de résidence du client
(par défaut les prix TTC affichés incluent la TVA française en vigueur).