Incorporación de clientes de SaaS

Con las suscripciones de software como servicio (SaaS) y los contratos de SaaS, sus clientes se suscriben a sus productos AWS Marketplace pero acceden al producto en su entorno. AWS Después de suscribirse al producto, se dirige a su cliente a un sitio web que haya creado y administrado como parte de su producto SaaS para que registre su cuenta y configure el producto.

Cuando creó el listado de productos SaaS, proporcionó una URL de la página de inicio de registro. Utilizamos esa dirección URL para redirigir a los clientes a su página de inicio de registro después de suscribirse. En la página de inicio de registro del software, debe recopilar todas las informaciones necesarias para crear una cuenta para el cliente. Le recomendamos que recopile las direcciones de correo electrónico de sus clientes si tiene previsto ponerse en contacto con ellos a través del correo electrónico para las notificaciones de uso.

La página de inicio del registro debe poder identificar y aceptar el x-amzn-marketplace-token token que figura en los datos del formulario AWS Marketplace junto con el identificador del cliente a efectos de facturación. A continuación, debe transferir ese valor simbólico AWS Marketplace Metering Service a la para que se resuelva con el identificador único del cliente, el Cuenta de AWS identificador del cliente y el código de producto correspondiente. Para ver un ejemplo del código, consulte ejemplo de código ResolveCustomer.

nota

El token de registro se resuelve en un cliente suscrito específico y cada token generado tiene un intervalo de vencimiento de 4 horas. Mientras el intermediario esté llamando a la API con el mismo token, seguirá devolviendo los mismos valores de respuesta hasta que el token caduque.

Configuración del producto SaaS para aceptar nuevos compradores

Usted es responsable de configurar correctamente el software SaaS para aceptar nuevos clientes y medirlos adecuadamente. A continuación, se describe un método recomendado para identificar, implementar y medir el acceso de un nuevo cliente al software:

1. Cuando un cliente visita la página de tu producto en el AWS Marketplace sitio web, decide suscribirse a tu producto.

2. El cliente Cuenta de AWS está suscrito a tu producto. Esto significa que los registros de suscripción y medición enviados desde tu producto pasan a formar parte de la factura del AWS cliente.

3. Se genera un token de registro para el cliente que contiene el identificador de cliente y su código de producto.

4. Se redirige al cliente a la página de inicio de registro del software. Esta página debe poder aceptar el token con el identificador del cliente.

5. El navegador del cliente envía una solicitud POST a la URL de la página de inicio de registro del software. La solicitud contiene un parámetro POST, x-amzn-marketplace-token, que contiene el token de registro del cliente. Desde la perspectiva de su sitio web de registro, el cliente ha enviado un formulario con este parámetro. El token de registro es una cadena opaca. Si el tipo de oferta es una prueba gratuita, x-amzn-marketplace-offer-type con el valor free-trial, se añadirá a la solicitud.

6. Para canjear este token de registro por un identificador de cliente, un identificador de cliente Cuenta de AWS y un código de producto, su sitio web debe utilizar el servicio ResolveCustomerde medición de AWS Marketplace. El identificador del cliente no es el id. de Cuenta de AWS del cliente, sino que es universal entre los productos y debe guardarse en una fuente interna como parte de sus registros de clientes. El código del producto es una cadena única para el producto SaaS que se AWS le proporciona. Cada AWS producto tiene un código de producto único, que se le asigna durante el registro.

   nota

   Para ver un ejemplo de una llamada a ResolveCustomer, consulte ejemplo de código ResolveCustomer.

7. Se indica al cliente que cree una cuenta en su producto o que inicie sesión en una cuenta existente.

   nota

   Si la configuración o vinculación de una cuenta de cliente existente en su producto requiere un proceso manual por parte de su equipo, puede usar un formulario de contacto para recopilar la información de contacto del cliente. Tras recopilar su información de contacto y resolver su identificador único de cliente de AWS Marketplace (tal y como se indica en el paso 6), muéstrele un mensaje de notificación. En la notificación, indique que su cuenta se está configurando y pídale que espere a que se ponga en contacto con él. Indique al cliente el tiempo de entrega previsto y su información de contacto. Envíe también un mensaje de correo electrónico al cliente con los mismos detalles.

8. El cliente ha iniciado ya sesión en su sitio web con las credenciales específicas para ese producto SaaS. En su base de datos de cuentas puede tener una entrada por cada cliente. La base de datos de cuentas debe tener una columna para el identificador de AWS cliente, que debe rellenar con el identificador de cliente que obtuvo en el paso 6. Verifique que ninguna otra cuenta de su sistema comparta este identificador de cliente. En el caso de los clientes que se suscriban a varios productos AWS Marketplace, el identificador de cliente seguirá siendo el mismo y cada suscripción tendrá un código de producto único.

9. Durante el proceso de registro de vendedor, se suscribe a temas de Amazon SNS que le notifican cuándo se suscriben clientes o cuándo anulan la suscripción a su producto. Estas son las notificaciones de Amazon SNS en formato JSON que le informan de las acciones de los clientes:

   • Notificación de derechos: en el caso de los productos con modelos de precios que incluyen un contrato, se le notifica cuando los compradores crean un nuevo contrato, lo actualizan, lo renuevan o caduca. Su base de datos de cuentas debe tener una columna adicional para el estado de la suscripción. Para obtener más información, consulte Tema de Amazon SNS: aws-mp-entitlement-notification.

   • Notificación de suscripción: en el caso de los productos con cualquier modelo de precios, incluidos los contratos y las suscripciones, se le notificará cuando un comprador se suscriba o cancele la suscripción a un producto. Para obtener más información, consulte Tema de Amazon SNS: aws-mp-subscription-notification.

   Se recomienda que utilice Amazon Simple Queue Service (Amazon SQS) para capturar estos mensajes. Después de recibir una notificación de suscripción con subscribe-success, la cuenta de cliente quedará lista para empezar a medirse. Los registros que envíe antes de esta notificación no se miden. Para obtener información sobre cómo hacerlo, consulte Paso 2: Conceder permiso al tema de Amazon SNS para enviar mensajes a la cola de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

   nota

   No active la suscripción a un producto a menos que reciba una notificación subscribe-success.

10. Utilice el identificador de cliente almacenado en su base de datos para medir el uso a través del servicio de medición de AWS Marketplace o comprobar los derechos a través del servicio de concesión de derechos de AWS Marketplace Entitlement Service.

Seguridad y pedidos

Como vendedor, es tu responsabilidad confiar únicamente en los identificadores de los clientes que se devuelvan inmediatamente AWS o en los que tu sistema haya firmado. Le recomendamos que resuelva el token de registro de inmediato, ya que puede que caduque después de aproximadamente 1 hora. Una vez resuelto el token de registro, almacene el identificador de cliente como atributo firmado en la sesión del navegador del cliente hasta que el registro se haya completado.