Token Interativo

Visão geral

• Execução: como um usuário.
• Cenário: automação Attended.
• Permissões delegadas.

Observação: esse é o mesmo método de autenticação suportado no Integration Service, seja por meio do aplicativo UiPath público ou de um aplicativo personalizado privado (método Traga seu próprio aplicativo).

Detalhes

• O tipo de autenticação Interativo do Token pode ser usado para automação assistida e quando a autenticação multi-factor (MFA) for necessária. Essa é a opção padrão e o que usamos em nossos exemplos. Se você estiver interessado em experimentar o pacote de atividades, essa opção é fácil de configurar e funciona bem para contas pessoais (usando o URI de redirecionamento padrão observado na etapa 7 da seção Registrar seu aplicativo do guia).

• Você tem a opção de se registrar e usar seu próprio aplicativo do Azure (ou seja, OAuthApplication = UiPath) ou aquele fornecido pela UiPath (OAuthApplication = Custom):
  • Registro de aplicativo público do UiPath: a vantagem de usar o aplicativo público do UiPath é que você não precisa configurar ou manter o aplicativo Observação: o UiPath não armazena nenhum dado do usuário. O token de autenticação é salvo apenas na sua máquina ou no seu bucket do Orchestrator. Consulte Registro de aplicativo público do UiPath.
  • Registro de aplicativos personalizados: a vantagem de usar seu próprio aplicativo personalizado é que você pode gerenciar, personalizar e atribuir permissões dentro de sua organização de forma mais granular. Consulte Como criar um aplicativo para conexões do Microsoft 365 Scope.
• Ao criar um aplicativo personalizado, você deve selecionar um tipo de aplicativo. Para a autenticação interativa do token, use um aplicativo móvel/de área de trabalho (que usa o fluxo de código de autorização do OAuth 2.0).
• Quando você executar a atividade Microsoft 365 pela primeira vez usando esse tipo de autenticação, você será solicitado a autorizar o acesso aos recursos (você concedeu permissões ao registrar seu aplicativo) por meio de uma caixa de diálogo consentimento. Consulte Obter acesso em nome de um usuário.
• Uma única organização pode ter vários IDs de aplicativo (cliente). Cada ID de aplicativo (cliente) contém suas próprias permissões e requisitos de autenticação. Por exemplo, você e seu colega podem registrar um aplicativo Microsoft 365 no Azure Active Directory da sua empresa com diferentes permissões. Seu aplicativo pode ser configurado para autorizar permissões para interagir apenas com arquivos, enquanto o aplicativo de seu colega está configurado para autorizar permissões para interagir com arquivos, e-mail e calendário.

• Se você selecionar esse tipo de autenticação no Microsoft 365 Scope, deixe os campos Nome de usuário e Senha vazios. Se você estiver usando um aplicativo de único tenant, configure o campo Tenant . Se você estiver usando um aplicativo multitenant (o aplicativo público do UiPath é multitenant), você pode deixar o campo Tenant vazio.

Escopos do token Interativo

Quando você adiciona uma atividade ao Microsoft 365 Scope, seus escopos necessários são detectados automaticamente. Você também pode optar por permitir escopos adicionais ou menos escopos. Se menos escopos forem selecionados, algumas funcionalidades de atividades podem não funcionar. Para obter mais informações, consulte Trabalhar com escopos de atividades.

Registro do aplicativo público do UiPath

O UiPath Public App é registrado com as seguintes informações:

• Nome: UiPathStudioO365App
• ID do Cliente: f2f43f65-16a6-4319-91b6-d2a342a88744
• Escopos: Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, Calendars.ReadWrite.Shared, Chat.ReadWrite, email, EWS.AccessAsUser.All, Files.Read, Files.Read.All, Files.ReadWrite, Arquivos. ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Mail.Send.Shared, offline_access, openid, Presence.Read, Presence.Read.All, perfil, Sites.Read.All, Sites.ReadWrite.All, User.Read, User.Read.All.

Como criar um aplicativo para conexões do Microsoft 365 Scope

