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

Base de connaissances

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


Icons/System/eye-open Created with Sketch. 9494 vues 10.02.2026 Web / Nom de domaine

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 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ètreObligatoireDescription
serviceNameouiLe 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, la présence des champs dans le nœud field signifie 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ètreObligatoireDescription
serviceNameouiLe 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 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 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ètreObligatoireDéfautDescription
serviceNameouiLe nom de domaine concerné
optin (body)oui[]Configuration de divulgation
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": [
      "address",
      "city",
      "country",
      "email",
      "fax",
      "name",
      "organisation",
      "phone",
      "province",
      "zip"
    ]
  }
]
[
  {
    "type": "tech",
    "fields": []
  },
  {
    "type": "owner",
    "fields": [
      "address",
      "city",
      "country",
      "email",
      "fax",
      "name",
      "organisation",
      "phone",
      "province",
      "zip"
    ]
  }
]

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ètreObligatoireDescription
serviceNameouiLe 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ètreObligatoireDescription
serviceNameouiLe 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ètreObligatoireDéfautDescription
serviceNameouiLe 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ètreObligatoireDéfautDescription
serviceNameouiLe 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

Articles associés