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

s’applique à: Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis

Cet article décrit les comptes que vous devez développer sur le Kit de développement logiciel (SDK) de l’Espace partenaires. Cet article explique également comment créer un compte bac à sable d’intégration et effectuer des tests dans le bac à sable d’intégration.

Comprendre les définitions de compte

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

Compte partenaire principal

Ce compte est l’endroit où vous créez des commandes réelles pour les 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 sont traités comme des commandes officielles pour les clients réels. Elles sont reflétées dans votre facture, et votre entreprise est responsable de leur paiement.

Compte bac à sable d’intégration

Ce compte est destiné à tester votre code et son intégration aux API de l’Espace partenaires avant de le déployer à grande échelle. Les modifications et les transactions que vous effectuez lorsque vous êtes connecté au compte de bac à sable d’intégration apparaissent dans votre facture, mais vous n’avez pas à payer le montant de la facture. La facture pdf contient une clause d’exclusion de responsabilité : « NE PAS PAYER. IL S’AGIT D’UNE FACTURE BAC À SABLE (SANDBOX) ET AUCUNE ACTION N’EST REQUISE.

• Le compte bac à sable d’intégration et le compte principal agissent indépendamment. Ils ne partagent pas de comptes d’administrateur, de comptes d’utilisateur, de clients, de commandes, d’abonnements ou d’autres données.
• La sandbox d'intégration prend en charge les transactions avec un nombre limité de clients, commandes, abonnements, licences, etc.
• Les comptes sandbox d’intégration doivent uniquement être utilisés pour tester l’intégration par stratégie.
• Aucun compte d'intégration en bac à sable n'existe par défaut. Vous devez en créer un vous-même si vous envisagez d’utiliser le Kit de développement logiciel (SDK) de l’Espace partenaires.

Configurer vos comptes

Cette section explique comment configurer un compte partenaire principal et un compte bac à sable d’intégration pour le Kit de développement logiciel (SDK) de l’Espace partenaires.

Créer un bac à sable d’intégration

Pour créer un bac à sable d’intégration, suivez les étapes décrites dans Créer un compte de bac à sable d’intégration de fournisseur de solutions cloud (CSP).

Activer l’accès aux API

Une fois votre compte configuré, vous devez activer l’accès aux API avant de pouvoir utiliser le Kit de développement logiciel (SDK) de l’Espace partenaires avec le bac à sable d’intégration. Vous devez activer l’accès à l’API séparément pour votre compte partenaire principal et votre compte de bac à sable d’intégration.

1. Connectez-vous à Espace partenaires avec un compte d’administrateur général, puis sélectionnez Paramètres (icône d’engrenage).
2. Sélectionnez paramètres de compte, puis de gestion des applications.
3. Si vous n’avez pas encore d’application existante, ajoutez une nouvelle application web. Si vous disposez d’une application web existante, choisissez le bouton Ajouter une clé .
4. Copiez les informations d’inscription de l’application, en particulier la clé si vous créez une application web et stockez-la dans un endroit sûr.
5. Déconnectez-vous du tableau de bord du partenaire.
6. Reconnectez-vous avec votre compte sandbox d’intégration. Répétez les étapes 2 à 5 pour activer l’accès aux API dans le bac à sable d’intégration.

Écrire et tester du code

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

• ID d’application / ID client: Listé comme ID d’application enregistré dans Paramètres (icône d’engrenage) >Paramètres du compte>Gestion des applications.
• Clé : si vous avez créé une application web dans la section précédente, utilisez cette clé.
• Domaine : concerne le bac à sable d’intégration.

Exécuter le code testé

Pour utiliser votre solution avec des données client réelles, vous devez passer de vos informations d’identification de bac à sable d’intégration à vos informations d’identification de compte partenaire principal.

Lorsque vous êtes prêt à utiliser votre code testé dans votre compte partenaire principal, vous avez besoin d’un jeton de sécurité Microsoft Entra. Ce jeton de sécurité est basé sur votre application, clé et domaine du Centre de partenaires (plutôt que sur votre application, clé et domaine du bac à sable d’intégration ).

1. Suivez les étapes de l’authentification de l’Espace partenaires () pour obtenir un jeton de sécurité Microsoft Entra en utilisant vos informations d'identification principales de cet espace. (Vous avez précédemment suivi ces étapes pour obtenir un jeton de sécurité Microsoft Entra pour votre bac à sable d’intégration.)
2. Remplacez le jeton de sécurité d’intégration dans votre code par le nouveau jeton de sécurité de votre compte partenaire principal.

Contenu connexe

• Documentation pour les développeurs de l’Espace partenaires
• Commencer avec les API du Centre de partenaires
• Exemples avec l’API de l’Espace partenaires