Para habilitar as atividades clássicas do Microsoft 365, seu aplicativo deve ser integrado à plataforma de identidade da Microsoft e ter as permissões de API do Microsoft Graph corretas atribuídas a ele.

Para integrar seu aplicativo, atribuir permissões e começar a criar seu projeto de automação, conclua as seguintes etapas:

1. Registre seu aplicativo.
2. Adicione permissões de API.
3. Construa seu projeto.

Após o registro de seu aplicativo Microsoft 365, o Azure Active Directory atribui uma ID de aplicativo (cliente) exclusiva, que você insere na atividade Microsoft 365 Scope , juntamente com os serviços aos quais você atribuiu permissões (por exemplo, arquivos, e-mail, calendário).

Registre seu aplicativo

Dica: esse processo é descrito em detalhes na documentação da Microsoft em Início rápido: registre um aplicativo com a plataforma de identidade da Microsoft. Observe que a interface gráfica da Microsoft pode ter sido alterada desde que essas etapas foram documentadas pela primeira vez.

1. Faça login no portal do Azure usando sua conta pessoal, profissional ou escolar do Microsoft 365.
2. No painel de navegação à esquerda, clique em Azure Active Directory.
3. Depois que a página do Azure Active Directory for aberta, clique em Registros de aplicativos.

4. Clique em + Novo registro na barra de navegação superior.

5. Insira um Nome para seu aplicativo (por exemplo, "Office365App").

6. Em Tipos de contas compatíveis, selecione a opção que se aplica a você. Para obter mais informações sobre qual opção selecionar, consulte Quem pode fazer login no seu aplicativo?:

   • Apenas contas nesse diretório organizacional - Use essa opção se seu público-alvo for interno da sua organização. Isso representa um único aplicativo de tenant.
   • Contas em qualquer diretório organizacional (Qualquer diretório do Azure AD - Multitenant) - Use essa opção se seu público-alvo for clientes de negócios ou educacionais. Isso representa um aplicativo multitenant.
   • Contas em qualquer diretório organizacional e contas pessoais da Microsoft (por exemplo, Skype, Xbox) - Use essa opção para segmentar o conjunto mais amplo de identidades da Microsoft. Isso representa um aplicativo multitenant.
7. Em URI de redirecionamento (opcional), insira um endereço de URI (se aplicável). A Biblioteca de autenticação da Microsoft (MSAL.NET) usa um URI de redirecionamento padrão: https://login.microsoftonline.com/common/oauth2/nativeclient. Esse valor provavelmente funcionará para você ao usar o tipo de autenticação de Token interativo.
   • Sua seleção depende do seu tipo de autenticação. Para obter mais informações sobre esse tópico, consulte Como se conectar às atividades do Microsoft 365).
   • Em nosso exemplo, a organização é compatível com a autenticação de vários tenants e só pode usar o tipo de autenticação Token interativo, que requer um URI de redirecionamento.
     • Se você usar Token interativo e o URI de redirecionamento padrão da Microsoft, você deve adicionar uma plataforma do tipo Aplicativos móveis e de desktop. Para obter mais informações, consulte Definir configurações de plataforma na documentação da Microsoft.
     • Se seu tipo de autenticação for autenticação integrada do Windows (IWA) ou nome de usuário e senha, você não precisará registrar um URI de redirecionamento para seu aplicativo. Esses fluxos fazem uma viagem de ida e volta para o ponto de extremidade da plataforma de identidade da Microsoft v2.0, e seu aplicativo não será chamado de volta em nenhum URI específico.
   • Ao trabalhar com o Microsoft 365 em um projeto do UiPath Studio que tem como alvo o .NET 5.0, adicione http://localhostao URI de Redirecionamento de seus aplicativos personalizados.

     Para obter mais informações, consulte Registro de aplicativo de área de trabalho na documentação da plataforma de identidade da Microsoft.

8. Selecione Registrar. Um exemplo de configuração está disponível na imagem abaixo.

   Nota: Esta configuração é apenas um exemplo. Siga as etapas descritas na documentação e faça seleções com base nas políticas de sua organização.
   
   

   

   
   

