Solução de problemas de autenticação

This page lists possible authentication issues you may encounter when using the Microsoft 365 activities.

Which authentication type should I use in the Microsoft 365 Scope activity?

Primeiro, verifique os seguintes recursos:

1. Leia a documentação relacionada à atividade Microsoft 365 Scope , que inclui informações sobre os tipos de autenticação disponíveis.
2. To learn how to register your custom application in Azure AD and set Graph API permissions, see the How to create an application for Microsoft 365 Scope connections guide.
3. A lista de chamadas da API do Graph a partir de atividades Microsoft 365 está disponível na página Referências técnicas.
4. Para saber como usar o UiPathStudioO365App para InteractiveToken (ou seja, OAuthApplication=UiPath), consulte:
   • UiPathStudioO365App no Microsoft Azure Marketplace
   • Configurando o Azure AD para automação do Outlook 365.
5. Consulte as permissões das APIs necessárias para os cartões Usar aplicativo na página Microsoft 365 e Google Workspace Cards - Permissões e escopos das APIs.

Escopo para caixas de correio específicas

Ao usar esse tipo de autenticação, o aplicativo tem acesso a todas as caixas de correio de seu locatário. Isso porque a permissão da API do aplicativo Mail.Read representa "Ler e-mail em todas as caixas de correio" e Mail.ReadWrite significa "Ler e escrever e-mail em todas as caixas de correio".

É possível definir permissões de aplicativos para caixas de correio específicas, de modo que o aplicativo tenha acesso somente às caixas de correio especificadas: Escopo de permissões de aplicativos para caixas de correio específicas do Exchange Online.

Escopo para sites específicos

Use a permissão de aplicativo Sites.Selected para permitir que o aplicativo acesse apenas conjuntos de sites específicos do SharePoint em vez de todos.

A autenticação com nome de usuário e senha falha

Parâmetros ausentes: client_assertion ou client_secret

Issue: Authentication with username and password fails. The error message displayed is: "A configuration issue is preventing authentication - check the error message from the server for details. You can modify the configuration in the application registration portal. See https://aka.ms/msal-net-invalid-client for details. Original exception: AADSTS7000218: The request body must contain the following parameter: 'client_assertion' or 'client_secret'."

Solução: certifique-se de que seu aplicativo registrado tenha o campo de configuração Permitir fluxos de clientes públicos habilitado.

O aplicativo não está configurado como um aplicativo multilocatário

Issue: You receive the following error message: "Application [...] is not configured as a multi-tenant application. Usage of the /common endpoint is not supported for such applications created after 10/15/2018. Use a tenant-specific endpoint or configure the application to be multi-tenant."

Soluções:

• Defina um valor para o parâmetro Tenant .
• Configure o aplicativo para ser multilocatário.

A autenticação funciona, mas o usuário não pode ler e-mails de uma caixa de correio compartilhada

Issue: When using a shared account on the Microsoft 365 activities, on the user's personal account, one can retrieve mail, but when trying to read emails from a shared account, an Access Denied error appears.

Solution: Check if the Application has the Mail.Read.Shared API permission (delegated) set. This permission allows the app to read mail a user can access, including their own and shared mail.

Erro: O usuário ou administrador não autorizou o uso do aplicativo

Issue: You receive the following error message: "The user or administrator has not consented to use the application with ID [...] named [...]."

Solution: Make sure you follow these steps to Grant tenant-wide admin consent to an application.

IntegratedWindowsAuthentication (IWA) não funciona em v1.4.0 e v1.5.0

Problema: IntegratedWindowsAuthentication (IWA) funcionava em UiPath.MicrosoftOffice.365.Activitiesv1.3.1, mas não funciona em UiPath.MicrosoftOffice.365.Activities v1.4.0 e v1.5.0.

Solução: use UiPath.MicrosoftOffice.365.Activities versão >= 1.6.0.

Autenticação ApplicationIdAndSecret em v1.4.0 e v1.5.0

Problema: ao usar UiPath.MicrosoftOffice.365.Activities v1.4.0 ou v1.5.0, a atividade Scope falha, mesmo que os parâmetros obrigatórios, ID do aplicativo e Segredo do aplicativo, estejam definidos corretamente.

Se o parâmetro Tenant não estiver definido, você poderá obter um dos seguintes erros:

Importante:

• "O token não contém permissões ou as permissões não podem ser entendidas." (Multitenant)
• "Aplicativo com identificador [...] não foi encontrado no diretório 'microsoft.com'. Isso pode acontecer se o aplicativo não tiver sido instalado pelo administrador do locatário ou autorizado por qualquer usuário do locatário. Você pode ter enviado sua solicitação de autenticação para o locatário errado." (Inquilino Único)

Solução: defina um valor para o parâmetro Tenant.

Outra opção é atualizar para UiPath.MicrosoftOffice.365.Activities versão >= 1.6.0. Começando com v1.6.0, Tenant é um parâmetro obrigatório.

Solicitações de API do Graph no escopo do Microsoft 365

Você pode fazer solicitações da API do Graph dentro da atividade Microsoft 365 Scope. Isso é possível ao usar um objeto ParentScope em uma atividade Invoke Code .

Observação: isso é possível para projetos Windows-Legacy .NET 4.6.1. Ele falha em projetos Windows .NET5 (mensagem de erro "Não foi possível carregar arquivo ou assembly 'Microsoft.Graph, versão=3.32.0.0'").

Veja abaixo um exemplo com Studio v2021.10 (Windows-Legacy) e UiPath.MicrosoftOffice.365.Activities v1.11.1:

Baixe o exemplo