Compartilhar 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

Registre seu aplicativo no centro de administração do Microsoft Entra para dar suporte a contas da Microsoft ou contas corporativas ou escolares. Se você tiver registrado anteriormente seu aplicativo no Portal de Aplicativos da Microsoft, seus aplicativos existentes aparecerão na página de registros de aplicativo.

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 você estiver escrevendo um aplicativo que precisa usar Azure AD v1.0 como uma estrutura de autenticação e identidade para contas corporativas ou escolares, consulte ADAL (Biblioteca de Autenticação do Active Directory) do Azure. Se você estiver interessado em aprender ou usar o novo plataforma de identidade da Microsoft convergido (v2.0), consulte Qual é o plataforma de identidade da Microsoft?.

Certificados e segredos do aplicativo

Para permitir que seu aplicativo se identifique e se autentique ao obter tokens de auth, você pode carregar seu próprio certificado ou criar um novo segredo do cliente acessando Certificados & segredos na página centro de administração do Microsoft Entra registros de aplicativo.

Captura de tela dos certificados e segredos do aplicativo 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. Você não poderá acessá-lo 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 tela da página Solicitar permissões de 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 tela mostrando 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 você registrou seu aplicativo, visite o Partner Center para configurar seu aplicativo e direcionar suas plataformas de aplicativo correspondentes (Windows, iOS ou Android) para notificações enviadas via 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.