Partager via


Questions courantes sur les API de traitement SaaS

Cet article décrit plusieurs des exigences d’intégration de la Place de marché commerciale Microsoft pour permettre aux clients Azure de s’abonner aux offres SaaS.

Expérience de découverte

Une fois qu’une offre SaaS est publiée, les utilisateurs Azure peuvent le découvrir dans la Place de marché Azure. Vos clients peuvent filtrer les offres en fonction du type de produit (SaaS) et découvrir les services SaaS qui les intéressent.

Expérience d’achat

Une fois qu’un utilisateur s’intéresse à un service SaaS spécifique, l’utilisateur peut s’y abonner à partir de la Place de marché Azure.

Qu’est-ce que cela signifie pour qu’un utilisateur Azure s’abonne à une offre SaaS dans la Place de marché Azure ?

Cela signifie qu’un utilisateur peut afficher les conditions d’utilisation et la déclaration de confidentialité associées au service SaaS et accepter de le payer conformément aux conditions de facturation définies par vous, l’éditeur de l’offre SaaS, sur la facture de Microsoft. Les utilisateurs peuvent utiliser leur profil de paiement existant dans Azure pour payer la consommation du service SaaS.

Cette capacité est bénéfique de plusieurs façons. Les clients peuvent désormais découvrir et s’abonner à un seul endroit à l’aide de Microsoft Cloud Platform en tant que source approuvée, sans avoir à vérifier chaque logiciel indépendant fournisseur de logiciels (ISV) qu’il envisage d’utiliser. En outre, les clients peuvent utiliser leur profil de paiement existant sans avoir à payer explicitement chaque logiciel ISV indépendamment.

L’utilisateur est-il facturé automatiquement lorsque l’offre est abonnée ?

Lors de l’abonnement à l’offre SaaS, l’utilisateur accepte de payer pour la consommation du service SaaS via la plateforme Microsoft. Toutefois, les frais commencent uniquement lorsque l’offre est consommée. L’utilisateur doit accéder à votre offre SaaS et confirmer la création du compte pour commencer à consommer l’offre. Vous informerez ensuite Microsoft de commencer la facturation pour cet abonnement SaaS client.

Comment êtes-vous averti lorsqu’un utilisateur s’abonne à votre offre SaaS ?

Après l’abonnement à une offre, l’utilisateur Azure peut découvrir et gérer toutes ses offres dans Azure. Par défaut, l’état d’une offre SaaS nouvellement abonnée s’affiche comme approvisionnement, traitement en attente de. Dans cet état, l’utilisateur Azure est invité à effectuer une action pour Configurer le compte, afin d’accéder à son expérience de gestion des abonnements SaaS dans le portail Azure.

Lorsque l’utilisateur sélectionne Configurer le compte, il est redirigé vers le site web du service SaaS. L’éditeur a configuré l’URL au moment de la publication de l’offre. Cette page est appelée page d’accueil de l’éditeur. Les utilisateurs Azure se connectent à la page d’accueil SaaS en fonction de leurs informations d’identification Microsoft Entra existantes dans Azure.

Important

Vous devez vous connecter à l’utilisateur d’achat à l’aide de l’ID Microsoft Entra, de l’authentification unique (SSO) comme indiqué par la stratégie . La propriété mail sur la ressource utilisateur récupérée à partir de l’API Microsoft Graph vous fournit les informations de contact pour le cas de l’ID Microsoft Entra et userPrincipalName pour MSA. Il est possible que le champ « courrier » soit vide pour l’ID Microsoft Entra et que l’utilisateur n’ait pas d’e-mail enregistré. Dans ce cas, nous vous recommandons de détecter cela et de demander un e-mail de contact. Il s’agit de votre seule chance d’obtenir un e-mail de contact pour contacter un client pendant ou après le processus d’intégration du client.

Lorsque l’utilisateur Azure est redirigé vers la page d’accueil, un jeton est ajouté à l’URL de requête. Ce jeton est de courte durée et valide pendant une durée de 24 heures. Vous pouvez ensuite détecter la présence de ce jeton et appeler l’API Microsoft pour obtenir plus de contexte associé au jeton.

flux d’abonnement client

Pour plus d’informations sur le contrat d’API pour la gestion des scénarios de transaction dans le cycle de vie d’une offre SaaS, consultez API de traitement SaaS.

Comment connaissez-vous l’offre SaaS à laquelle l’utilisateur s’abonne dans Azure ?

La réponse à l’API Resolve inclut les informations d’offre et de plan associées à l’abonnement SaaS.

Comment l’utilisateur Azure peut-il modifier le plan associé à cet abonnement Azure ?

  • L’utilisateur Azure peut modifier le plan associé à l’abonnement SaaS directement dans l’expérience SaaS ou via la plateforme Microsoft.

  • Les conversions peuvent être effectuées à tout moment dans le cycle de facturation. Vous êtes invité à accuser réception de toute conversion, qui devient effective lors de l’accusé de réception.

  • Les tarifs mensuels ( mensuels ou ) sont calculés au prorata. Tout dépassement émis jusqu’au moment de la conversion sera facturé dans la facture suivante. De nouvelles dépassements seront émises en fonction du nouveau plan.

Note

Vous pouvez bloquer les rétrogradations si vous ne souhaitez pas prendre en charge des chemins de conversion spécifiques.

