Integrar seu produto de contrato de SaaS - AWS Marketplace
Cenário: seu serviço valida novos clientesCenário: seu serviço lida com as solicitações dos clientesCenário: monitorar as alterações nas assinaturas dos usuáriosTeste 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á.

Integrar seu produto de contrato de SaaS

Integrar seu produto com AWS Marketplace é um passo à frenteCriar um produto de SaaS. 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 sucesso a vários cenários de clientes. As seções a seguir descrevem esses cenários, 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 ter mais informações, consulte Planejamento do seu produto SaaS.

Cenário: seu serviço valida novos clientes

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

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

  2. Verifique a assinatura e a quantidade (se aplicável) à qual o cliente tem acesso chamando a operação de API 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 dizer ao usuário como se inscrever.

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

  • Eles têm um ID de cliente, mas a operação de API GetEntitlements 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: monitorar as alterações nas assinaturas dos usuários

Configure uma fila do Amazon Simple Queue Service (Amazon SQS) e assine o tópico do Amazon SNS do seu produto. As informações do tópico do SNS foram incluídas na mensagem de e-mail que você recebeu da equipe de operações do AWS Marketplace quando criou seu produto. Para ter mais informações, consulte Criar um produto de SaaS. Ao assinar o tópico do SNS, você recebe notificações sobre alterações nos direitos de clientes, incluindo o fornecimento ou a revogação do acesso de clientes específicos.

nota

Um nome do recurso da Amazon (ARN) do tópico do SNS é semelhante a arn:aws:sns:us-east-1:<account id>:aws-mp-entitlement-notification-<product code>.

A única notificação à qual você deve responder é:

  • entitlement-updated: o direito do cliente foi alterado e você deve chamar a operação de API GetEntitlements 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.

nota

Para obter informações adicionais, consulte Verificar autorizações.

Teste da integração de produtos contratuais de SaaS

Depois de integrar seu produto de contrato SaaS 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.

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, verifique se a conta é redirecionada para o URL de registro e se o redirecionamento é uma solicitação POST que inclui 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 retornado da operação de API GetEntitlements, seja durante a integração ou nas execuções de verificação contínua, 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. 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 nas assinaturas dos usuários.

  6. Depois de concluir todos os requisitos de integração e testar a solução, notifique a equipe de AWS Marketplace operações. Eles testarão a solução verificando se você chamou a operação de API GetEntitlements com sucesso e incorporou suficientemente novos clientes.

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 ter mais informações, consulte Criar um produto de SaaS. Você também pode cancelar a assinatura de teste preenchendo um Formulário de solicitação de reembolso. Para obter mais informações sobre o cancelamento de uma assinatura, consulte o AWS Marketplace processo de reembolso do produto.