Partilhar via


Gerenciar registro de aplicativo e permissão de API para notificações do Microsoft Graph (obsoleto)

Importante

A API de notificações do Microsoft Graph foi preterida e parou de retornar dados em janeiro de 2022. Para uma experiência de notificação alternativa, confira os Hubs de Notificações do Microsoft Azure. Para obter mais informações, consulte a postagem no blog Desativando a API de notificações do Microsoft Graph (beta).

Para que o serviço do aplicativo se integre às notificações do Microsoft Graph, é necessário registrar seu aplicativo na Microsoft Identity Platform para suporte às contas corporativas ou de estudante da Microsoft e declarar as permissões de API obrigatórias.

Registre seu aplicativo para suporte às contas corporativas ou de estudante da Microsoft

Registe a sua aplicação no centro de administração do Microsoft Entra para suportar contas Microsoft ou contas escolares ou profissionais. Se já registou a sua aplicação no Portal de Aplicações da Microsoft, as aplicações existentes serão apresentadas na página de registos de aplicações.

Para saber como registrar aplicativos, confira Registrar um aplicativo na Microsoft Identity Platform. Ao registrar seu aplicativo, certifique-se de manter sempre à mão a ID do aplicativo/ID do cliente. Essa ID será usada posteriormente ao registrar seu aplicativo para experiências entre dispositivos no Microsoft Partner Center para clientes Windows, Android ou iOS.

Observação

Se você ainda não tem uma conta Microsoft e deseja utilizar uma, vá para a página Conta da Microsoft. Se estiver a escrever uma aplicação que precisa de utilizar o Azure AD v1.0 como uma arquitetura de autenticação e identidade para contas escolares ou profissionais, veja Azure Active Directory Authentication Library (ADAL). Se estiver interessado em aprender ou utilizar a nova plataforma de identidade da Microsoft convergida (v2.0), consulte Qual é a plataforma de identidade da Microsoft?.

Certificados e segredos do aplicativo

Para permitir que a sua aplicação se identifique e se autentique ao obter tokens de autenticação, pode carregar o seu próprio certificado ou criar um novo segredo do cliente ao aceder a Certificados & segredos na página centro de administração do Microsoft Entra registos de aplicações.

Captura de ecrã de certificados de aplicação e segredos no centro de administração do Microsoft Entra

Observação

Se optar por gerar um novo segredo do cliente, certifique-se de copiá-lo a e guardá-lo em um local seguro. Não poderá aceder-lhe novamente depois de sair do portal.

Permissões de API

É preciso incluir permissões adicionais para usar as notificações do Microsoft Graph. Escolha Adicionar uma permissãoe, em APIs Microsoft, selecione Microsoft Graphe depois Permissões delegadas.

Captura de ecrã da página Pedir permissões da API do centro de administração do Microsoft Entra

Adicione as seguintes permissões:

  • User.Read – permite que o aplicativo conecte seu usuário

  • UserActivity.ReadWrite.CreatedByApp – permite a assinatura do aplicativo para recuperação de notificação

Captura de ecrã a mostrar as permissões delegadas para notificações no centro de administração do Microsoft Entra

Próximas etapas

Saiba mais sobre permissões e consentimento ou consulte a referência de permissões do Microsoft Graph.

Agora que registou a sua aplicação, visite o Centro de Parceiros para configurar a sua aplicação e segmentar as plataformas de aplicações correspondentes (Windows, iOS ou Android) para obter notificações enviadas através do Microsoft Graph. Para saber mais, confira a Integração à experiência entre dispositivos.

Observação

Se você estiver apenas direcionando pontos de extremidade da Web, poderá ignorar o registro do Partner Center e aprender a configurar seu serviço de aplicativo para enviar notificações.