Créer des clés API OVHcloud

Utilisez ce guide si vous devez connecter InfraNest à OVHcloud en créant vos propres clés API pour les domaines, le DNS ou les serveurs VPS.

Aperçu

• Vous n’en avez besoin que si Connect with OVHcloud n’est pas proposé sur l’écran de connexion. Quand c’est le cas, utilisez plutôt cette option — c’est plus rapide et il n’y a rien à copier ni à renouveler.
• OVHcloud vous fournit trois valeurs en une seule fois : une Application Key, un Application Secret et une Consumer Key. Les trois doivent être renseignées dans InfraNest.

NoteLa mise en place de Connect with OVHcloud elle-même relève d’un administrateur, pas d’une action client — voir la section à la fin de cet article. Un compte de service n’est pas adapté à cet usage.

Créer les clés

1. Rendez-vous sur la page de jeton correspondant à votre région — elle doit correspondre à la région choisie dans InfraNest :

   • Europe — eu.api.ovh.com/createToken
   • Canada / Asie-Pacifique — ca.api.ovh.com/createToken
   • États-Unis — api.us.ovhcloud.com/createToken

2. Connectez-vous avec votre compte OVHcloud.

3. Renseignez un nom de script (par exemple InfraNest) et une description, afin de le reconnaître plus tard.

4. Réglez la validité sur Unlimited, à moins que vous ne souhaitiez renouveler les clés vous-même selon un calendrier.

