Autenticação

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

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

Visão geral

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 da API do Graph, consulte a página Configuração.
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 o escopo das permissões do aplicativo para caixas de correio específicas, de modo que o aplicativo tenha acesso apenas às caixas de correio especificadas: Escopo de permissões do aplicativo 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 é:

Importante: "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 do aplicativo. Consulte https://aka.ms/msal-net-invalid-client para 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:

Importante: "O aplicativo [...] não está configurado como um aplicativo multilocatário. O uso do terminal /common não é compatível com esses aplicativos criados após 15/10/2018. Use um endpoint específico do inquilino ou configure o aplicativo para ser multilocatário."

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, pode-se recuperar emails, mas ao tentar ler emails de uma conta compartilhada, um erro de acesso negado é exibido.

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 e-mails que um usuário pode acessar, incluindo seus próprios e-mails compartilhados.

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

Problema: você recebe a seguinte mensagem de erro:

Importante: "O usuário ou administrador não consentiu em usar o aplicativo com ID [...] denominado [...]."

Solução: certifique-se de seguir estas etapas para conceder consentimento do administrador.

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