Este artigo descreve vários dos requisitos de integração para o marketplace comercial da Microsoft para permitir que os clientes do Azure assinem ofertas de SaaS.
Experiência de descoberta
Depois que uma oferta de 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 nos quais estão interessados.
Experiência de compra
Depois que um usuário estiver interessado em um serviço SaaS específico, o usuário poderá assiná-lo no Azure Marketplace.
O que significa para um usuário do Azure assinar uma oferta de SaaS no Azure Marketplace?
Isso significa que um usuário pode exibir os termos de uso e a política de privacidade associados 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 o consumo do serviço SaaS.
Essa habilidade é benéfica de várias maneiras. Os clientes agora podem descobrir e assinar em um só lugar usando o Microsoft Cloud Platform como uma fonte confiável, sem precisar examinar todos os softwares isv (fornecedores de software independentes) que ele pretende usar. Além disso, os clientes podem usar seu perfil de pagamento existente sem precisar pagar explicitamente cada software ISV de forma independente.
O usuário é cobrado automaticamente quando a oferta é assinada?
Ao assinar a oferta de SaaS, o usuário concorda em pagar pelo consumo do serviço SaaS por meio da plataforma Microsoft. No entanto, os encargos só começam quando a oferta é consumida. O usuário deve acessar sua oferta de 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 de SaaS?
Depois de assinar uma oferta, o usuário do Azure pode descobrir e gerenciar todas as suas ofertas no Azure. Por padrão, o estado de uma oferta SaaS recém-assinada é mostrado como Provisionamento, atendimento pendente. Nesse estado, o usuário do Azure é solicitado com uma ação para Configurarde Conta, a fim de navegar até a experiência de gerenciamento de assinatura saaS no portal do Azure.
Quando o usuário seleciona Configurarde Conta, ele é redirecionado para o site do serviço SaaS. O publicador configurou a URL no momento da publicação da oferta. Esta página é conhecida como a página de aterrissagem do editor. Os usuários do Azure entrarão na página de aterrissagem 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, Logon Único (SSO), conforme direcionado pela política de . A propriedade mail
no recurso de usuário recuperado da API do Microsoft Graph fornece as informações de contato para o caso da ID do Microsoft Entra e userPrincipalName
para MSA. É possível que o campo "email" esteja vazio para a ID do Microsoft Entra e o usuário não tenha um email gravado. Nesse caso, recomendamos que você detecte isso e solicite um email de contato. Essa é sua única chance de obter um email de contato para alcançar um cliente durante ou após o processo de embarque 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 por um tempo de 24 horas. Em seguida, 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 de SaaS, consulte API de cumprimento de SaaS.
Como você sabe a oferta de SaaS à qual o usuário assina no Azure?
A resposta à API Resolve
inclui as informações de oferta e plano associadas à assinatura saaS.
Como o usuário do Azure pode alterar o plano associado a esta assinatura do 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ê será solicitado a reconhecer qualquer conversão, que se torna eficaz após a confirmação.
As taxas de plano pré-pago ( mensais ou anuais) são proporcionales. 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.
Nota
Você pode bloquear downgrades se não quiser dar suporte a caminhos de conversão específicos.
A sequência abaixo captura o fluxo quando um cliente do Azure altera um plano na experiência de SaaS:
A sequência abaixo 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 de SaaS comprada diretamente na experiência saaS ou por meio da plataforma Microsoft. Depois que o usuário cancelar a assinatura, ele não será mais cobrado 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 de SaaS na experiência saaS:
de experiência saaS
A sequência abaixo 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 seus clientes e alterar planos.
Para um plano para converter com êxito em um plano diferente dentro da mesma oferta, todos os seguintes devem ser verdadeiros; caso contrário, as chamadas à API de cumprimento de SaaS do plano de alteração podem não funcionar:
- O plano de destino deve estar ativo.
- O plano de destino deve ter suporte na região do cliente.
- Se o plano de destino for um plano privado, a tenantID do cliente deverá ser adicionada ao plano no Partner Center e republicada antes de tentar o plano de alteração.
- Se o plano de destino fizer parte do marketplace privado, o cliente deverá permitir a lista de permissões do plano em seu marketplace privado antes que o plano de alteração seja concluído.
- 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 de 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 foi criada e, se não, como criar uma.
Etapa 1: identificar o registro do aplicativo.
Navegue até cada oferta de SaaS no Partner Center.
Navegue até sua "Página de Configuração Técnica" e registre o valor da "ID do aplicativo Entra":
Etapa 2: determinar 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 copiada do Partner Center.
Ponta
Talvez seja necessário alternar para "Todos os Aplicativos" em vez de "Aplicativos De Propriedade" caso não tenha sido você que criou o Registro de Aplicativo em primeiro lugar.
Ponta
O nome de registro do aplicativo terminará com "FulfilmentAppReg" se ele tiver sido criado usando o script de implantação do Acelerador de SaaS.
Abra a página Registro de Aplicativo. Caso você veja o link com o nome de registro do aplicativo (em vez de "Criar Entidade de Serviço", conforme 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 verdadeiro (conforme mostrado nesta imagem).
Saiba mais sobre este comando de lista de de entidade de serviço em az ad sp list.
Etapa 3: Criar e associar 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 copiada do Partner Center.
Ponta
Talvez seja necessário alternar para "Todos os Aplicativos" em vez de "Aplicativos De Propriedade" caso não tenha sido você que criou o Registro de Aplicativo em primeiro lugar.
Ponta
O nome de registro do aplicativo terminará com "FulfilmentAppReg" se ele tiver sido criado usando o script de implantação do Acelerador de SaaS.
Abra a página Registro de 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 verdadeiro (conforme mostrado nesta imagem).
Saiba mais sobre essa entidade de serviço criar comando em az ad sp create.
Conteúdo relacionado
- APIs do serviço de medição do Marketplace