Intégration de client SaaS

Avec les abonnements au logiciel en tant que service (SaaS) et les contrats SaaS, vos clients s'abonnent à vos produits par le biais de votre AWS environnement, AWS Marketplace mais y accèdent. Après s'être abonné au produit, votre client est dirigé vers un site web créé et géré par vous dans le cadre de votre produit SaaS pour enregistrer son compte et configurer le produit.

Lorsque vous créez votre liste de produits SaaS, vous fournissez une URL vers votre page d'accueil d'enregistrement. Nous utilisons cette URL pour rediriger les clients vers votre page d'enregistrement dès lors qu'ils s'abonnent. Sur la page d'accueil d'enregistrement de votre logiciel, vous collectez toutes les informations nécessaires pour créer un compte pour le client. Nous vous recommandons de collecter les adresses e-mail de votre client si vous prévoyez de le contacter par e-mail dans le cadre des notifications d'utilisation.

La page d'accueil de l'inscription doit être en mesure d'identifier et d'accepter le x-amzn-marketplace-token jeton dans les données du formulaire AWS Marketplace contenant l'identifiant du client pour la facturation. Il doit ensuite transmettre cette valeur de jeton AWS Marketplace Metering Service à la résolution de l'identifiant client unique, de l' Compte AWS identifiant client et du code produit correspondant. Pour obtenir un exemple de code, consultez ResolveCustomerexemple de code.

Note

Le jeton d'enregistrement est attribué à un client abonné spécifique et chaque jeton généré a une période d'expiration de 4 heures. Tant que l'appelant appelle l'API avec le même jeton, il continuera à renvoyer les mêmes valeurs de réponse jusqu'à l'expiration du jeton.

Configuration de votre produit SaaS afin qu'il accepte de nouveaux acheteurs

Vous êtes responsable de la configuration correcte de votre logiciel SaaS pour accepter de nouveaux clients et les mesurer de manière appropriée. Le processus suivant décrit une méthode recommandée pour identifier, mettre en œuvre et mesurer l'accès d'un nouveau client à votre logiciel :

1. Lorsqu'un client visite la page de votre produit sur le AWS Marketplace site Web, il choisit de s'abonner à votre produit.

2. Le client Compte AWS est abonné à votre produit. Cela signifie que les relevés d'abonnement et de mesure envoyés à partir de votre produit font partie de la AWS facture du client.

3. Un jeton d'enregistrement est généré pour le client. Il contient son identifiant client et le code de votre produit.

4. Le client est redirigé vers la page d'accueil d'enregistrement de votre logiciel. Cette page doit accepter le jeton avec l'identifiant du client.

5. Le navigateur du client envoie une POST demande à l'URL de la page d'accueil d'enregistrement de votre logiciel. La demande contient un POST paramètre contenant x-amzn-marketplace-token le jeton d'enregistrement du client. Du point de vue de votre site web d'inscription, le client a envoyé un formulaire avec ce paramètre. Le jeton d'inscription est une chaîne opaque. Si le type d'offre est un essai gratuit, un deuxième paramètre, x-amzn-marketplace-offer-type avec la valeurfree-trial, sera ajouté à la demande.

6. Pour échanger ce jeton d'enregistrement contre un identifiant client, un Compte AWS identifiant client et un code produit, votre site Web doit faire appel ResolveCustomerau service de mesure AWS Marketplace. L'identifiant du client n'est pas l' Compte AWS identifiant du client, mais il est universel pour tous les produits et doit être enregistré dans une source interne dans le cadre de vos dossiers clients. Le code produit est une chaîne unique que votre produit SaaS vous AWS fournit. Chaque AWS produit possède un code produit unique, qui vous est attribué lors de l'enregistrement.

   Note

   Pour voir un exemple d'ResolveCustomerappel, voirResolveCustomerexemple de code.

7. Le client reçoit pour instruction de créer un compte dans votre produit ou de se connecter à un compte existant.

   Note

   Si la création ou l'établissement d'un lien vers un compte client existant dans votre produit nécessite un processus manuel de la part de votre équipe, vous pouvez utiliser un formulaire de contact pour recueillir les coordonnées du client. Après avoir collecté leurs coordonnées et résolu leur identifiant client AWS Marketplace unique (tel qu'obtenu à l'étape 6), affichez un message de notification pour le client. Dans la notification, indiquez que leur compte est en cours de création et demandez-leur d'attendre que vous les contactiez. Fournissez au client le délai d'exécution prévu et vos coordonnées. Envoyez également un e-mail au client avec les mêmes informations.

8. Le client est maintenant connecté à votre site web à l'aide des informations d'identification spécifiques à ce produit SaaS. Dans la base de données de vos comptes, vous pouvez avoir une entrée pour chaque client. La base de données de vos comptes doit comporter une colonne pour l'identifiant AWS client, que vous renseignez à l'aide de l'identificateur client que vous avez obtenu à l'étape 6. Vérifiez qu'aucun autre compte dans votre système n'utilise cet identifiant de client. Pour les clients qui s'abonnent à plusieurs produits par le biais de ce service AWS Marketplace, l'identifiant du client restera le même, chaque abonnement étant associé à un code produit unique.

9. Au cours de votre processus d'inscription en tant que vendeur, vous vous abonnez aux rubriques Amazon SNS qui vous informent lorsque des clients s'abonnent ou se désabonnent à votre produit. Voici les notifications Amazon SNS au format JSON qui vous informent des actions du client :

   • Notification d'éligibilité : pour les produits dont les modèles de tarification incluent un contrat, vous êtes averti lorsque les acheteurs créent un nouveau contrat, le mettent à niveau, le renouvellent ou expirent. La base de données de vos comptes doit comporter une colonne supplémentaire pour l'état de l'abonnement. Pour plus d’informations, consultez Rubrique Amazon SNS : aws-mp-entitlement-notification.

   • Notification d'abonnement — Pour les produits quel que soit le modèle de tarification, y compris les contrats et les abonnements, vous êtes averti lorsqu'un acheteur s'abonne ou se désabonne à un produit. Pour plus d’informations, consultez Rubrique Amazon SNS : aws-mp-subscription-notification.

   Nous vous recommandons d'utiliser Amazon Simple Queue Service (Amazon SQS) pour capturer ces messages. Lorsque vous recevez une notification d'abonnement indiquant subscribe-success, cela signifie qu'il est possible d'effectuer des mesures sur le compte client. Les enregistrements que vous envoyez avant cette notification ne sont pas mesurés. Pour plus d'informations sur la procédure à suivre, consultez l'étape 2 : Autoriser la rubrique Amazon SNS à envoyer des messages à la file d'attente Amazon SQS dans le manuel du développeur Amazon Simple Notification Service.

   Note

   N'activez pas un abonnement à un produit sauf si vous recevez une notification subscribe-success.

10. Utilisez l'identifiant client enregistré dans votre base de données pour mesurer la consommation via le service de mesure AWS Marketplace ou vérifiez les droits via le. AWS Marketplace Entitlement Service

Sécurité et commandes

En tant que vendeur, il est de votre responsabilité de ne faire confiance qu'aux identifiants clients qui vous sont immédiatement renvoyés AWS ou à ceux que votre système a signés. Nous vous recommandons de supprimer le jeton d'enregistrement immédiatement car il peut expirer au bout d'une heure environ. Après la résolution du jeton d'inscription, stockez l'identifiant client en tant qu'attribut signé sur la session de navigateur du client jusqu'à la fin de l'inscription.