Partage via


Questions courantes sur les API de traitement SaaS

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

Expérience de découverte

Une fois l’offre SaaS publiée, les utilisateurs Azure peuvent la découvrir sur 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

Si un utilisateur est intéressé par un service SaaS spécifique, il peut s'y abonner depuis la Place de marché Azure.

Qu’implique le fait pour un utilisateur Azure de souscrire une offre SaaS sur la Place de marché Azure ?

Cet utilisateur peut alors consulter les conditions d'utilisation et la déclaration de confidentialité associées au service SaaS, et accepter de payer selon les conditions de facturation que vous, l'éditeur de l'offre SaaS, avez définies sur la facture Microsoft. Les utilisateurs peuvent utiliser leur profil de paiement existant dans Azure pour payer la consommation du service SaaS.

Cette possibilité s’avère avantageuse à plusieurs égards. 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. De plus, les clients peuvent utiliser leur profil de paiement existant sans avoir à payer explicitement chaque logiciel ISV séparément.

L'utilisateur est-il automatiquement facturé lors de la souscription de l'offre ?

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 se rendre sur votre offre SaaS et confirmer la création de son 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 souscrit votre offre SaaS ?

Après avoir souscrit une offre, l'utilisateur Azure peut découvrir et gérer toutes ses offres sur Azure. Par défaut, une offre SaaS nouvellement souscrite présente l’état Provisioning, fulfillment pending (Provisionnement, en attente de traitement). 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 publier 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, Authentification unique (SSO) comme indiqué par la stratégie. La mail propriété sur la ressource utilisateur récupérée à partir de l’API Microsoft Graph vous donne 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. C’est votre seule chance d’obtenir une adresse e-mail 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 la requête. Ce jeton de courte durée est valide pendant 24 heures. Vous pouvez alors détecter la présence de ce jeton, et appeler l’API Microsoft pour obtenir plus de contexte sur celui-ci.

Flux d’abonnement du client

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

Comment identifier l'offre SaaS que l'utilisateur souscrit dans Azure ?

La réponse à l'API Resolve inclut des informations sur l'offre et le forfait associés à l'abonnement SaaS.

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

  • L’utilisateur Azure peut modifier le forfait associé à l’abonnement SaaS directement dans l’expérience SaaS, ou via la plate-forme Microsoft.

  • Des conversions peuvent être effectuées à n’importe quel stade du 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 ou annuels du plan prépayé sont calculés au prorata. Tout dépassement constaté jusqu'au moment de la conversion sera reporté sur la facture suivante. Les nouveaux dépassements seront reportés en fonction du nouveau forfait.

Remarque

Vous pouvez bloquer le passage à une version antérieure si vous ne souhaitez pas prendre en charge des chemins de conversion spécifiques.

La séquence ci-dessous montre le flux quand un client Azure change de forfait dans l’expérience SaaS :

Flux de changement du forfait d’un client

La séquence ci-dessous montre le flux lorsqu’un client Azure change de forfait dans le magasin en ligne de Microsoft :

Flux de changement de forfait dans le magasin en ligne client

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

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

La séquence ci-dessous montre 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 est la capture du flux quand un utilisateur Azure se désabonne via le magasin en ligne de Microsoft :

Un client se désabonne via 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 faire 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 Portail Azure et recherchez l’inscription d’application avec l’ID que vous avez copié à partir de l’Espace partenaires.

    Conseil

    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.

    Conseil

    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 accountEnabled la valeur true (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 de principaux de service sur 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 Portail Azure et recherchez l’inscription d’application avec l’ID que vous avez copié à partir de l’Espace partenaires.

    Conseil

    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.

    Conseil

    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 accountEnabled la valeur true (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 cette commande de création de principal de service sur az ad sp create.