Configurar seu aplicativo do Microsoft 365 Azure

Para habilitar as atividades Microsoft 365 Classic, seu aplicativo deve ser integrado com a plataforma de identidade da Microsoft e ter as permissões corretas da API do Microsoft Graph 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 Office 365, o Azure Active Directory atribui uma ID de aplicativo (cliente) exclusiva, que você insere na atividade Microsoft Office 365 Scope, juntamente com os serviços aos quais você atribuiu permissões (por exemplo, arquivos, e-mail, calendário).

Configuração

Registre seu aplicativo

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 conta com suporte, selecione a opção que se aplica a você. Para obter mais informações sobre qual opção selecionar, abaixo estão as recomendações da Microsoft:

   • Contas apenas neste diretório organizacional - Use esta opção se seu público-alvo for interno à sua organização.
   • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) - use esta opção se seu público-alvo for clientes corporativos ou educacionais e para habilitar a multilocação.
   • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox) - Use esta opção para direcionar o conjunto mais amplo de identidades da Microsoft e habilitar a multilocação.

7. Em URI de redirecionamento (opcional), insira um endereço de URI (se aplicável).

   A Microsoft Authentication Library (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 do Token Interativo.
   • Sua seleção depende do tipo de autenticação. Para obter mais informações sobre este tópico, consulte a seção Automação não assistida e assistida na página de detalhes da atividade Microsoft 365 Scope ).
   • Em nosso exemplo, a organização oferece suporte à autenticação multilocatário e só pode usar o tipo de autenticação de token interativo, que requer um URI de redirecionamento.
   • Se você usar o Token Interativo e o URI de Redirecionamento padrão da Microsoft, deverá adicionar uma plataforma do tipo Aplicativos móveis e de área de trabalho. Para obter mais informação, consulte a documentação da Microsoft.
   • Se o seu tipo de autenticação for Autenticação Integrada do Windows 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 v2.0 da plataforma de identidade da Microsoft 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 direcionado para o .NET 5.0, os clientes devem adicionar http://localhost à URI de redirecionamento de seus aplicativos personalizados.

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

8. Clique em Registrar. Um exemplo de configuração está disponível na captura de tela 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 aplicativo registrado (portal do Azure > Azure Active Directory > registros de aplicativo > Office365App), clique em permissões de API no painel de navegação à esquerda.
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 requer?, clique em Permissões delegadas ou Permissões do aplicativo para mostrar a lista de permissões. As permissões do aplicativo devem ser definidas quando o valor de AuthenticationType na atividade do escopo do Microsoft Office 365 é definido como ApplicationIdAndSecret ou ApplicationIdAndCertificate. Os outros tipos de autenticação disponíveis na atividade do escopo do Microsoft Office 365 exigem permissões delegadas.

   Para obter mais informações sobre tipos de permissão, consulte Configurar um aplicativo cliente para acessar as APIs da Web na documentação do Microsoft Azure.

   Importante:

   Algumas atividades não oferecem suporte ao tipo de autenticação ApplicationIdAndSecret ou ApplicationIdAndCertificate (por exemplo, Find Meeting Times).

   Para atividades de e-mail, é obrigatório especificar um valor para o parâmetro Account (ou seja, qual caixa de correio de todas as caixas de correio do inquilino você deseja usar).

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

   Uma solução é restringir as permissões do aplicativo a caixas de correio específicas, para que o aplicativo tenha acesso apenas às caixas de correio especificadas.

   Para obter mais informações, consulte Escopo de permissões do aplicativo para caixas de correio específicas do Exchange Online.

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

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

   • 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

   • Compartilhado\*

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

     • Calendars.ReadWrite.Shared

       \* Escopos necessários para acessar recursos compartilhados com o usuário, mas que não pertencem a ele.

   • Clique em Adicionar permissões (retornando à sua lista de permissões de API)

     
     

     

     
     

7. Verifique se suas permissões de API incluem as permissões de calendários, arquivose e -mail adicionados.

   
   

   

   
   

Crie seu projeto no Studio Desktop

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

   • Abra o UiPath Studio.
   • Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
   • Insira um Nome, Locale Descriçãodo projeto.
   • Escolha a compatibilidade. O Windows é selecionado por padrão.

   • Clique em Criar.

     

2. Instale o pacote UiPath.MicrosoftOffice365.Activities .

   • Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
   • Em Todos os Pacotes, na barra de Pesquisa , insira Office 365 ou Microsoft.
   • Selecione a versão do pacote que você deseja e clique em Instalar.
   • 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 Classic para uma lista completa de atividades e links para as páginas detalhadas das atividades.