Intégrez votre contrat SaaS au pay-as-you-go produit

L'intégration de votre produit ne AWS Marketplace constitue qu'une étapeCréation d'un produit SaaS. 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, 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 plus d’informations, consultez Planifiez votre produit SaaS.

Scénario : votre service valide les nouveaux clients

Lorsqu'un client s'abonne à votre produit, il est redirigé vers votre URL d'enregistrement, qui est une requête HTTP POST 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'opération ResolveCustomer d'API 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 ont un identifiant client et l'opération GetEntitlements d'API renvoie un droit approprié. Dans ce scénario, vous devez répondre à la demande.

• Ils ont un identifiant client, mais l'opération GetEntitlements API ne renvoie aucun droit ou ne renvoie pas une quantité suffisante 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, voirMesure de l'utilisation.

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 (Amazon SQS) et abonnez-vous aux rubriques Amazon SNS de votre produit. Il existe deux rubriques SNS, 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 plus d’informations, consultez Création d'un produit SaaS. En vous abonnant à vos rubriques SNS, vous recevez des notifications concernant les modifications apportées aux abonnements des clients, y compris l'octroi ou la révocation de l'accès à des clients spécifiques.

Note

Une rubrique SNS Amazon Resource Name (ARN) correspondant à un changement d'abonnement ressemble arn:aws:sns:us-east-1:<account id>:aws-mp-subscription-notification-<product code> à. Un ARN de rubrique SNS pour les modifications 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 rubrique SNS sur les droits) — Les droits du client ont changé et vous devez appeler l'opération GetEntitlements API pour voir 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 la rubrique SNS relative à l'abonnement) — Le client est abonné et vous pouvez vérifier avec succès son numéro de client.

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

• unsubscribe-success(dans la rubrique SNS d'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 la rubrique SNS 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.

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'URL d'enregistrement et que la redirection est une requête POST 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 renvoyé à la suite du fonctionnement de l'GetEntitlementsAPI, que ce soit lors de l'intégration ou lors de vos passes de vérification en cours, votre application doit gérer correctement l'accès et l'expérience des utilisateurs qui n'y ont pas droit. Cela testeScénario : votre service gère les demandes des clients.

5. Une fois le client test intégré, envoyez des demandes qui enverront les relevés de mesure à AWS des fins de facturation en utilisant l'opération BatchMeterUsage API 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 correctement appelé l'opération GetEntitlements API et que vous avez suffisamment intégré de nouveaux clients. Ils vérifieront également que vous avez correctement envoyé des enregistrements mesurés avec l'opération BatchMeterUsage API.

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 plus d'informations, voir Création d'un produit SaaS.