Integração de clientes SaaS - AWS Marketplace

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á.

Integração de clientes SaaS

Com as assinaturas de software como serviço (SaaS) e os contratos de SaaS, seus clientes assinam seus produtos por meio do AWS Marketplace, mas acessam o produto no seu ambiente do AWS. Depois de assinar o produto, seu cliente é direcionado para um site que você cria e gerencia como parte de seu produto SaaS para registrar sua conta e configurar o produto.

Ao criar listas de produtos de SaaS, forneça um URL para a página inicial do registro. Usamos esse URL para redirecionar os clientes para sua página de destino de registro depois que eles assinam. Na página de destino de registro do software, colete todas as informações necessárias para criar uma conta para o cliente. Recomendamos coletar o endereço de e-mail do cliente se você planeja entrar em contato para enviar notificações de uso.

A página de destino de registro deve ser capaz de identificar e aceitar o token x-amzn-marketplace-token nos dados do formulário do AWS Marketplace com o identificador do cliente para cobrança. Em seguida, ela deve enviar o valor do token ao AWS Marketplace Metering Service a fim de resolver o identificador de cliente exclusivo, o ID da Conta da AWS do cliente e o código do produto correspondente. Para ver um exemplo de código, consulte Exemplo de código ResolveCustomer.

nota

O token de registro é transferido para um cliente inscrito específico e cada token gerado tem uma janela de expiração de 4 horas. Enquanto o chamador estiver chamando a API com o mesmo token, ele continuará retornando os mesmos valores de resposta até que o token expire.

Configurar o produto de SaaS para aceitar novos compradores

Você é responsável por configurar corretamente seu software SaaS para aceitar novos clientes e medi-los adequadamente. O processo a seguir descreve uma maneira recomendada de identificar, implementar e medir o acesso de um novo cliente ao seu software:

  1. Quando um cliente acessa sua página de produto no site do AWS Marketplace, ele opta por assinar seu produto.

  2. A Conta da AWS do cliente assina o seu produto. Isso significa que os registros de assinatura e medição enviados do produto farão parte da fatura da AWS do cliente.

  3. Um token de registro, que conterá o identificador de cliente e o código de produto, é gerado para o cliente.

  4. O cliente é redirecionado para a página de destino de registro do software. Essa página deve ser capaz de aceitar o token com o identificador do cliente.

  5. O navegador do cliente envia uma solicitação POST para o URL da página de destino de registro do seu software. A solicitação contém um parâmetro POST, x-amzn-marketplace-token, que contém o token de registro do cliente. Na perspectiva do site de registro, o cliente enviou um formulário com esse parâmetro. O token de registro é uma string invisível. Se o tipo de oferta for uma avaliação gratuita, um segundo parâmetro, x-amzn-marketplace-offer-type com o valor free-trial, será adicionado à solicitação.

  6. Para resgatar esse token de registro para um identificador de cliente, o ID da Conta da AWS do cliente e um código de produto, seu site deve chamar ResolveCustomer no Serviço de medição do AWS Marketplace. O identificador do cliente não é o ID da Conta da AWS do cliente, mas é universal entre os produtos e deve ser salvo em uma fonte interna como parte dos registros do cliente. O código do produto é uma string exclusiva para o produto de SaaS fornecida pela AWS. Cada produto da AWS tem um código de produto exclusivo, que é atribuído a você durante o registro.

    nota

    Para ver um exemplo de chamada ResolveCustomer, consulte Exemplo de código ResolveCustomer.

  7. O cliente é instruído a criar uma conta no produto ou fazer login em uma conta existente.

    nota

    Se a configuração ou vinculação a uma conta de cliente existente em seu produto exigir um processo manual da equipe, você poderá usar um formulário de contato para coletar as informações de contato do cliente. Depois de coletar as informações de contato e resolver o identificador AWS Marketplace exclusivo do cliente (conforme obtido na etapa 6), exiba uma mensagem de notificação para o cliente. Na notificação, informe que a conta dele está sendo configurada e peça que ele espere que você entre em contato. Forneça ao cliente o tempo de resposta esperado e suas informações de contato. Envie também uma mensagem de e-mail para o cliente com os mesmos detalhes.

  8. O cliente agora faz login no site usando as credenciais específicas daquele produto de SaaS. No banco de dados da sua conta, é possível ter uma entrada para cada cliente. O banco de dados das suas contas deve ter uma coluna para o identificador de cliente da AWS, que será preenchida com o identificador de cliente obtido na etapa 6. Verifique se nenhuma outra conta no sistema compartilha esse identificador de cliente. Para clientes que assinam vários produtos por meio do AWS Marketplace, o identificador do cliente permanecerá o mesmo, com cada assinatura tendo um código de produto exclusivo.

  9. Durante o processo de registro do vendedor, você assina tópicos do Amazon SNS que notificam quando os clientes assinam ou cancelam a assinatura no seu produto. Estas são notificações do Amazon SNS em formato JSON que informam sobre as ações do cliente:

    • Notificação de direitos: para produtos com modelos de preços que incluem um contrato, você é notificado quando os compradores criam um novo contrato, atualizam, renovam ou ele expira. O banco de dados das suas contas deve ter uma coluna adicional para o estado da assinatura. Para obter mais informações, consulte Tópico do Amazon SNS: aws-mp-entitlement-notification.

    • Notificação de assinatura: para produtos com qualquer modelo de preço, incluindo contratos e assinaturas, você é notificado quando um comprador assina ou cancela a assinatura de um produto. Para obter mais informações, consulte Tópico do Amazon SNS: aws-mp-subscription-notification.

    Recomendamos que você use o Amazon Simple Queue Service (Amazon SQS) para capturar essas mensagens. Depois de receber uma notificação de assinatura com subscribe-success, a conta do cliente está pronta para a medição. Os registros enviados antes dessa notificação não são medidos. Para obter informações sobre como fazer isso, consulte Etapa 2: conceder permissão ao tópico do Amazon SNS para enviar mensagens à fila do Amazon SQS no Guia do desenvolvedor do Amazon Simple Notification Service.

    nota

    Não ative uma assinatura de produto a menos que você receba uma notificação subscribe-success.

  10. Use o identificador de cliente armazenado em seu banco de dados para medir o uso por meio do Serviço de medição do AWS Marketplace ou para verificar as autorizações por meio do AWS Marketplace Entitlement Service.

Segurança e encomenda

Como vendedor, é sua responsabilidade confiar apenas em identificadores de cliente devolvidos imediatamente pela AWS ou aqueles assinados pelo sistema. Recomendamos resolver o token de registro imediatamente, pois ele poderá expirar depois de cerca de uma hora. Depois de resolver o token de registro, armazene o identificador de cliente como um atributo assinado na sessão do navegador do cliente até que o registro seja concluído.