Configurer l’accès aux API dans l’Espace partenaires

Article
11/28/2023

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Cet article décrit les comptes dont vous avez besoin pour développer des API à l’aide du SDK de l’Espace partenaires. Cet article explique également comment créer un compte sandbox d’intégration et effectuer des tests dans le bac à sable d’intégration.

Remarque

Pour accéder aux API, votre locataire doit être un locataire CSP et vous devez être fournisseur indirect ou partenaire de facturation directe.

Définitions des comptes

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

Compte de partenaire principal

Ce compte permet de créer des commandes réelles pour des clients réels. Si vous apportez des modifications ou des transactions lorsque vous êtes connecté au compte principal, à l’aide du Kit de développement logiciel (SDK) de l’Espace partenaires ou de l’interface utilisateur du tableau de bord du partenaire, ils seront traités comme des commandes officielles pour les clients réels. Elles seront reflétées dans votre facture, et votre entreprise est chargée de les payer.

Compte de sandbox d’intégration

Ce compte permet de tester votre code, ainsi que son intégration aux API de l’Espace partenaires, avant son déploiement général. Les modifications et les transactions que vous effectuez lorsque vous êtes connecté au compte de sandbox d’intégration figurent dans votre facture, mais vous n’avez pas à payer le montant. Dans le PDF de la facture, il sera indiqué « NE PAS PAYER. IL S’AGIT D’UNE FACTURE BAC À SABLE (SANDBOX) ET AUCUNE ACTION N’EST REQUISE. »

Le compte de sandbox d’intégration et le compte principal sont indépendants l’un de l’autre, et ne partagent pas leurs comptes d’administrateur, comptes d’utilisateur, clients, commandes, abonnements ni aucune autre donnée.

Le bac à sable d’intégration prend en charge les transactions, mais le nombre de clients, de commandes, d’abonnements et de licences est toutefois limité.

Par stratégie, les comptes sandbox d’intégration doivent uniquement être utilisés pour tester l’intégration.

Par défaut, il n’existe pas déjà de compte sandbox d’intégration. Vous devez le créer vous-même si vous prévoyez d’utiliser le SDK de l’Espace partenaires.

Configurer vos comptes

Cette section explique comment configurer un compte de partenaire principal et un compte sandbox d’intégration pour le SDK de l’Espace partenaires.

Créer un sandbox d’intégration

Connectez-vous à l’Espace partenaires avec un compte d’administrateur général, puis sélectionnez Paramètres (engrenage).

Remarque

La création d’un bac à sable nécessite que le partenaire Global Administration soit connecté à l’Espace partenaires avec son alias de domaine onmicrosoft.com (par exemple). alias@domain.onmicrosoft.com La création du bac à sable échoue si l’utilisateur est connecté avec son domaine personnalisé.
Sélectionnez Paramètres du compte, puis bac à sable d’intégration.

Remarque

Si vous ne voyez pas l’option Sandbox d’intégration, il est possible que vous n’ayez pas de compte d’administrateur général. Il est aussi possible que vous utilisiez un compte de sandbox d’intégration et qu’un sandbox d’intégration ait déjà été configuré.
Entrez les informations de contact du compte d’administrateur du sandbox d’intégration. Ensuite, choisissez Créer un compte. Un message vous confirmant la création du compte s’affiche au bout de quelques minutes.
Une fois le message affiché, vous pouvez vous déconnecter du tableau de bord du partenaire.
Reconnectez-vous avec votre nouveau compte d’administrateur de sandbox d’intégration. Veillez à utiliser le format nomutilisateur@domaine pour vos informations d’identification ainsi que le mot de passe que vous avez spécifié.
Choisissez Configurer le compte dans la page Bac à sable d’intégration pour terminer la configuration du compte de bac à sable.

Activer l’accès API

Une fois votre compte configuré, vous devez activer l’accès à l’API pour pouvoir utiliser le SDK de l’Espace partenaires avec le bac à sable (sandbox) d’intégration. L’accès API doit être activé séparément pour votre compte de partenaire principal et votre compte de sandbox d’intégration.

Connectez-vous à l’Espace partenaires avec un compte d’administrateur général, puis sélectionnez Paramètres (engrenage).
Sélectionnez Paramètres du compte, puis gestion des applications.
Si vous ne disposez d’aucune application existante, ajoutez une nouvelle application web. Si vous disposez d’une application web existante, choisissez le bouton Ajouter une clé.
Copiez les informations d’inscription de l’application (notamment la clé si vous créez une application web) et stockez-les dans un emplacement sécurisé.
Déconnectez-vous du tableau de bord du partenaire.
Reconnectez-vous avec votre compte de sandbox d’intégration. Répétez les étapes 2 à 5 pour activer l’accès API dans le sandbox d’intégration.

Écrire et tester du code

Vous pouvez écrire et tester du code dans le sandbox d’intégration. Vous aurez besoin des informations suivantes pour configurer l’authentification de l’Espace partenaires avec l’ID Microsoft Entra.

Nom de l’élément	Emplacement de l’information
ID de l’application/ID de client	Dans Paramètres (engrenage), sélectionnez Paramètres du compte, puis Gestion des applications. L’ID d’application et l’ID client sont listés comme des ID d’application inscrite.
Clé	Si vous avez créé une application web dans la section Activer l’accès API, il s’agit de la clé que vous avez enregistrée à l’étape 5.
Domain	Domaine du sandbox d’intégration.

Exécuter le code testé

Pour utiliser votre solution avec des données client réelles, vous devez passer du compte de sandbox d’intégration au compte de partenaire principal.

Lorsque vous êtes prêt à utiliser votre code testé dans votre compte partenaire principal, vous devez obtenir un jeton de sécurité Microsoft Entra. Ce jeton de sécurité est basé sur l’application, la clé et le domaine de votre Espace partenaires (et non sur ceux de votre sandbox d’intégration).

Suivez les étapes de l’authentification de l’Espace partenaires pour obtenir un jeton de sécurité Microsoft Entra à l’aide de vos informations d’identification principales de l’Espace partenaires. (Vous avez précédemment suivi ces étapes pour obtenir un jeton de sécurité Microsoft Entra pour votre bac à sable d’intégration.)
Dans votre code, remplacez le jeton de sécurité d’intégration par le nouveau jeton de sécurité de votre compte de partenaire principal.

Partager via