La séquence ci-dessous capture le flux lorsqu’un client Azure modifie un plan dans l’expérience SaaS :

flux de modification du plan client

La séquence ci-dessous capture le flux lorsqu’un client Azure modifie un plan dans le magasin en ligne de Microsoft :

flux de modification du plan de magasin en ligne client

Comment l’utilisateur Azure peut-il se désabonner du plan associé à l’abonnement Azure ?

Un utilisateur Azure peut se désabonner d’une offre SaaS achetée directement dans l’expérience SaaS ou via la plateforme Microsoft. Une fois que l’utilisateur se désabonne, il ne sera plus facturé à partir du prochain cycle de facturation.

La séquence ci-dessous capture le flux lorsqu’un client Azure se désabonne de l’offre SaaS dans l’expérience SaaS :

le client se désabonne dans l’expérience SaaS

La séquence ci-dessous capture le flux lorsque l’utilisateur Azure se désabonne dans le magasin en ligne de Microsoft :

clients se désabonnent dans le magasin en ligne de Microsoft

Gérer l’expérience

Un éditeur de logiciels indépendants peut gérer l’abonnement SaaS de son client et modifier ses plans.

Pour qu’un plan soit correctement converti en un autre plan au sein de la même offre, tous les éléments suivants doivent être vrais ; sinon, les appels d’API de traitement SaaS de votre plan de modification peuvent ne pas fonctionner :

  • Le plan cible doit être actif.
  • Le plan cible doit être pris en charge dans la région du client.
  • Si le plan cible est un plan privé, l’ID de locataire du client doit être ajouté au plan dans l’Espace partenaires et republié avant d’essayer le plan de modification.
  • Si le plan cible fait partie de la place de marché privée, le client doit autoriser la liste du plan dans sa place de marché privée avant l’exécution du plan de modification.
  • Pour les clients EA, si le paramètre BYOL est activé (ce qui signifie qu’ils ne peuvent acheter que des ressources gratuites), le plan cible ne doit pas être un plan payant.

Comment créer un principal de service pour mon application Entra ?

Votre principal de service d’application Entra est l’instance de votre inscription d’application Entra que vous créez pour votre offre SaaS. Ce principal app Service doit être créé dans le même locataire que celui que vous utilisez dans la configuration technique de l’Espace partenaires. Ces étapes peuvent vous aider à déterminer si un principal de service est créé, et si ce n’est pas le cas, comment en créer un.

Étape 1 : Identifier l’inscription de l’application.

  1. Accédez à chaque offre SaaS dans l’Espace partenaires.

  2. Accédez à sa « page Configuration technique » et enregistrez la valeur de l’ID d’application « Entra » :

    capture d’écran de la page de configuration technique de l’Espace partenaires Microsoft.

étape 2 : déterminer si le principal de service est créé ou non.

Option 1: utilisation du portail Azure

  1. Accédez à la page inscriptions d’applications du portail Azure et recherchez l’inscription d’application avec l’ID que vous avez copié à partir de l’Espace partenaires.

    Pourboire

    Vous devrez peut-être passer à « Toutes les applications » au lieu de « Applications détenues » au cas où vous n’étiez pas celui qui crée l’inscription d’application en premier lieu.

    Pourboire

    Le nom d’inscription de l’application se termine par « FulfilmentAppReg » s’il a été créé à l’aide du script de déploiement SaaS Accelerator.

  2. Ouvrez la page Inscription de l’application. Si vous voyez le lien avec le nom d’inscription de l’application (au lieu du lien « Créer un principal de service », comme indiqué dans la capture d’écran suivante), cela signifie que vous avez déjà créé un principal de service.

    Capture d’écran de la page Inscription d’application.

option 2: utilisation d’Azure CLI

az ad sp list --filter "appId eq '<Your-App-ID>'"

Si le principal de service est créé, vous obtenez accountEnabledtrue (comme illustré dans cette image).

Capture d’écran de l’interface de ligne de commande Azure avec les résultats créés par le principal de service.

En savoir plus sur cette commande de liste principal de service à az ad sp list.

étape 3 : création et association d’un principal de service

Option 1: utilisation du portail Azure

  1. Accédez à la page inscriptions d’applications du portail Azure et recherchez l’inscription d’application avec l’ID que vous avez copié à partir de l’Espace partenaires.

    Pourboire

    Vous devrez peut-être passer à « Toutes les applications » au lieu de « Applications détenues » au cas où vous n’étiez pas celui qui crée l’inscription d’application en premier lieu.

    Pourboire

    Le nom d’inscription de l’application se termine par « FulfilmentAppReg » s’il a été créé à l’aide du script de déploiement SaaS Accelerator.

  2. Ouvrez la page Inscription de l’application et sélectionnez le lien « Créer un principal de service » (comme illustré dans cette capture d’écran).

    Capture d’écran de la page Inscription d’application avec le lien Créer un principal de service appelé.

option 2: utilisation d’Azure CLI

az ad sp create --id <app_id>

Si le principal de service est créé, vous voyez accountEnabledtrue (comme illustré dans cette image).

Capture d’écran de l’interface de ligne de commande montrant que le principal de service est créé.

En savoir plus sur ce principal de service créer commande à az ad sp create.

  • API de service de contrôle de la Place de marché