Autorizar o Microsoft Graph a partir de um suplemento do Office

Seu suplemento pode obter autorização para dados do Microsoft Graph obtendo um token de acesso para o Microsoft Graph da plataforma de identidade da Microsoft. Use o fluxo do Código de Autorização ou o fluxo Implícito da mesma forma que faria em outros aplicativos da web, mas com uma exceção: a plataforma de identidade da Microsoft não permite que sua página de entrada seja aberta em um iframe. Quando um suplemento do Office está em execução no Office na Web, o painel de tarefas é um iframe. Isso significa que você precisará abrir a página de entrada em uma caixa de diálogo usando a API de diálogo do Office. Isso afeta a maneira como você usa as bibliotecas auxiliares de autenticação e autorização. Para saber mais, confira Autenticação com a API de Diálogo do Office.

Para obter informações sobre como programar autenticação usando a plataforma de identidade da Microsoft, consulte a documentação da plataforma de identidade da Microsoft. Você encontrará tutoriais e guias nesse conjunto de documentação, bem como links para exemplos relevantes. Mais uma vez, talvez seja necessário ajustar o código nos exemplos para serem executados na caixa de diálogo do Office a fim de levar em conta a caixa de diálogo do Office que é executada em um processo separado do painel de tarefas.

Depois que o código obtém o token de acesso para o Microsoft Graph, ele passa o token de acesso da caixa de diálogo para o painel de tarefas. Para obter detalhes, consulte Autenticação com a API de caixa de diálogo do Office. O código no painel de tarefas solicita dados do Microsoft Graph e inclui o token nessas solicitações. Para obter mais informações sobre como chamar o Microsoft Graph e os SDKs do Microsoft Graph, consulte a documentação do Microsoft Graph.

Bibliotecas e exemplos recomendados

As bibliotecas a seguir fornecem acesso ao Microsoft Graph.

• Para suplementos usando um lado do servidor com uma Estrutura baseada em rede, como o .NET Core ou o ASP.NET, use oMSAL.NET.
• Para suplementos que usam um lado do servidor baseado em NodeJS, use a Biblioteca de Autenticação da Microsoft para Node.

Para obter mais informações sobre as bibliotecas recomendadas para trabalhar com a plataforma de identidade da Microsoft, consulte Bibliotecas de autenticação da plataforma de identidade da Microsoft.

Os exemplos a seguir obtêm dados do Microsoft Graph de um suplemento do Office.

• Suplemento do Office Microsoft Graph ASP.NET
• Suplemento do Outlook Microsoft Graph ASP.NET
• Suplemento do Office Microsoft Graph React

Suporte a cookies de terceiros do Google Chrome

O Google Chrome está trabalhando para dar aos usuários mais controle sobre sua experiência de navegação. Os usuários poderão bloquear cookies de terceiros no navegador Chrome. Isso impedirá que o suplemento use qualquer um desses cookies. Isso pode causar problemas quando o suplemento autentica o usuário, como várias solicitações de logon ou erros.

Para obter experiências de autenticação aprimoradas, consulte Usar o estado do dispositivo para uma experiência de SSO aprimorada em navegadores com cookies de terceiros bloqueados.

Para obter mais informações sobre a versão do Google Chrome, consulte Um novo caminho para o Privacy Sandbox na Web.