Integrando seu contrato de SaaS com o produto com pay-as-you-go AWS Marketplace - AWS Marketplace
Cenário: seu serviço valida novos clientesCenário: seu serviço lida com as solicitações dos clientesCenário: uso do medidorCenário: monitorar as alterações nos direitos do usuárioTeste da integração de produtos contratuais de SaaS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integrando seu contrato de SaaS com o produto com pay-as-you-go AWS Marketplace

Integrar seu produto com AWS Marketplace é um passo à frenteCriando um produto SaaS em AWS Marketplace. Para integrar seu produto contratual de software como serviço (SaaS) AWS Marketplace, você deve escrever um código e demonstrar que ele pode responder com êxito a vários cenários de clientes. As seções a seguir descrevem esses cenários, explicam como responder a eles e fornecem uma visão geral sobre como testar sua integração.

nota

Antes de começar, certifique-se de ter escolhido o modelo de definição de preço certo para o seu produto de software como serviço (SaaS) no AWS Marketplace. Para obter mais informações, consulte Planejando seu produto SaaS.

Cenário: seu serviço valida novos clientes

Quando um cliente assina seu produto, ele é redirecionado para seu cadastroURL, que é uma HTTP POST solicitação com um token temporáriox-amzn-marketplace-token. Responda a essa solicitação das seguintes maneiras:

  1. Troque o token por um CustomerIdentifierCustomerAWSAccountId,, e ProductCode chamando a ResolveCustomer API operação no AWS Marketplace Metering Service.

  2. Verifique a assinatura e a quantidade (se aplicável) à qual o cliente tem acesso chamando a ação GetEntitlements no AWS Marketplace Entitlement Service.

  3. Mantenha CustomerIdentifier, CustomerAWSAccountId e ProductCode em seu sistema para futuras chamadas. Armazene se o cliente tem uma assinatura válida, junto com as informações de que você precisa sobre o cliente.

  4. Como resposta à solicitação, você deve mostrar a primeira experiência de uso do usuário (conforme aplicável ao seu serviço).

Cenário: seu serviço lida com as solicitações dos clientes

Quando um cliente faz uma solicitação ao seu serviço, você deve responder aos seguintes cenários com ações ou mensagens apropriadas:

  • Eles não têm um ID de cliente em seu sistema. Isso significa que eles ainda não se inscreveram. Você deve enviar a eles uma mensagem descrevendo como assinar.

  • Eles têm um ID de cliente e a GetEntitlements API operação retorna um direito apropriado. Nesse cenário, você deve atender à solicitação.

  • Eles têm um ID de cliente, mas a GetEntitlements API operação não retorna nenhum direito ou quantidade insuficiente para atender à solicitação. Nesse cenário, você deve determinar como lidar com o acesso e gerenciar a experiência deles.

Cenário: uso do medidor

Quando o cliente começar a usar seu serviço, você deverá enviar registros de medição de hora em hora. Para obter detalhes sobre como medir, consulte Configurando a medição para uso com assinaturas SaaS.

Recomendamos que você use AWS CloudTrail para monitorar a atividade para garantir que as informações de cobrança sejam enviadas para AWS. Tenha em mente o seguinte ao enviar registros de medição:

  • A duplicação de solicitações de medição são eliminadas em uma hora.

  • Os registros enviados a cada hora são cumulativos.

  • Como prática recomendada, mesmo que não haja registros na última hora, recomendamos que você envie registros de medição a cada hora, com uso 0.

Cenário: monitorar as alterações nos direitos do usuário

Configure uma fila do Amazon Simple Queue Service (AmazonSQS) e assine os tópicos do seu produto na Amazon SNS — há dois SNS tópicos, um para alterações de direitos e outro para alterações de assinatura. As informações do seu tópico foram incluídas na mensagem de e-mail que você recebeu da equipe de operações do AWS Marketplace vendedor quando criou seu produto. Para obter mais informações, consulte Criando um produto SaaS em AWS Marketplace. Ao assinar seus SNS tópicos, você recebe notificações sobre alterações nas assinaturas de clientes, incluindo o fornecimento ou a revogação do acesso a clientes específicos.

nota

