Solução de problemas de autenticação

Esta página lista possíveis problemas de autenticação que você pode encontrar ao usar as atividades do Microsoft 365.

Que tipo de autenticação devo usar na atividade Microsoft 365 Scope?

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. Para saber como registrar seu aplicativo personalizado no Azure AD e definir permissões de API do Graph, consulte o guia Como criar um aplicativo para conexões do escopo do Microsoft 365.
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

Problema: a autenticação com Nome de usuário e senha falhou. A mensagem de erro exibida é: "Um problema de configuração está impedindo a autenticação - verifique a mensagem de erro do servidor para obter detalhes.Você pode modificar a configuração no portal de registro de aplicativos. Consulte https://aka.ms/msal-net-invalid-client para obter detalhes. Exceção original: AADSTS7000218: o corpo da solicitação deve conter o seguinte parâmetro: 'client_assertion' ou '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

Problema: você recebe a seguinte mensagem de erro: "O aplicativo [...] não está configurado como um aplicativo de vários tenants. O uso do ponto de extremidade /common não é compatível com esses aplicativos criados após 15/10/2018. Use um ponto de extremidade específico do tenant ou configure o aplicativo para ter vários tenants."

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

Problema: ao usar uma conta compartilhada nas atividades do Microsoft 365, na conta pessoal do usuário, é possível recuperar emails, mas ao tentar ler emails de uma conta compartilhada, aparece um erro de Acesso Negado.

Solução: verifique se o Aplicativo tem a permissão de API Mail.Read.Shared (delegada) definida. Essa permissão permite que o aplicativo leia os emails que um usuário pode acessar, incluindo seus próprios emails e os compartilhados.

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

Problema: você recebe a seguinte mensagem de erro: "O usuário ou administrador não consentiu em usar o aplicativo com ID [...] chamado [...]."

Solução: certifique-se de seguir essas etapas para Conceder consentimento de administrador em todo o tenant a um aplicativo.

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