Intégrer votre contrat SaaS à votre pay-as-you-go produit avec AWS Marketplace - AWS Marketplace
Scénario : votre service valide les nouveaux clientsScénario : votre service gère les demandes des clientsScénario : utilisation du compteurScénario : surveiller les modifications apportées aux droits des utilisateursTester l'intégration de votre contrat SaaS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégrer votre contrat SaaS à votre pay-as-you-go produit avec AWS Marketplace

L'intégration de votre produit ne AWS Marketplace constitue qu'une étapeCréation d'un produit SaaS dans AWS Marketplace. Pour intégrer votre produit contractuel de logiciel en tant que service (SaaS) AWS Marketplace, vous devez écrire du code et démontrer qu'il peut répondre avec succès à plusieurs scénarios clients. Les sections suivantes décrivent ces scénarios, expliquent comment y répondre et fournissent une vue d'ensemble du test de votre intégration.

Note

Avant de commencer, assurez-vous d'avoir choisi le bon modèle de tarification pour votre produit SaaS (logiciel en tant que service) AWS Marketplace. Pour de plus amples informations, veuillez consulter Planification de votre produit SaaS.

Scénario : votre service valide les nouveaux clients

Lorsqu'un client s'abonne à votre produit, il est redirigé vers votre inscriptionURL, qui est une HTTP POST demande avec un x-amzn-marketplace-token jeton temporaire. Répondez à cette demande de la manière suivante :

  1. Échangez le jeton contre un CustomerIdentifierCustomerAWSAccountId, et ProductCode en appelant l' ResolveCustomerAPIopération dans le AWS Marketplace Metering Service.

  2. Vérifiez l'abonnement et la quantité (le cas échéant) auxquels le client a accès en exécutant l' GetEntitlementsaction indiquée dans le AWS Marketplace Entitlement Service.

  3. Maintenez le CustomerIdentifierCustomerAWSAccountId, et ProductCode dans votre système pour les futurs appels. Indiquez si le client possède un abonnement valide, ainsi que toutes les informations dont vous avez besoin à son sujet.

  4. En réponse à la demande, vous devez montrer la première expérience d'utilisation de votre utilisateur (le cas échéant pour votre service).

Scénario : votre service gère les demandes des clients

Lorsqu'un client adresse une demande à votre service, vous devez répondre aux scénarios suivants par des actions ou des messages appropriés :

  • Ils n'ont pas d'identifiant client dans votre système. Cela signifie qu'ils ne sont pas encore abonnés. Vous devez leur envoyer un message expliquant comment s'abonner.

  • Ils disposent d'un identifiant client et l'GetEntitlementsAPIopération renvoie un droit approprié. Dans ce scénario, vous devez répondre à la demande.

  • Ils ont un numéro de client, mais l'GetEntitlementsAPIopération ne renvoie aucun droit ou une quantité insuffisante pour répondre à la demande. Dans ce scénario, vous devez déterminer comment gérer l'accès et gérer leur expérience.

Scénario : utilisation du compteur

Lorsque le client commence à utiliser votre service, vous devez envoyer des relevés de mesure toutes les heures. Pour plus de détails sur la façon de mesurer, voirConfiguration de la mesure de l'utilisation avec des abonnements SaaS.

Nous vous recommandons de l'utiliser AWS CloudTrail pour surveiller l'activité afin de vous assurer que les informations de facturation sont envoyées à AWS. Gardez les éléments suivants à l'esprit lorsque vous envoyez des enregistrements de mesure :

  • Les demandes de mesure sont dédupliquées à l'heure.

  • Les enregistrements envoyés toutes les heures sont cumulatifs.

  • Nous vous recommandons vivement, comme bonne pratique, d'envoyer des relevés de mesure toutes les heures, même s'il n'y a eu aucun enregistrement au cours de la dernière heure, avec une utilisation de 0.

Scénario : surveiller les modifications apportées aux droits des utilisateurs

Configurez une file d'attente Amazon Simple Queue Service (AmazonSQS) et abonnez-vous aux rubriques Amazon de votre produit. SNS Il existe deux SNS rubriques, l'une pour les modifications des droits et l'autre pour les modifications d'abonnement. Les informations relatives à votre sujet ont été incluses dans le message électronique que vous avez reçu de l'équipe chargée des opérations AWS Marketplace vendeurs lorsque vous avez créé votre produit. Pour de plus amples informations, veuillez consulter Création d'un produit SaaS dans AWS Marketplace. En vous abonnant à vos SNS sujets, vous recevez des notifications concernant les modifications apportées aux abonnements des clients, notamment l'octroi ou la révocation de l'accès à des clients spécifiques.

Note