Parece um SNS tópico Amazon Resource Name (ARN) para uma alteração de assinaturaarn:aws:sns:us-east-1:<account id>:aws-mp-subscription-notification-<product code>. Parece um SNS tópico ARN para alterações de direitos. arn:aws:sns:us-east-1:<account id>:aws-mp-entitlement-notification-<product code>

As notificações às quais você deve responder são as seguintes:

  • entitlement-updated(no SNS tópico de direitos) — O direito do cliente foi alterado e você deve chamar a GetEntitlements API operação para ver o novo status. Atualize sua loja de clientes e, se aplicável (por exemplo, o contrato do cliente expirou), siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.

  • subscribe-success(no SNS tópico de assinatura) — O cliente está inscrito e você pode medir com sucesso o ID do cliente.

  • unsubscribe-pending(no SNS tópico de assinatura) — O cliente está cancelando a assinatura. Você deve enviar todos os últimos registros de medição.

  • unsubscribe-success(no SNS tópico de assinatura) — O cliente cancelou a assinatura. Os registros de medição do cliente não serão mais aceitos. Siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.

  • subscribe-fail(no SNS tópico de assinatura) — A assinatura do cliente falhou. Você não deve comparar o ID do cliente nem ativar recursos em nome do cliente.

nota

Para obter informações adicionais, consulte Verificando direitos usando o AWS Marketplace Entitlement Service.

Teste da integração de produtos contratuais de SaaS

Depois de integrar seu contrato ao pay-as-you-go produto com AWS Marketplace, você deve realizar testes detalhados para garantir que a integração seja bem-sucedida. O procedimento a seguir descreve as etapas para verificar a integração do produto.

nota

Use suas próprias contas para assinar o produto e testar se a integração foi bem-sucedida. Os preços podem ser temporariamente reduzidos para permitir que você teste o fluxo de compra sem incorrer em altas taxas nessas contas. Para obter mais informações sobre como reduzir temporariamente os preços ou permitir que contas de teste adicionais acessem seu produto, entre em contato com a equipe de operações do vendedor do AWS Marketplace.

Depois que seu produto for lançado, o serviço deve continuar respondendo a esses cenários para novos clientes.

  1. Use uma conta permitida para testar a experiência do cliente obtendo um contrato para seu produto.

  2. Depois que a conta tiver o contrato, certifique-se de que a conta seja redirecionada para o registro URL e que o redirecionamento seja uma POST solicitação que inclua um token temporário. Certifique-se de que seu aplicativo mantenha o ID do cliente para futuras chamadas e gerencie corretamente os direitos que o cliente tem. Isso testa parte do Cenário: seu serviço valida novos clientes.

  3. Depois de verificar a conta de teste na etapa anterior, incorpore a conta em seu aplicativo. Por exemplo, você pode fazer com que o cliente de teste preencha um formulário para criar um novo usuário. Ou forneça outras próximas etapas para obter acesso ao seu aplicativo SaaS. Isso testa parte do Cenário: seu serviço valida novos clientes.

  4. Se nenhum direito for devolvido da GetEntitlements API operação, seja durante a integração ou em seus passes de verificação em andamento, seu aplicativo deverá gerenciar corretamente o acesso e a experiência dos usuários que não têm direito. Isso testa Cenário: seu serviço lida com as solicitações dos clientes.

  5. Depois que o cliente de teste estiver integrado, faça solicitações que enviarão registros de medição AWS para fins de cobrança usando a operação no BatchMeterUsageAPI. AWS Marketplace Metering Service Isso testa Cenário: uso do medidor.

  6. Teste as alterações na assinatura. Verifique se seu aplicativo lida corretamente com cancelamentos de assinaturas, assinaturas bem-sucedidas e cenários de falha na assinatura. Isso testa Cenário: monitorar as alterações nos direitos do usuário.

  7. Depois de concluir todos os requisitos de integração e testar a solução, notifique a equipe de operações do AWS Marketplace vendedor. Em seguida, eles testarão a solução verificando se você ligou com sucesso para a GetEntitlements API operação e se integrou suficientemente novos clientes. Eles também verificarão se você enviou com sucesso os registros medidos com a BatchMeterUsage API operação.

Depois que a integração e o teste estiverem concluídos, você poderá realizar uma análise final e publicar seu produto no público AWS Marketplace. Para obter mais informações, consulte Criando um produto SaaS em AWS Marketplace.