Gestion des contacts d'un nom de domaine

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

Types de contact

La gestion des contacts est un point central de la gestion des noms de domaine. Il est important de comprendre les différences entre les nichandles (Nic ou comptes OVHcloud) et les contacts registre/Whois (stockés chez le registre, publiés dans le Whois).

Contact registre/Whois

Pour la majorité des extensions, il y a 3 contacts différents configurables chez le registre :

• Administrateur : contact qui gère le nom de domaine dans sa globalité (gestion du contact titulaire, contact technique). Il est le principal interlocuteur du registrar.
• Technique : contact qui gère la partie technique du nom de domaine (gestion de la zone notamment).
• Titulaire : personne physique ou morale titulaire du nom de domaine. Ce contact est contraint par des règles d'éligibilité. Il est celui qui est légalement responsable du nom de domaine.

Par exemple, John contacte une agence web afin de créer son site web vitrine pour sa petite entreprise. Dans ce cas-là, l'agence web organisera les contacts de cette manière :

• Administrateur : l'agence web
• Technique : l'agence web
• Titulaire : John

Il est très fréquent que le contact technique soit le même que le contact administrateur. Concernant le titulaire, il est nécessaire que ce soit John. En cas de litige avec l'agence web, seul le fait d'être titulaire du nom de domaine aura une portée juridique et lui permettra la récupération du nom de domaine.

Nichandle OVHcloud

Le nichandle OVHcloud représente le compte OVHcloud grâce auquel il est possible de se connecter au site OVHcloud et à l'API. Sur un service OVHcloud (nom de domaine, DNS, serveur, autre...), il est possible d'affecter un nichandle en tant que :

• Nic admin : administrateur du nom de domaine, il peut exécuter toutes les actions possibles sur un service
• Nic tech : désigné par le Nic admin pour un service, il peut modifier certaines données techniques du service
• Nic facturation : responsable du paiement (facturation) du service.

Par défaut, un Nic admin est également Nic tech et Nic facturation d'un service.

Relation entre nichandles OVHcloud et contacts registre/Whois

Nichandles administrateur et technique

Les nichandles administrateur et technique OVHcloud et les contacts administrateur et technique registre/Whois sont liés. La modification des nichandles entraîne une modification automatique des contacts Whois.

L'inverse n'est cependant pas vrai. Une modification du contact administrateur ou technique (via une interface du registre par exemple) n'entraînera pas de modification du nichandle OVHcloud.

Nichandle facturation

Le nichandle facturation n'est pas utilisé côté registre/Whois. Il n'est utile qu'à la facturation du service OVHcloud représentant le nom de domaine.

Contact titulaire

Aucun nichandle ne représente le contact titulaire registre/Whois. Il n'est pas possible de l'utiliser pour se connecter à l'API ou au site OVHcloud.

Celui-ci est représenté dans l'API par une autre entité, l'objet domain.Contact.

Gestion des nichandles administrateur et technique

Création d'un nouveau nichandle

L'API suivante permet de créer un nichandle OVHcloud.

Il est également possible de récupérer les règles de création via l'API.

