Integrando clientes ao seu produto SaaS por meio de AWS Marketplace - AWS Marketplace
Configurar o produto de SaaS para aceitar novos compradoresSegurança e encomenda

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 clientes ao seu produto SaaS por meio de AWS Marketplace

Com assinaturas de software como serviço (SaaS) e contratos SaaS, seus clientes assinam seus produtos AWS Marketplace por meio de, mas acessam o produto em seu ambiente. 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, você coleta 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 inicial de registro deve ser capaz de identificar e aceitar o x-amzn-marketplace-token token nos dados do formulário AWS Marketplace com o identificador do cliente para cobrança. Em seguida, ele deve passar esse valor do token AWS Marketplace Metering Service para resolver o Conta da AWS ID exclusivo do cliente, o identificador do cliente (para novas implementações ou ao atualizar sua integração, use o ID da conta 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 visita a página do seu produto no AWS Marketplace site, ele opta por assinar seu produto.

  2. O cliente Conta da AWS está inscrito em seu produto. Isso significa que os registros de assinatura e medição enviados do seu produto se tornam parte da AWS fatura do cliente.

  3. Um token de registro é gerado para o cliente que contém o ID da Conta da AWS , o identificador do cliente e o código do produto.

  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 por um Conta da AWS ID de cliente, identificador de cliente e código de produto, seu site deve recorrer ResolveCustomerao AWS Marketplace Metering Service. Para obter um exemplo de uma chamada ResolveCustomer, consulte Exemplo de código ResolveCustomer. O identificador do cliente não é o Conta da AWS ID 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 seu produto SaaS que AWS fornece a você. Cada AWS produto tem um código de produto exclusivo, que é atribuído a você durante o registro.

  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 ID da Conta da AWS e o identificador 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 para ele aguardar você entrar 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. Seu banco de dados de contas deve ter uma coluna para o Conta da AWS ID. Verifique se nenhuma outra conta em seu sistema compartilha a Conta da AWS ID.

  9. Importante

    As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge.

    Durante o processo de registro de vendedor, você configura EventBridge as regras da Amazon para receber eventos que o notificam quando os clientes assinam ou cancelam a assinatura do seu produto. Esses são EventBridge eventos da Amazon no formato JSON que informam você 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 Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge.

    • 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 Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge.

    Recomendamos que você use o Amazon Simple Queue Service (Amazon SQS) (Amazon SQS) como alvo para EventBridge suas regras capturarem esses eventos. Depois de receber uma notificação de assinatura com subscribe-success, a conta do cliente está pronta para a medição. Os registros que você envia antes desse evento não são medidos. Para obter informações sobre como configurar EventBridge regras com destinos do SQS, consulte os destinos do Amazon SQS no Guia do usuário da EventBridge Amazon.

    nota

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

  10. Use a Conta da AWS ID armazenada em seu banco de dados para medir o uso por meio do AWS Marketplace Metering Service ou verifique os direitos por meio do. AWS Marketplace Entitlement Service

Segurança e encomenda

Como vendedor, é sua responsabilidade confiar somente naqueles Conta da AWS IDs que são devolvidos imediatamente AWS ou naqueles que seu sistema assinou. É recomendável resolver imediatamente o token de registro, pois ele poderá expirar depois de aproximadamente uma hora. Depois de resolver o token de registro, armazene o Conta da AWS ID como um atributo assinado na sessão do navegador do cliente até que o registro seja concluído.