Gerenciar registro do aplicativo e permissão de API para notificações do Microsoft GraphManage app registration and API permission for Microsoft Graph notifications

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.In order for your application service to integrate with Microsoft Graph notifications, you need to register your app with the Microsoft identity platform to support Microsoft accounts or work or school accounts, and declare the API permissions that are required.

Registre seu aplicativo para suporte às contas corporativas ou de estudante da MicrosoftRegister your app to support Microsoft accounts or work or school accounts

Registre seu aplicativo no portal do Microsoft Azure para suporte às contas corporativas ou de estudante da Microsoft.Register your application on the Microsoft Azure portal to support Microsoft accounts or work or school accounts. Se já tiver registrado o aplicativo anteriormente no Portal do aplicativo da Microsoft, os aplicativos existentes serão exibidos na nova e melhorada experiência do portal do Azure.If you’ve previously registered your application on the Microsoft Application Portal, your existing apps will show up in the new and improved Azure portal experience.

Para saber como registrar aplicativos, confira Registrar um aplicativo na Microsoft Identity Platform.For information about how to register your apps, see Register an application with the Microsoft identity platform. Ao registrar seu aplicativo, certifique-se de manter sempre à mão a ID do aplicativo/ID do cliente.When you register your app, keep the application ID/client ID somewhere handy. Essa ID será usada posteriormente ao registrar seu aplicativo para experiências entre dispositivos no Microsoft Partner Center para clientes Windows, Android ou iOS.You'll need this ID later when you register your application for cross-device experiences in the Microsoft Partner Center.

Observação

Se ainda não tiver uma conta da Microsoft e quiser usar uma, acesse a página  conta da Microsoft.If you don't already have a Microsoft account and would like to use one, go to the Microsoft account page. Se estiver desenvolvendo um aplicativo que usa o Azure AD versão 1.0 como uma estrutura de autenticação e identidade para contas corporativas ou de estudante, confira Bibliotecas de Autenticação do Azure Active Directory.If you're writing an app that needs to use Azure AD v1.0 as an authentication and identity framework for work or school accounts, see Azure Active Directory Authentication Libraries. Para saber mais sobre ou se estiver usando a nova Microsoft Identity Platform convergida (versão 2.0), confira comparação do ponto de extremidade da Microsoft Identity Platform e o ponto de extremidade do Azure AD versão 1.0.If you’re interested in learning about or using the new converged Microsoft identity platform (v2.0), see Comparing the Microsoft identity platform endpoint and Azure AD v1.0 endpoint.

Certificados e segredos do aplicativo App certificates and secrets

Para que o aplicativo se identifique e se autentique ao obter tokens de autenticação, você pode carregar seu próprio certificado ou criar um nova segredo do cliente acessando certificados e segredos no portal do Azure.To enable your application to identify and authenticate itself when obtaining auth tokens, you can either upload your own certificate or create a new client secret by going to Certificates & secrets in the Azure portal.

Captura de tela de certificados e segredos do aplicativo no portal do Azure

Observação

Se optar por gerar um novo segredo do cliente, certifique-se de copiá-lo a e guardá-lo em um local seguro.If you opt to generate a new client secret, be sure to copy and keep it in a safe place. Você não poderá acessá-lo novamente após sair do portal.You won’t be able to access it again after you leave the portal.

Permissões de APIAPI permissions

É preciso incluir permissões adicionais para usar as notificações do Microsoft Graph.You'll need to add additional permissions in order to use Microsoft Graph notifications. Escolha Adicionar uma permissãoe, em APIs Microsoft, selecione Microsoft Graphe depois Permissões delegadas.Choose Add a permission, and under Microsoft APIs, select Microsoft Graph, and then select Delegated permissions.

Captura de tela da página de permissões de API de solicitação do portal do Azure

Adicione as seguintes permissões:Add the following permissions:

  • User.Read – permite que o aplicativo conecte seu usuárioUser.Read - allows your application to sign-in your user

  • UserActivity.ReadWrite.CreatedByApp – permite a assinatura do aplicativo para recuperação de notificaçãoUserActivity.ReadWrite.CreatedByApp - allows app subscription for notification retrieval

Captura de tela das permissões delegadas para notificações no portal do Azure

Próximas etapasNext steps

Saiba mais sobre permissões e consentimento ou consulte a referência de permissões do Microsoft Graph.Learn more about permissions and consent or see the Microsoft Graph permissions reference.

Após registrar seu aplicativo, visite o Partner Center para configurar o aplicativo para direcionar suas plataformas de aplicativo correspondentes (Windows, iOS ou Android) para notificações enviadas pelo Microsoft Graph.Now that you’ve registered your app, go to the Partner Center to set up your application for cross-device experiences and to target your corresponding app platforms for notifications sent via Microsoft Graph. Para saber mais, confira a Integração à experiência entre dispositivos.For details, see Onboarding to cross-device experiences.

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.If you're only targeting web endpoints, you can skip Partner Center registration and learn how to set up your app service to send notifications.