Une fois créé, toutes les actions liées à ce nichandle se feront via les APIs commençant par /me/*.

Récupération et modification d'un nichandle

Vous pouvez récupérer et modifier les informations d'un Nic via ces APIs.

Changement de nichandle sur le service domaine

Dans cette section, nous allons voir comment changer le Nic (admin, tech et facturation) sur un nom de domaine. Cela fonctionne de la même manière pour tous les services OVHcloud. Plus de détails concernant le workflow, ainsi que la façon de le faire via l'espace client OVHcloud peuvent être trouvés sur cette page.

Avec l'API suivante, nous allons initier une "tâche" qui permettra à l'ancien et au nouveau Nic d'accepter ou de refuser le changement.

Cette API retourne une liste d'identifiants de tâches (une par nichandle).

Une tâche de changement de nichandle a pour but d'envoyer un e-mail à l'ancien et au nouveau Nic. Ces e-mails contiennent des tokens de validation qui permettent de finaliser la procédure.

Les APIs suivantes permettent de suivre le traitement de cette tâche, ou de lui permettre d'avancer :

Gestion du contact titulaire

Le contact titulaire est représenté et géré à la fois par les routes /me/contact et /domain/contacts. Pour une utilisation des contacts dans un contexte de noms de domaine, nous vous recommandons fortement l'utilisation exclusive des APIs /domain/contacts.

Lors de la commande d'un nom de domaine, un nouveau contact titulaire est créé à partir des informations fournies, afin de toujours avoir un identifiant unique par domaine. Cela facilite les mises à jour ultérieures et évite d'impacter un nom de domaine sans le vouloir.

Gestion d'un contact

Les APIs suivantes vous permettent de gérer vos contacts.

Changement de contact titulaire

La décision d'un changement de titulaire dépend de deux critères.

• L'extension est régie par les règles de l'ICANN (gTLDs et NewgTLDs) ou par l'administration d'un pays comme pour les ccTLDs.
• Le statut légal du titulaire (individu, entreprise, …).

La situation la plus simple est celle des extensions régies par l'ICANN. Cette dernière considère l'une des modifications suivantes comme étant un changement de titulaire :

• le nom/prénom pour une personne physique ou le nom de l'entreprise/association pour une personne morale ;
• l'adresse e-mail.

Ces champs sont en conséquence en lecture seule si le contact est attaché à au moins un nom de domaine. Le changement de titulaire est gratuit sur ce type d'extensions.

Pour le reste des extensions, l'API des règles d'éligibilité vous permet de connaître le statut de chaque champ. Pour des raisons d'homogénéité, nous considérons un changement d'adresse e-mail comme un changement de titulaire.

Pour garder un comportement le plus homogène possible sur l'API OVHcloud, nous avons choisi de représenter le changement de titulaire sous la forme d'une commande. Dans la très grande majorité des cas, celle-ci sera gratuite. Elle nous permet d'avoir un processus d'initialisation identique à toutes les extensions.

Ce processus se matérialise par deux étapes principales.

1. Commande du changement de titulaire
   1. Identification du prix
   2. Création du panier
   3. Ajout de l'action de changement de titulaire dans le panier
   4. Création et ajout du contact titulaire
   5. Validation et paiement de la commande
2. Exécution du changement de titulaire
   1. Création de la tâche de DomainTrade
   2. Envoi d'e-mails à l'ancien et au nouveau titulaire
   3. Réception des tokens de validation
   4. Changement auprès du registre et du Whois

Commande du changement de titulaire

Les étapes suivantes sont décrites plus en détails dans la documentation portant sur la commande de nom de domaine.

Étape 1 : Récupération des informations du changement de titulaire

[
    {
      "exclusive": true,
      "mandatory": false,
      "family": "trade",
      "productName": ".com",
      "productType": "delivery",
      "planCode": "com-trade",
      "prices": [
        {
          "interval": 0,
          "minimumQuantity": 1,
          "description": "Creation of a .com domain name - 1 year",
          "minimumRepeat": 1,
          "priceInUcents": 0,
          "pricingMode": "create-default",
          "capacities": [
            "installation"
          ],
          "duration": "P0D",
          "maximumRepeat": 1,
          "pricingType": "purchase",
          "price": {
            "text": "0.00 €",
            "value": 0,
            "currencyCode": "EUR"
          },
          "maximumQuantity": 1
        }
      ]
    },
    {
      // ...
    }
  ]

Les éléments à retenir du retour de cette API sont :

• prices : prix du changement de titulaire
• family : la valeur "trade" indique qu'il s'agit d'un changement de titulaire
• planCode : plan commercial du changement de titulaire, égal à "$extension-trade"
• pricingMode : sous-plan commercial du changement de titulaire

Étape 2 : Création du panier et ajout du produit dans le panier

Création du panier :

Ajout du changement de titulaire dans le panier :

Étape 3 : Ajout des configurations requises

Pour connaître les configurations requises, il suffit d'appeler l'API suivante :

[
  {
    "label": "OWNER_CONTACT",
    "type": "/me/contact"
  }
]

On ajoute ensuite le contact voulu via l'API suivante.

{
  "id": 123456,
  "label": "OWNER_CONTACT",
  "value": "/me/contact/123"
}

Étape 4 : Visualisation et vérification du bon de commande

Cette étape est sans doute la plus importante du processus de commande et se fait via l'appel suivant :

Elle permet de récupérer le bon de commande dans sa forme finale sans le générer (c'est un "dry-run").

Cet appel permet également de vérifier que les règles d'éligibilité du titulaire sont respectées.

Étape 5 : Validation de la commande

Exécution du changement de titulaire

Une fois le bon de commande validé et payé, un traitement interne est effectué jusqu'à l'apparition d'une tâche de changement de titulaire nommée DomainTrade. Celle-ci peut alors être retrouvée via l'API suivante :

Plus de détails sur la gestion des tâches peuvent être trouvés sur cette page.

La tâche de DomainTrade se charge d'envoyer un e-mail à l'ancien et au nouveau titulaire pour valider la suite de la procédure. Ces e-mails contiennent un lien de validation (sécurisé via un token privé).

Une fois ces tokens validés, la tâche peut alors exécuter le changement de titulaire et mettre à jour le registre et/ou le Whois avec les informations du nouveau titulaire.