5. Sous Rights, ajoutez une ligne par entrée ci-dessous. Le lien fourni par InfraNest ouvre cette page avec chaque ligne déjà remplie, cette liste sert donc surtout à vérifier plutôt qu’à saisir.

   Domaines et DNS

   • GET /domain — Lister vos domaines
   • GET /domain/* — Lire les détails d’un domaine, ses serveurs de noms, ses zones DNS
   • POST /domain/* — Modifier les serveurs de noms, les contacts, le DNSSEC
   • PUT /domain/* — Verrou de transfert, renouvellement automatique, enregistrements DNS
   • DELETE /domain/* — Supprimer des enregistrements DNS

   Achat et tarification des domaines

   • POST /order/cart — Démarrer une recherche de prix ou de disponibilité
   • POST /order/cart/* — Enregistrer ou transférer un domaine
   • GET /order/cart/* — Relire les prix
   • DELETE /order/cart/* — Nettoyer la recherche ensuite

   Serveurs (uniquement si vous exploitez des VPS chez OVHcloud)

   • GET /vps — Lister vos VPS
   • GET /vps/* — Lire un VPS, ses IP et ses sauvegardes
   • POST /vps/* — Démarrer, arrêter, redémarrer, réinstaller, créer un instantané
   • PUT /vps/* — Le renommer, modifier le DNS inversé
   • DELETE /vps/* — Supprimer un instantané

   Rien en dehors de ces trois domaines n’est nécessaire — InfraNest ne demande jamais l’accès à votre compte lui-même.

   /domain et /domain/* sont deux règles distinctes — le * couvre tout ce qui se trouve sous /domain, mais pas /domain lui-même. Si vous omettez la première ligne, la liste de vos domaines échoue avec « This call has not been granted » alors que tout le reste fonctionne. Il en va de même pour /order/cart et /vps, raison pour laquelle chacun apparaît deux fois ci-dessus.

   TipVous avez déjà une clé ? Les clés créées avant l’ajout de l’enregistrement de domaines et de la prise en charge des VPS n’ont pas les lignes POST /order/cart/* ni DELETE /vps/*. Tout le reste continue de fonctionner, mais l’achat d’un domaine ou la suppression d’un instantané échoue avec « This call has not been granted ». Créez un nouveau jeu de clés à partir du lien ci-dessus et collez-les — rien n’est perdu, et aucun domaine n’est jamais acheté à moitié par cette opération.

6. Sélectionnez Create keys.

Les copier dans InfraNest

1. OVHcloud affiche maintenant les trois valeurs une seule fois. Copiez chacune dans le champ correspondant sur l’écran de connexion InfraNest :
   • Application Key → Application Key
   • Application Secret → Application Secret
   • Consumer Key → Consumer Key
2. Si vous fermez la page avant de les copier, vous ne pourrez plus les récupérer — créez un nouveau jeu et supprimez l’ancien.

Bon à savoir

• Les droits que vous accordez sont les droits dont dispose InfraNest. Seuls les chemins /domain/* sont nécessaires pour le DNS et les domaines. N’accordez pas /*.
• Les clés sont propres à chaque région. Les clés créées sur la page européenne ne fonctionneront pas si la connexion est configurée sur États-Unis.
• Pour révoquer l’accès, rendez-vous dans votre compte OVHcloud sous API keys et supprimez l’entrée. La connexion dans InfraNest commencera alors à signaler des erreurs, ce qui est le comportement attendu.

Dépannage

• « Authentication failed » — vérifiez que la région correspond à celle utilisée pour créer les clés, et que les trois valeurs ont été collées sans espaces parasites.
• Les lectures fonctionnent mais pas les modifications — vous n’avez probablement accordé que GET. Ajoutez POST, PUT et DELETE sur /domain/*, ou créez un nouveau jeu de clés avec les quatre méthodes.

Pour les administrateurs : activer Connect with OVHcloud

Cette partie s’adresse à la personne qui gère la plateforme InfraNest, et c’est l’étape que la documentation d’OVHcloud rend facile à mal faire.

Un compte de service ne fonctionnera pas. Le panneau de contrôle OVHcloud propose des comptes de service, qui utilisent le flux CLIENT_CREDENTIALS — ils s’authentifient en tant qu’eux-mêmes, de machine à machine. C’est pourquoi un compte de service vous donne un identifiant et un mot de passe, mais aucun champ pour une URL de rappel, et pourquoi y envoyer un utilisateur affiche une page « You are logged in as… » avec un bouton Customer Center au lieu d’un bouton Allow. Il n’y a rien à approuver, car on ne demande la permission à personne.

Ce qu’il vous faut, c’est un client OAuth2 utilisant le flux AUTHORIZATION_CODE, que le panneau de contrôle ne crée pas — il doit être créé via l’API :

1. Ouvrez la console API de votre région — eu.api.ovh.com/console (ou l’équivalent ca / us).

2. Trouvez POST /me/api/oauth2/client et sélectionnez Authenticate (une connexion via navigateur ; aucune clé requise).

3. Envoyez :

   {
     "name": "InfraNest",
     "description": "InfraNest one-click connect",
     "flow": "AUTHORIZATION_CODE",
     "callbackUrls": ["https://your-infranest-url/api/provider-oauth/ovh/callback"]
   }
   

   L’URL de rappel doit correspondre exactement à ce qu’affiche Panneau d'administration → Intégrations → OVHcloud ; un bouton Copier se trouve juste à côté.

4. La réponse contient un clientId et un clientSecret. Le secret n’est affiché qu’une seule fois.

5. Collez les deux dans l’emplacement correspondant à votre région dans Panneau d'administration → Intégrations → OVHcloud.

Chaque région est une plateforme distincte, elle nécessite donc son propre client créé sur sa propre console. Les régions que vous laissez vides continuent simplement d’utiliser la méthode par clé API décrite plus haut.

Rien d’autre n’est nécessaire du côté du client. Approuver la connexion suffit — il n’a pas besoin de configurer au préalable une politique d’accès dans OVHcloud, ce qui est précisément ce qui rend cette méthode plus rapide que la création de clés.

WarningSi une connexion réussit mais que tous les appels échouent ensuite avec « User not granted for this request », la connexion a été établie avant la correction de ce problème. Les autorisations sont déterminées au moment où quelqu’un approuve la connexion, une connexion plus ancienne ne peut donc pas être réparée telle quelle — déconnectez-la et reconnectez-vous.