Partilhar via


Perguntas comuns sobre APIs de atendimento SaaS

Este artigo descreve vários dos requisitos de integração para o mercado comercial da Microsoft para permitir que os clientes do Azure subscrevam 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 em que estão interessados.

Experiência de compra

Quando um utilizador estiver interessado num serviço SaaS específico, pode subscrevê-lo a partir do Azure Marketplace.

O que significa para um utilizador do Azure subscrever uma oferta SaaS no Azure Marketplace?

Isso significa que um usuário pode visualizar os termos de uso e a declaração de privacidade associados ao serviço SaaS e concordar em pagá-los 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 de serviço SaaS.

Esta capacidade é 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 todos os softwares de fornecedores independentes de software (ISV) que pretendem usar. Além disso, os clientes podem usar seu perfil de pagamento existente sem ter que pagar explicitamente cada software ISV de forma independente.

O usuário é cobrado automaticamente quando a oferta é assinada?

Ao subscrever a oferta SaaS, o utilizador concorda em pagar pelo consumo do serviço SaaS através da plataforma Microsoft. No entanto, as cobranças só começam quando a oferta é consumida. O usuário deve acessar sua oferta SaaS e confirmar a criação da conta para começar a consumir a oferta. Em seguida, você notificará a Microsoft para começar a cobrar por essa assinatura SaaS do cliente.

Como você é notificado quando um usuário assina sua oferta de SaaS?

Depois de subscrever uma oferta, o utilizador do Azure pode descobrir e gerir todas as suas ofertas 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 editor configurou o URL no momento da publicação da oferta. Esta página é conhecida como a página de destino do editor. Os usuários do Azure entram na página inicial de 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 do ID do Microsoft Entra e userPrincipalName para o MSA. É possível que o campo "email" esteja vazio para o Microsoft Entra ID e o usuário pode não ter um e-mail gravado. Em caso afirmativo, recomendamos que você detete isso e peça um e-mail de contato. Esta é a sua única chance de receber um e-mail 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 destino, um token é adicionado à URL de consulta. Este token é de curta duração e válido por um período de tempo de 24 horas. Em seguida, você pode detetar a presença desse token e chamar a API da Microsoft para obter mais contexto associado ao token.

Fluxo de subscrição de clientes

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 atendimento de SaaS.

Como você sabe a oferta de SaaS na qual o usuário se inscreve no Azure?

A resposta à Resolve API 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 utilizador do Azure pode alterar o plano associado à subscrição SaaS diretamente na experiência SaaS ou através da plataforma Microsoft.

  • As conversões podem ser feitas a qualquer momento no ciclo de faturamento. Você será solicitado a reconhecer qualquer conversão, que se torna efetiva após o reconhecimento.

  • As taxas do plano pré-pago (mensal ou anual) são rateadas. Qualquer excesso emitido até o momento da conversão será cobrado na próxima fatura. Novos excessos serão emitidos com base no novo plano.

Nota

Você pode bloquear downgrades se não quiser oferecer 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 SaaS:

Fluxo de mudança do plano do cliente

A sequência abaixo captura o fluxo quando um cliente do Azure altera um plano na loja online da Microsoft:

Fluxo de mudança do plano da loja online do cliente

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. Assim que o utilizador cancelar a subscrição, deixará de ser cobrado a partir do próximo ciclo de faturação.

A sequência abaixo captura o fluxo quando um cliente do Azure cancela a assinatura da oferta SaaS na experiência SaaS:

O cliente cancela a inscrição na experiência SaaS

A sequência abaixo captura o fluxo quando o usuário do Azure cancela a inscrição na loja online da Microsoft:

Cliente cancela inscrição na loja online da Microsoft

Gerir experiência

Um ISV pode gerenciar a assinatura SaaS de seu cliente e alterar planos.

Para que um plano seja convertido com sucesso para um plano diferente dentro da mesma oferta, todos os itens a seguir devem ser verdadeiros; caso contrário, as chamadas da API de atendimento SaaS do plano de alteração podem não funcionar:

  • O plano de metas deve estar ativo.
  • O plano alvo deve ser apoiado 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 posso criar uma entidade de serviço para a minha aplicação Entra?

A entidade de serviço do aplicativo Entra é a instância do registro do aplicativo Entra que você cria para sua oferta de SaaS. Esta entidade de serviço de aplicativo deve ser criada no mesmo locatário que você usa na configuração técnica do Partner center. Estas etapas podem ajudá-lo a determinar se uma entidade de serviço foi criada e, se não, como criar uma.

Passo 1: Identifique o Registo da Aplicação.

  1. Navegue até cada oferta de SaaS no Partner Center.

  2. Navegue até a "Página de Configuração Técnica" e registre o valor do "ID do aplicativo Entra":

    Captura de ecrã da página de configuração técnica do Microsoft Partner Center.

Etapa 2: Determine se a entidade de serviço foi criada ou não.

Opção 1: Usando o portal do Azure

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

    Gorjeta

    Poderá ter de mudar para "Todas as Aplicações" em vez de "Aplicações Próprias" caso não tenha sido você a criar o Registo da Aplicação em primeiro lugar.

    Gorjeta

    O nome de registro do aplicativo termina com "FulfilmentAppReg" se tiver sido criado usando o script de implantação do SaaS Accelerator.

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

    Captura de ecrã da página Registo da Aplicação.

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 a mesma verdadeira (conforme mostrado nesta imagem).

Captura de ecrã da interface de linha de comandos do Azure com os resultados criados pela Entidade de Serviço.

Saiba mais sobre este comando Lista principal 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

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

    Gorjeta

    Poderá ter de mudar para "Todas as Aplicações" em vez de "Aplicações Próprias" caso não tenha sido você a criar o Registo da Aplicação em primeiro lugar.

    Gorjeta

    O nome de registro do aplicativo termina com "FulfilmentAppReg" se tiver sido criado usando o script de implantação do SaaS Accelerator.

  2. Abra a página Registro do aplicativo e selecione o link "Criar entidade de serviço" (conforme mostrado nesta captura de tela).

    Captura de ecrã da página Registo da Aplicação com a ligação Criar Principal de Serviço realçada.

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

Captura de tela da interface de linha de comando mostrando que a Entidade de Serviço foi criada.

Saiba mais sobre este comando Service principal create em az ad sp create.