Configurer les comptes de l’Espace partenaires pour l’accès à l’API

Cette rubrique décrit les comptes dont vous avez besoin, la procédure de création d’un compte sandbox d’intégration et la procédure de test dans le sandbox d’intégration.

Dans cette section

Types de comptes pris en charge

Pour vous aider à intégrer et tester votre intégration à l’API, l’Espace partenaires prend en charge deux types de comptes :

Compte d’Espace Partenaires principal

Il s’agit du compte dans lequel vous créez de vraies commandes pour de vrais clients. Si vous effectuez des modifications ou des transactions lorsque vous êtes connecté au compte principal, en utilisant l’API CREST ou l’interface utilisateur de l’Espace Partenaires, elles seront traitées par Microsoft comme des commandes officielles pour de vrais clients. Elles figureront sur votre facture et votre entreprise sera tenue de s’acquitter de leur paiement.

Compte sandbox d’intégration

Ce compte est utilisé pour tester votre code et son intégration avec les API CREST avant son déploiement à grande échelle. Les modifications et les transactions effectuées lorsque vous êtes connecté au compte sandbox d’intégration n’apparaîtront pas sur votre facture.

  • Le compte sandbox d’intégration et le compte principal fonctionnent de manière indépendante et ne partagent pas les comptes d’administrateur, les comptes d’utilisateurs, les clients, les commandes, les abonnements ou d’autres données.

  • Le sandbox d’intégration prend en charge les transactions avec un nombre limité de clients, commandes, abonnements, sièges, etc.

  • La stratégie informatique prévoit que les comptes sandbox d’intégration soient uniquement utilisés à des fins de test d’intégration.

  • Par défaut, il n’y a aucune configuration de compte sandbox d’intégration. Si vous prévoyez d’utiliser l’API CREST, vous devez en créer un vous-même.

 

Configuration de vos comptes

Mt267552.wedge(fr-fr,WIN.10).gifCréer un sandbox d’intégration

  1. Connectez-vous à l’Espace Partenaires à l’aide d’un compte disposant d’autorisations d’agent d’administration. (Il s’agit du compte d’Espace Partenaires principal.)
  2. Depuis le menu Tableau de bord, sélectionnez Paramètres du compte, puis Sandbox d’intégration.

    Si vous ne voyez pas d’option Sandbox d’intégration, c’est que vous ne disposez peut-être pas d’un compte d’agent d’administration ou que le sandbox d’intégration a déjà été configuré et que vous utilisez un compte sandbox d’intégration.

  3. Renseignez les informations de contact du compte d’administrateur du sandbox d’intégration, puis cliquez sur Configurer le compte.

  4. Lorsque le message de confirmation s’affiche, déconnectez-vous de l’Espace Partenaires, puis reconnectez-vous avec votre nouveau compte d’administrateur du sandbox d’intégration, sous la forme username@domain et avec le mot de passe que vous venez d’indiquer.

  5. Acceptez le contrat de revendeur cloud Microsoft. Patientez quelques minutes pendant la configuration du compte sandbox d’intégration.

Une fois votre compte configuré, vous devez activer l’accès à l’API pour pouvoir utiliser les API CREST avec le sandbox d’intégration. Vous devez activer l’accès à l’API séparément pour votre compte d’Espace Partenaires principal et votre compte sandbox d’intégration.

Mt267552.wedge(fr-fr,WIN.10).gifActiver l’accès à l’API

  1. Connectez-vous à l’Espace Partenaires à l’aide de votre compte d’administrateur principal.

  2. Dans le menu Tableau de bord, sélectionnez Paramètres du compte, puis API.

  3. Sélectionnez une application existante ou créez-en une nouvelle avec les paramètres par défaut. Les applications existantes s’affichent uniquement si le compte Azure AD en comporte. Cliquez sur Enregistrer une application.

  4. Sur la page de confirmation, copiez les informations d’enregistrement de l’application, notamment la clé, et conservez-les en lieu sûr.

  5. Déconnectez-vous de l’Espace Partenaires, puis reconnectez-vous avec votre compte sandbox d’intégration. Répétez les étapes 2 à 4 pour activer l’accès à l’API dans le sandbox d’intégration.

Mt267552.wedge(fr-fr,WIN.10).gifÉcrire et tester le code dans le sandbox d’intégration

  1. Pour écrire du code compatible avec l’API CREST, vous devez disposer des informations suivantes :

    Nom de l’élément

    Sa localisation

    ID de l’application/du client

    Depuis le menu Tableau de bord, sélectionnez Paramètres du compte, puis API. L’ID de l’application/du client est répertorié en tant que ID de l’application enregistrée.

    Clé

    Il s’agit de la clé du sandbox d’intégration que vous avez enregistrée à l’étape 4 « Activer l’accès à l’API ».

    Domaine

    Il s’agit du domaine du sandbox d’intégration.

     

  2. Pour écrire et tester du code, vous devez configurer l’authentification auprès d’Azure AD. Pour obtenir plus d’informations et des exemples de code, voir Authentification à l’Espace partenaires.

Mt267552.wedge(fr-fr,WIN.10).gifExécuter le code testé avec votre compte d’Espace Partenaires principal

  1. Lorsque vous êtes prêt à utiliser le code testé dans votre compte d’Espace partenaires principal, vous devez disposer d’un jeton de sécurité Azure AD basé sur l’application/la clé/le domaine de votre Espace partenaires et non sur l’application/la clé/le domaine du sandbox d’intégration.

    Répétez les mêmes étapes que celles que vous avez suivies pour obtenir un jeton de sécurité Azure AD dans le sandbox d’intégration, en utilisant à la place vos informations de connexion au compte d’Espace partenaires principal.

  2. Une fois que vous avez remplacé le jeton de sécurité d’intégration de votre compte d’Espace partenaires principal, le reste de votre code doit fonctionner correctement.

 

 

Afficher: