Este artigo descreve vários dos requisitos de integração do marketplace comercial da Microsoft para permitir que os clientes do Azure assinem as ofertas SaaS.
Experiência de descoberta
Quando uma oferta SaaS é publicada, os usuários do Azure podem descobri-la no Azure Marketplace. Seus clientes podem filtrar ofertas com base no tipo de produto (SaaS) e descobrir os serviços SaaS que os interessam.
Experiência de compra
Quando um usuário estiver interessado em um serviço SaaS específico, o usuário poderá assiná-lo através do Azure Marketplace.
O que significa para um usuário do Azure assinar uma oferta SaaS no Azure Marketplace?
Isso significa que um usuário pode visualizar os termos de uso e a política de privacidade associada ao serviço SaaS e concordar em pagar por ele de acordo com os termos de cobrança definidos por você, o editor da oferta SaaS, na fatura da Microsoft. Os usuários podem usar seu perfil de pagamento existente no Azure para pagar pelo consumo do serviço SaaS.
Essa possibilidade é benéfica de várias maneiras. Os clientes agora podem descobrir e se inscrever em um só lugar usando o Microsoft Cloud Platform como uma fonte confiável, sem ter que examinar cada software de fornecedor de software independente (ISV) que pretende usar. Além disso, os clientes podem usar seu perfil de pagamento existente sem ter que pagar explicitamente por cada software ISV independentemente.
O usuário é cobrado automaticamente quando a oferta é assinada?
Ao assinar a oferta SaaS, o usuário concorda em pagar pelo consumo do serviço SaaS por meio da plataforma Microsoft. No entanto, as cobranças só começam quando a oferta é consumida. O usuário deve acessar a oferta SaaS e confirmar a criação da conta para começar a consumir a oferta. Em seguida, você notificará a Microsoft para iniciar a cobrança dessa assinatura SaaS do cliente.
Como você é notificado quando um usuário assina sua oferta SaaS?
Depois de assinar uma oferta, o usuário do Azure pode descobrir e gerenciar todas as ofertas dele no Azure. Por padrão, o estado de uma oferta SaaS recém assinada é mostrado como Provisionamento, cumprimento pendente. Nesse estado, o usuário do Azure é solicitado com uma ação para Configurar Conta, a fim de navegar para sua experiência de gerenciamento de assinatura SaaS no portal do Azure.
Quando o usuário seleciona Configurar conta, ele é redirecionado para o site do serviço SaaS. O distribuidor configurou a URL no momento da publicação da oferta. Essa página refere-se à página de aterrissagem do editor. Os usuários do Azure entram na página inicial do SaaS com base em suas credenciais existentes do Microsoft Entra no Azure.
Importante
Você deve entrar no usuário comprador usando o Microsoft Entra ID, Single Sign On (SSO), conforme indicado pela política. A mail propriedade no recurso de usuário recuperado da API do Microsoft Graph fornece as informações de contato para o caso de ID do Microsoft Entra e userPrincipalName para MSA. É possível que o campo "email" esteja vazio para o Microsoft Entra ID e o usuário pode não ter um email gravado. Em caso afirmativo, recomendamos que você detecte isso e peça um e-mail de contato. Essa é sua única chance de obter um email de contato para alcançar um cliente durante ou após o processo de integração do cliente.
Quando o usuário do Azure é redirecionado para a página de aterrissagem, um token é adicionado à URL de consulta. Esse token é de curta duração e válido pelo período de 24 horas. Você pode detectar a presença desse token e chamar a API da Microsoft para obter mais contexto associado ao token.
Para obter mais informações sobre o contrato de API para lidar com cenários de transação no ciclo de vida de uma oferta SaaS, veja API de cumprimento de SaaS.
Como você sabe qual oferta SaaS o usuário assinou no Azure?
Para responder, a Resolve API inclui as informações de oferta e do plano que estão associadas à assinatura SaaS.
Como o usuário do Azure pode alterar o plano associado a esta assinatura no Azure?
O usuário do Azure pode alterar o plano associado à assinatura SaaS diretamente na experiência SaaS ou por meio da plataforma Microsoft.
As conversões podem ser feitas a qualquer momento no ciclo de cobrança. Você é solicitado a reconhecer qualquer conversão, que se torna efetiva após o reconhecimento.
As tarifas do plano pré-pago (mensal ou anual) são rateadas. Qualquer excedente emitido até o momento da conversão será cobrado na próxima fatura. Novos excedentes serão emitidos com base no novo plano.
Observação
Você poderá bloquear os downgrades se não quiser dar suporte a caminhos de conversão específicos.
A sequência a seguir captura o fluxo quando um cliente do Azure altera um plano na experiência SaaS:
A sequência a seguir captura o fluxo quando um cliente do Azure altera um plano na loja online da Microsoft:
Como o usuário do Azure pode cancelar a assinatura do plano associado à assinatura do Azure?
Um usuário do Azure pode cancelar a assinatura de uma oferta SaaS adquirida diretamente na experiência SaaS ou pela plataforma Microsoft. Depois que o usuário cancelar a assinatura, ele não será mais cobrado a partir do próximo ciclo de cobrança.
A sequência a seguir captura o fluxo quando um cliente do Azure cancela a assinatura da oferta SaaS na experiência SaaS:
A sequência a seguir captura o fluxo quando o usuário do Azure cancela a assinatura na loja online da Microsoft:
Gerenciar experiência
Um ISV pode gerenciar a assinatura SaaS de seu cliente e alterar planos.
Para que um plano seja convertido com sucesso em um plano diferente dentro da mesma oferta, todos os itens a seguir devem ser verdadeiros; caso contrário, as chamadas de API de atendimento SaaS do plano de alteração podem não funcionar:
- O plano alvo deve estar ativo.
- O plano de metas deve ser suportado na região do cliente.
- Se o plano de destino for um plano privado, o ID do locatário do cliente deverá ser adicionado ao plano no Partner Center e republicado antes de tentar alterar o plano.
- Se o plano alvo fizer parte do mercado privado, o cliente deve permitir a lista do plano em seu mercado privado antes que o plano de mudança seja feito.
- Para clientes EA, se a configuração BYOL estiver habilitada (o que significa que eles só podem comprar recursos gratuitos), o plano de destino não deve ser um plano pago.
Como faço para criar uma entidade de serviço para meu aplicativo Entra?
Sua entidade de serviço do aplicativo Entra é a instância do registro do aplicativo Entra que você cria para sua oferta de SaaS. Essa entidade de serviço do aplicativo deve ser criada no mesmo locatário que você usa na configuração técnica do Partner Center. Essas etapas podem ajudá-lo a determinar se uma entidade de serviço é criada e, se não, como criar uma.
Etapa 1: Identifique o registro do aplicativo.
Navegue até cada oferta de SaaS no Partner Center.
Navegue até a "Página de Configuração Técnica" e registre o valor do "ID do aplicativo Entra":
Etapa 2: Determine se a entidade de serviço foi criada ou não.
Opção 1: Usando o portal do Azure
Navegue até a página Registros de Aplicativo do portal do Azure e localize o Registro de Aplicativo com a ID que você copiou do Partner Center.
Dica
Você pode ter que mudar para "Todos os aplicativos" em vez de "Aplicativos de propriedade", caso você não tenha sido o único a criar o registro do aplicativo em primeiro lugar.
Dica
O nome de registro do aplicativo termina com "FulfilmentAppReg" se ele foi criado usando o script de implantação do SaaS Accelerator.
Abra a página Registro do aplicativo. Caso você veja o link com o nome de registro do aplicativo (em vez do link "Criar entidade de serviço", como mostrado na próxima captura de tela), isso significa que você já tem uma entidade de serviço criada.
Opção 2: Usando a CLI do Azure
az ad sp list --filter "appId eq '<Your-App-ID>'"
Se a entidade de serviço for criada, você obterá accountEnabled como true (conforme mostrado nesta imagem).
Saiba mais sobre este comando Lista de entidades de serviço em az ad sp list.
Etapa 3: Criando e associando uma entidade de serviço
Opção 1: Usando o portal do Azure
Navegue até a página Registros de Aplicativo do portal do Azure e localize o Registro de Aplicativo com a ID que você copiou do Partner Center.
Dica
Você pode ter que mudar para "Todos os aplicativos" em vez de "Aplicativos de propriedade", caso você não tenha sido o único a criar o registro do aplicativo em primeiro lugar.
Dica
O nome de registro do aplicativo termina com "FulfilmentAppReg" se ele foi criado usando o script de implantação do SaaS Accelerator.
Abra a página Registro do aplicativo e selecione o link "Criar entidade de serviço" (conforme mostrado nesta captura de tela).
Opção 2: Usando a CLI do Azure
az ad sp create --id <app_id>
Se a entidade de serviço for criada, você verá accountEnabled como true (conforme mostrado nesta imagem).
Saiba mais sobre este comando Service principal create em az ad sp create.