Un SNS sujet auquel ressemble Amazon Resource Name (ARN) pour un changement d'abonnementarn:aws:sns:us-east-1:<account id>:aws-mp-subscription-notification-<product code>. Un SNS sujet ARN de modification des droits ressemble arn:aws:sns:us-east-1:<account id>:aws-mp-entitlement-notification-<product code> à.

Les notifications auxquelles vous devez répondre sont les suivantes :

  • entitlement-updated(dans la SNS rubrique relative aux droits) — Les droits du client ont changé et vous devez appeler l'GetEntitlementsAPIopération pour connaître le nouveau statut. Mettez à jour votre boutique client et, le cas échéant (par exemple, le contrat du client est expiré), suivez vos pratiques en matière de fermeture des ressources clients, en respectant vos politiques de fidélisation.

  • subscribe-success(dans le SNS sujet de l'abonnement) — Le client est abonné et vous pouvez vérifier avec succès son numéro de client.

  • unsubscribe-pending(dans le SNS sujet de l'abonnement) — Le client est en train de se désinscrire. Vous devez envoyer tous les derniers relevés de mesure.

  • unsubscribe-success(dans le SNS sujet de l'abonnement) — Le client s'est désinscrit. Les relevés de mesure du client ne seront plus acceptés. Suivez vos pratiques en matière de fermeture des ressources clients, en respectant vos politiques de rétention.

  • subscribe-fail(dans le SNS sujet de l'abonnement) — L'abonnement du client a échoué. Vous ne devez pas effectuer de comptage en fonction de leur identifiant client ni activer de ressources pour le compte du client.

Note

Pour plus d’informations, consultez Vérification des droits à l'aide du AWS Marketplace Entitlement Service.

Tester l'intégration de votre contrat SaaS

Après avoir intégré votre contrat au pay-as-you-go produit avec AWS Marketplace, vous devez effectuer des tests approfondis pour vous assurer que l'intégration est réussie. La procédure suivante décrit les étapes à suivre pour vérifier l'intégration de votre produit.

Note

Utilisez vos propres comptes pour vous abonner à votre produit et vérifier que l'intégration est réussie. Les prix peuvent être temporairement réduits afin que vous puissiez tester le flux d'achat sans encourir de frais élevés sur ces comptes. Pour plus d'informations sur la réduction temporaire des prix ou sur l'autorisation de comptes de test supplémentaires pour accéder à votre produit, contactez l'équipe des opérations AWS Marketplace vendeurs.

Après le lancement de votre produit, le service doit continuer à répondre à ces scénarios pour les nouveaux clients.

  1. Utilisez un compte autorisé pour tester l'expérience client en obtenant un contrat pour votre produit.

  2. Une fois que le compte a reçu le contrat, assurez-vous qu'il est redirigé vers l'enregistrement URL et que la redirection est une POST demande incluant un jeton temporaire. Assurez-vous que votre application conserve l'identifiant du client pour les futurs appels et gère correctement les droits du client. Cela teste une partie deScénario : votre service valide les nouveaux clients.

  3. Après avoir vérifié le compte test dans l'étape précédente, intégrez le compte dans votre application. Par exemple, vous pouvez demander au client test de remplir un formulaire pour créer un nouvel utilisateur. Vous pouvez également lui fournir d'autres étapes pour accéder à votre application SaaS. Cela teste une partie deScénario : votre service valide les nouveaux clients.

  4. Si aucun droit n'est restitué à la suite de l'GetEntitlementsAPIopération, que ce soit lors de l'intégration ou dans le cadre de vos passes de vérification en cours, votre application doit gérer correctement l'accès et l'expérience des utilisateurs non autorisés. Cela testeScénario : votre service gère les demandes des clients.

  5. Une fois le client test intégré, faites des demandes qui enverront les relevés de mesure à AWS des fins de facturation en utilisant l'BatchMeterUsageAPIopération dans le. AWS Marketplace Metering Service Cela testeScénario : utilisation du compteur.

  6. Testez les modifications d'abonnement. Vérifiez que votre application gère correctement les scénarios de désabonnement, d'abonnement réussi et d'échec d'abonnement. Cela testeScénario : surveiller les modifications apportées aux droits des utilisateurs.

  7. Une fois que vous avez satisfait à toutes les exigences d'intégration et testé la solution, informez-en l'équipe des opérations des AWS Marketplace vendeurs. Ils testeront ensuite la solution en vérifiant que vous avez lancé l'GetEntitlementsAPIopération avec succès et que vous avez suffisamment intégré de nouveaux clients. Ils vérifieront également que vous avez envoyé avec succès les relevés mesurés lors de l'BatchMeterUsageAPIopération.

Une fois l'intégration et les tests terminés, vous pouvez effectuer un examen final et mettre votre produit en vente auprès du public AWS Marketplace. Pour de plus amples informations, veuillez consulter Création d'un produit SaaS dans AWS Marketplace.