Créer des clés API OVHcloud

Créez l’Application Key, l’Application Secret et la Consumer Key qui permettent à InfraNest de gérer vos domaines, DNS et serveurs OVHcloud. Ceci concerne toute personne connectant un compte OVHcloud à InfraNest manuellement.

#Vue d’ensemble

• OVHcloud vous fournit trois valeurs à la fois — une Application Key, un Application Secret et une Consumer Key — et les trois doivent être renseignées dans InfraNest.
• Vous n’avez besoin de faire ceci que si Connecter avec OVHcloud n’est pas proposé sur l’écran de connexion. Lorsqu’il l’est, utilisez-le plutôt — c’est plus rapide et il n’y a rien à copier ni à faire pivoter.

NoteLa mise en place de Connecter avec OVHcloud elle-même est une tâche d’administrateur, pas une tâche client — voir 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 Illimitée, sauf si vous souhaitez faire pivoter les clés vous-même selon un calendrier.

5. Dans Droits, ajoutez les lignes requises. Le lien fourni par InfraNest ouvre cette page avec chaque ligne déjà renseignée :

   • Domaines et DNS : GET /domain, GET /domain/*, POST /domain/*, PUT /domain/*, DELETE /domain/*
   • Achat et tarification de domaines : POST /order/cart, POST /order/cart/*, GET /order/cart/*, DELETE /order/cart/*
   • Serveurs (uniquement si vous utilisez des VPS chez OVHcloud) : GET /vps, GET /vps/*, POST /vps/*, PUT /vps/*, DELETE /vps/*

   Note/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 oubliez la première ligne, lister vos domaines échouera alors que tout le reste fonctionnera. Le même principe s’applique à /order/cart et /vps, ce qui explique pourquoi chacun apparaît deux fois ci-dessus.

6. Sélectionnez Create keys.

#Les copier dans InfraNest

1. OVHcloud affiche les trois valeurs une seule fois. Copiez chacune dans le champ correspondant de 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 pas les récupérer — créez un nouveau jeu et supprimez l’ancien.

#Astuces

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’auront ni la ligne POST /order/cart/* ni aucune ligne /vps. Le DNS et les domaines continuent de fonctionner, mais l’achat d’un domaine échoue, et la connexion ne peut pas être utilisée pour Cloud tant qu’elle n’a pas de clés avec les lignes /vps. Créez un nouveau jeu à partir du lien ci-dessus et collez-les — rien n’est perdu.

• Les droits que vous accordez sont les droits dont dispose InfraNest. 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 réglée sur États-Unis.
• Pour révoquer l’accès, allez dans votre compte OVHcloud, dans la section des clés API, et supprimez l’entrée. La connexion dans InfraNest commencera alors à signaler des erreurs, ce qui est l’effet recherché.

#Dépannage

• « Authentication failed » — vérifiez que la région correspond bien à celle où les clés ont été créées, et que les trois valeurs ont été collées sans espaces superflus.
• Les lectures fonctionnent mais les modifications échouent — vous n’avez probablement accordé que GET. Créez un nouveau jeu de clés à partir du lien avec les quatre méthodes sur /domain/* (et sur /vps/* pour les actions serveur).

#Pour les administrateurs : activer « Connecter avec OVHcloud »

Cette partie s’adresse à la personne qui gère la plateforme InfraNest.

Un compte de service ne fonctionnera pas. Le panneau de contrôle OVHcloud propose des comptes de service, qui s’authentifient de machine à machine et n’ont aucun champ pour une URL de rappel — y envoyer un utilisateur affiche une page « You are logged in as… » avec un bouton Customer Center au lieu d’un bouton Allow, car personne ne se voit demander une autorisation.

Ce dont vous avez besoin, c’est d’un client OAuth2 utilisant le flux par code d’autorisation, 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. Recherchez POST /me/api/oauth2/client et sélectionnez Authenticate (une connexion via navigateur ; aucune clé requise).
3. Envoyez une requête en nommant le client, en le décrivant, en réglant le flux sur AUTHORIZATION_CODE, et en indiquant l’URL de rappel affichée dans Panneau d'administration → Intégrations → OVHcloud (un bouton de copie se trouve à 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 laissées vides continuent simplement d’utiliser la méthode par clé API décrite ci-dessus.

Rien d’autre n’est requis du côté du client — approuver la connexion suffit.

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écidées au moment où quelqu’un approuve la connexion, donc une connexion plus ancienne ne peut pas être réparée sur place — déconnectez-la et reconnectez-vous.