Configurar o gerenciamento de licenças da Microsoft

  • Artigo

ISVs (fornecedores de software independentes) podem configurar o gerenciamento de licenças da Microsoft para aplicativos SaaS de terceiros no Partner Center como parte da publicação da oferta. Isso permite que administradores ou usuários do Teams atribuam, desatribuam, usem e acompanhem as licenças SaaS para suas assinaturas de aplicativo de terceiros no Teams.

Para habilitar o gerenciamento de licenças para um aplicativo de terceiros no Teams, siga as etapas:

  1. Criar uma oferta no Partner Center
  2. Atualizar seu aplicativo teams
  3. Pós-compra
  4. Integrar com a API graph usageRights

Criar uma oferta no Partner Center

  1. Entre no Partner Center e selecione Partner Center.

    As capturas de tela mostram como fazer logon na conta do Partner Center.

  2. Na página Inicial , selecione Guia ofertas do Marketplace para definir ofertas de marketplace comercial.

    As capturas de tela mostram a página inicial e a guia oferta do Marketplace no Partner Center.

  3. Selecione Visão geral no painel esquerdo.

  4. Selecione Novo Software de Oferta>como serviço.

    As capturas de tela mostram a página de oferta do marketplace em que você pode selecionar uma nova oferta.

  5. Insira ID de Oferta e Alias de Oferta e selecione Criar.

    Observação

    Se você estiver criando uma oferta para fins de teste, adicione o texto -ISVPILOT ao final do alias de oferta. Isso indica à equipe de certificação que a oferta é para fins de teste. A Microsoft exclui ofertas com -ISVPILOT periodicamente. Portanto, não use essa marca por outros motivos além de testar o recurso de gerenciamento de licenças.

    As capturas de tela mostram como inserir iD de oferta e alias de oferta no Partner Center.

  6. Na página Instalação da Oferta, em detalhes de configuração, selecione a caixa de seleção Sim, gostaria que a Microsoft gerenciasse licenças de cliente em meu nome.

    As capturas de tela mostram a página de instalação da oferta para configurar a licença para gerenciar para seu aplicativo no Teams.

    Observação

    • Essa é uma configuração única e você não pode alterá-la depois que sua oferta for publicada. Isso permite que o cliente gerencie licenças para seu aplicativo no Teams.
    • O manifesto do aplicativo dá suporte a apenas uma oferta para um aplicativo. Escolha uma solução de gerenciamento de licença apropriada para todos os planos disponíveis em sua oferta e você não poderá alterar essa opção depois que a oferta for enviada por push para viver.

  7. Selecione Salvar rascunho.

  8. Selecione Visão geral do plano no painel esquerdo e selecione Criar novo plano.

    Observação

    Você precisa adicionar pelo menos um plano.

    As capturas de tela mostram a visão geral do plano para criar um novo plano para seus aplicativos no Partner Center.

  9. Insira a ID do plano e o nome do plano e selecione Criar.

  10. Insira o nome do plano e a descrição do plano.

    Observação

    As informações do plano são exibidas no marketplace do Teams e no AppSource em listagem de oferta (seção planos).

    As capturas de tela mostram a página de plano para adicionar o nome do plano e a descrição do plano para seu aplicativo.

  11. Selecione Salvar rascunho.

  12. Selecione Preço e disponibilidade no painel esquerdo.

  13. Adicione detalhes de preço e disponibilidade.

    As capturas de tela mostram a página de preços e disponibilidade para adicionar a oferta saaS para seu aplicativo.

  14. Selecione Salvar rascunho.

  15. Selecione Visão geral do plano na parte superior da página para acessar a página de listagem que mostra todos os planos que você criou para essa oferta.

    As capturas de tela mostram a página de listagem de planos com ID de serviço, modelo de preço, disponibilidade, status e ação.

  16. Copie a ID do serviço do plano que você criou para integrar à API useRights do Microsoft Graph.

Atualizar seu aplicativo teams

Atualize seu aplicativo do Teams para mapear a funcionalidade paga e mapear seu aplicativo do Teams para sua oferta e publicar.

Pós-compra

  1. Após a ativação, o cliente é redirecionado da página de destino para o Gerenciamento de Licenças do Teams.

  2. Após a conclusão bem-sucedida da compra da assinatura, o cliente é redirecionado para a página de destino do aplicativo para ativação da assinatura. Essa é a experiência existente para o usuário comprar aplicativos monetizados no Teams.

  3. Depois que o cliente ativa a compra da assinatura na página de destino, o cliente é redirecionado para a página de assinaturas no Teams por meio de um link ou botão de URL de redirecionamento que o cliente seleciona na página de destino do editor.

Integrar com a API graph usageRights

Integre-se à API graph usageRights para gerenciar permissões de usuário no momento do lançamento do aplicativo por um cliente que tem uma licença de compra. Você é obrigado a determinar as permissões do usuário para o aplicativo com uma chamada graph para a API useRights.

Você pode chamar APIs do Graph para determinar se o usuário conectado atualmente com uma assinatura válida do plano tem acesso ao seu aplicativo. Para chamar a API do Graph useRights para marcar permissões do usuário, siga as etapas:

  1. Obter token OBO do usuário: obtenha acesso em nome de um usuário.

  2. Chame o Graph para obter a ID do objeto do usuário: use o microsoft API do Graph.

  3. Chamada useRights API para determinar se o usuário tem Licença para o plano: Listar uso do usuário APIRights.

    Observação

    • Você precisa ter permissões mínimas User.Read para chamar useRights. A API do usageRights está atualmente na versão beta. Depois que a versão for atualizada para v1, os usuários devem atualizar da versão beta para v1.
    • Se o aplicativo Microsoft Entra for usado para APIs saaS Fulfillment e useRights API, verifique se o locatário sob o qual o aplicativo Microsoft Entra é criado é o locatário de publicação ou o locatário associado no Partner Center.

Para determinar se o locatário do aplicativo Microsoft Entra faz parte da configuração do Partner Center, siga estas etapas:

  1. Entre no Microsoft Partner Center com a conta de editor usada para publicar a oferta saaS.
  2. No canto superior direito, selecione o ícone Configurações .
  3. Selecione Configurações da Conta.
  4. No painel esquerdo, selecione Locatários. Você pode ver todos os locatários associados à conta MPN (Microsoft Partner Network). O locatário, que é o proprietário do aplicativo Microsoft Entra, deve estar disponível na lista. Se o locatário não estiver na lista, você poderá usar o botão Associar ID do Azure para vincular o locatário.

Verificar o uso da licença na análise do Partner Center

  1. Acesse o Partner Center.
  2. No painel esquerdo, acesse Licenciamento de Análise > do Marketplace > Comercial.
  3. Selecione Planejar e Locatário no widget de relatório para ver o uso sábio do mês.

Confira também

Monetize seu aplicativo