Você Terminou! Agora, vamos adicionar permissões de API ao seu aplicativo registrado.

Adicionar permissões de API

1. Na página do seu aplicativo registrado (Portal do Azure > Azure Active Directory > Registros de aplicativos > Office365App), selecione permissões de API no painel de navegação esquerdo.
2. Depois que a página de permissão da API for aberta, clique em + Adicionar uma permissão (isso abre a janela Solicitar permissões da API ).
3. Em Selecione uma API, clique em APIs da Microsoft (podem ser abertas por padrão).

4. Em APIs da Microsoft comumente usadas, clique em Microsoft Graph.

5. Em Que tipo de permissões seu aplicativo exige?, clique em Permissões delegadas ou Permissões de aplicativos para mostrar a lista de permissões. Selecione Permissões de aplicativos se você estiver usando o tipo de autenticação ApplicationIdAndSecret ou ApplicationIdAndCertificate. Os outros tipos de autenticação disponíveis na atividade Microsoft 365 Scope exigem permissões delegadas.

   Para obter mais informações sobre tipos de permissão, consulte Configure a client application to access web APIs na documentação do Microsoft Azure.

6. Use a barra de pesquisa ou role para baixo na lista alfabética e selecione as seguintes permissões:

   Observação: essas permissões não são todas obrigatórias. A lista fornecida representa o conjunto completo de permissões necessárias para executar todas as atividades Microsoft 365. Você pode restringir permissões dependendo do seu caso de uso específico. Verifique as páginas de documentação de atividades para saber de quais permissões elas precisam.

   • Calendário

     • Calendários.Leia
     • Calendários.ReadWrite

   • Arquivos

     • Arquivos.Read
     • Arquivos.Ler.Todos
     • Arquivos.ReadWrite
     • Arquivos.ReadWrite.All

   • Sites

     • Sites.Read.All
     • Sites.ReadWrite.All

   • Email

     • Mail.Read
     • Mail.ReadWrite
     • E-mail.Enviar
   • Usuários
     • User.Read

   • Compartilhado (escopos necessários para acessar recursos que são compartilhados com, mas não são de propriedade do usuário.)

     • Mail.Read.Shared
     • Mail.ReadWrite.Shared
     • Mail.Enviar.Compartilhado
     • Calendars.Read.Shared
     • Calendars.ReadWrite.Shared

   • Selecione Adicionar permissões para retornar à sua lista de Permissões de API.

     
     

     

     
     

7. Certifique-se de que suas Permissões de API incluam suas permissões de Calendários, Arquivos, Usuário e Email adicionadas.

   
   

   

   
   

Crie seu projeto no Studio Desktop

1. Crie um novo projeto de automação.

   1. Abra o UiPath Studio.

   2. Em Novo projeto, clique em Processo. Isso abre uma janela Novo processo em branco.

   3. Insira um Nome, Locale Descriçãodo projeto.

   4. Escolha a compatibilidade. O Windows é selecionado por padrão.

   5. Clique em Criar.

2. Instale o pacote UiPath.MicrosoftOffice365.Activities .

   1. Na faixa Design, selecione Gerenciar pacotes.
   2. Em Todos os Pacotes, na barra de Pesquisa , insira Office 365 ou Microsoft.
   3. Selecione a versão do pacote que você deseja e, em seguida, selecione Instalar.
   4. Clique no botão Salvar .
   Para obter mais informações sobre os pacotes do UiPath Studio, consulte Gerenciando pacotes no Guia do Studio.

Está feito!Agora que concluiu a configuração, você pode começar a adicionar as atividades Microsoft 365 ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte os Guias de início rápido . Esses guias fornecem instruções passo a passo para ajudar você a criar amostras de trabalho das diferentes atividades para que você possa verificar a conexão com seu aplicativo registrado e se familiarizar com as propriedades de entrada/saída.

Para saber mais sobre as atividades Microsoft 365 (incluindo entradas/saídas de propriedades de exemplo), consulte as Atividades Clássicas para uma lista completa e links para as páginas detalhadas de atividades.