Configurer l’accès API Openprovider

Créez un utilisateur dédié sur Openprovider pour qu’InfraNest puisse se connecter — ce guide s’adresse à toute personne connectant un compte Openprovider à InfraNest pour la gestion de domaines.

#Vue d’ensemble

• Openprovider ne délivre pas de clés API. À la place, InfraNest se connecte en tant que l’un de vos utilisateurs Openprovider : ce que vous configurez ici est donc un utilisateur, pas une clé.
• Quatre conditions doivent être réunies avant que cet utilisateur puisse se connecter. Si l’une d’elles manque, Openprovider renvoie souvent la même erreur que pour un mot de passe incorrect, ce qui peut vous orienter vers une fausse piste.
• Suivre les vérifications ci-dessous dans l’ordre vous fera gagner du temps.

WarningVotre propre compte Openprovider a presque certainement l’authentification à deux facteurs activée, et un utilisateur avec l’authentification à deux facteurs ne peut pas du tout utiliser l’API. Créez toujours un utilisateur distinct pour InfraNest.

#Créer un utilisateur distinct pour InfraNest

1. N’utilisez pas votre propre identifiant pour cela. Si quelqu’un quitte l’équipe, ou si vous changez votre propre mot de passe, un utilisateur distinct vous permet de le modifier sans rompre la connexion.
2. Dans le panneau de contrôle Openprovider, allez dans Account.
3. Ajoutez un nouvel utilisateur pour InfraNest.
4. Donnez-lui un mot de passe que vous n’avez utilisé nulle part ailleurs — vous le coller ez bientôt dans InfraNest.

#Activer l’accès API pour cet utilisateur

Les nouveaux utilisateurs ne peuvent pas utiliser l’API tant que vous ne l’autorisez pas.

1. Allez dans Account → Account Overview.
2. Repérez l’utilisateur que vous venez de créer et vérifiez l’indicateur API access. Vert signifie activé, rouge signifie désactivé.
3. S’il est rouge, sélectionnez le nom d’utilisateur, choisissez Edit, cochez API access Enabled, puis sélectionnez Update contact.

Ce réglage s’applique par utilisateur. L’activer pour votre propre compte ne l’active pas pour le nouveau.

#Ne configurez pas la 2FA sur cet utilisateur

1. Laissez l’authentification à deux facteurs désactivée pour l’utilisateur InfraNest que vous avez créé.
2. Conservez l’authentification à deux facteurs de votre propre compte telle quelle — cela ne concerne que le nouvel utilisateur.

Un utilisateur avec l’authentification à deux facteurs activée peut toujours se connecter au panneau de contrôle, mais ne peut pas obtenir de jeton d’API. L’erreur d’Openprovider ne mentionnera pas directement l’authentification à deux facteurs ; InfraNest vous indiquera simplement qu’un réglage du compte bloque la connexion.

#Autoriser notre adresse IP

Openprovider peut restreindre l’accès API à des adresses particulières, et InfraNest se connecte toujours depuis une adresse fixe.

1. Ouvrez les réglages du même utilisateur et repérez l’API white list.
2. Ajoutez l’adresse IP qu’InfraNest vous indique sur l’écran de connexion, dans la ligne Allow this IP at the provider : …. Il s’agit d’une adresse IPv4, et c’est l’adresse depuis laquelle InfraNest se connecte toujours à Openprovider.

NoteOpenprovider conserve cette liste par utilisateur et par niveau d’accès. Cela signifie que vous pouvez autoriser notre adresse pour l’API tout en gardant vos propres connexions au panneau de contrôle restreintes à votre bureau.

Si la liste blanche nous bloque, Openprovider renvoie une erreur différente — « Access denied » plutôt que « Authentication/Authorization Failed » — et InfraNest vous indiquera qu’il s’agit de l’adresse IP plutôt que du mot de passe.

#Connecter Openprovider

1. Retournez sur InfraNest.
2. Ouvrez Intégrations.
3. Sélectionnez Openprovider.
4. Saisissez le nom d’utilisateur et le mot de passe de l’utilisateur que vous avez créé.

#Dépannage

Si la connexion échoue toujours, procédez aux vérifications suivantes dans l’ordre — ce sont les quatre causes possibles, de la plus fréquente à la moins fréquente :

1. L’accès API est désactivé pour cet utilisateur. C’est la cause la plus fréquente, car il est désactivé par défaut.
2. L’authentification à deux facteurs est configurée sur cet utilisateur. Supprimez-la, ou créez un utilisateur qui ne l’a jamais eue.
3. Notre adresse IP n’est pas dans la liste blanche. Le conseil d’Openprovider lui-même est de vider entièrement la liste blanche jusqu’à ce que la connexion fonctionne, puis de rajouter les adresses.
4. Le mot de passe est incorrect. C’est véritablement la moins probable des quatre causes.