Configuração da integração do Azure AD

Essa funcionalidade está disponível no plano de licenciamento Enterprise.

Se sua organização estiver usando o Azure Active Directory (Azure AD) ou Office 365, você pode conectar sua organização diretamente ao seu tenant do Azure AD para ver as contas e grupos existentes em seu ambiente de nuvem.

Com a integração do Azure AD, você pode continuar aproveitando o modelo de contas locais, enquanto inicializa sua organização com os benefícios adicionais de usar o modelo do Azure AD.

Se sua organização decidiu usar o modelo do Azure AD, siga as instruções nesta página para configurar a integração.

Conselho: A integração do Azure AD é projetada de tal forma que ativá-la e implementá-la pode acontecer gradualmente, sem nenhuma interrupção na produção para seus usuários existentes.

Pré-requisitos

Para configurar a integração do Azure AD, você precisa que:

• uma organização com uma licença Enterprise
• permissões de administrador tanto na plataforma da UiPath quanto no Azure AD (podem ser pessoas diferentes);
• o administrador da organização precisa de uma conta do Azure AD que use o mesmo endereço de e-mail da conta local do UiPath; a conta do Azure AD só é necessária para testar a integração, portanto, o usuário do Azure AD não precisa de permissões de administrador no Azure;
• UiPath Studio e UiPath Assistant versão 202.10.3 ou posterior;
• UiPath Studio e UiPath Assistant para usar a implantação recomendada.

Observação: a UiPath obedece ao protocolo OIDC para sua integração com o Azure AD. No entanto, a integração não suporta o uso de chaves personalizadas do aplicativo por meio da reivindicação de um parâmetro de consulta appid em uma URL dedicada, conforme descrito na documentação de tokens de acesso da Microsoft .

Configuração do Azure para a Integração

Sua organização exige um registro de aplicativo no seu tenant do Azure AD e alguma configuração para que possa visualizar seus membros do AD para estabelecer a identidade da conta. Os detalhes de registro do aplicativo também são necessários para conectar posteriormente sua organização a seu tenant do Azure AD.

Permissões: você tem que ser um administrador no Azure para executar as tarefas nesta seção. As seguintes funções de administrador do Azure têm os privilégios necessários: Global Administrator, Cloud Application Administrator ou Application Administrator.

Há duas maneiras de configurar seu tenant do Azure para a integração:

• Siga as instruções abaixo para configurar manualmente um registro de aplicativo para a integração.
• Use os scripts do Azure AD da UiPath que criamos para essa tarefa, os quais estão disponíveis no GitHub: o script configAzureADconnection.ps1 realiza todas as ações descritas nesta seção e retorna os detalhes de registro do aplicativo. Então você pode executar o script testAzureADappRegistration.ps1 para garantir que o registro do aplicativo foi bem-sucedido.

Para configurar manualmente seu tenant do Azure, faça o seguinte no Azure Portal:

1. Criar um registro de aplicativo para sua organização.
   Durante o cadastramento, selecione Apenas contas neste diretório organizacional e defina o Redirecionar o URI como https://govcloud.uipath.us/{organizationName}/{tenantName}/identity_/signin-oidc.

   Observação: se você já tiver um aplicativo registrado para sua organização, não há necessidade de criar um novo, mas certifique-se de que ele esteja configurado conforme descrito acima.
2. Abra a página Visão geral do aplicativo, copie o ID do aplicativo (cliente) e o ID do diretório (tenant) e salve-os para uso posterior:
   
   

   

   
   
3. Acesse a página de Autenticação de seu aplicativo:
   1. Em Redirecionar URIs, clique em Adicionar o URI para adicionar uma nova entrada.
   2. Adicione https://govcloud.uipath.us/portal_/testconnection à lista de Redirecionamento de URIs.
   3. Na parte inferior, selecione a caixa de seleção tokens de ID.
   4. Clique em Salvar.
   
   

   

   
   
4. Acesse a página de Configuração de tokens.
5. Selecione Adicionar pedido opcional.
6. Sob Tipo de token, selecione ID.
7. Selecione as caixas de seleção para family_name, given_name e upn para adicioná-las como pedidos opcionais:
   
   

   

   
   
8. Acesse a página de permissões da API.
9. Clique em Adicionar permissão e adicione as seguintes permissões delegadas da categoria Microsoft Graph:
   • Permissões do OpenId - email, openid, offline_access, profile;
   • Permissões de membro do grupo - GroupMember.Read.All;
   • Permissões de usuário - User.Read, User.ReadBasic.All, User.Read.All (requer consentimento administrativo).
   
   

   

   
   

   Permission	O que ele permite que você faça	O que fazemos com ele
   email, openid, profile, offline_access e User.Read	Permite que o AAD emita um token de usuário para o aplicativo do sistema	Permitir que os usuários façam login no sistema usando um login do AAD. Isso nos permite manter nosso objeto de usuário atualizado, garantindo a consistência desses atributos.
   User.ReadBasic.All	Lê propriedades básicas de todos os usuários no diretório que o usuário conectado tem permissão para ver	Quando um usuário atribui permissões a outros usuários no diretório para seus recursos, ele pode pesquisar esses usuários. A funcionalidade para gerenciamento/autorização de acesso está na experiência do usuário do sistema.
   User.Read.All (requer consentimento do administrador)	Lê todas as propriedades do usuário no diretório que o usuário conectado tem permissão para ver	Seu administrador pode querer importar essas propriedades do usuário adicionais para configurar permissões ou exibir informações personalizadas dentro dos serviços do sistema. Para clientes do Automation Hub que desejam obter o conjunto completo de atributos do AAD, é necessário conceder a permissão User.Read.All ao aplicativo.
   GroupMember.Read.All	Lê as associações de grupo de todos os usuários aos quais o usuário conectado tem acesso	Se sua organização estiver usando grupos para gerenciar permissões no sistema, a plataforma precisará poder listar todos os grupos e descobrir os membros de um grupo; isso permite o gerenciamento e a aplicação das permissões atribuídas ao grupo.

   Para saber mais sobre o acesso da UiPath com essas permissões, consulte nossa documentação de Criptografia.

10. Selecione a caixa de seleção Conceder consentimento de administrador.
    Nota: O administrador consente em nome de todos os usuários no active directory do tenant. Isso permite que o aplicativo acesse os dados de todos os usuários, sem que uma solicitação de consentimento seja enviada aos usuários.

    Para obter mais informações sobre permissões e consentimentos, consulte a documentação do Azure AD.
11. Acesse a página Certificados e segredos.
12. Crie um novo segredo do cliente.
    Observação: o segredo do cliente criado não é permanente. Você deve atualizar o segredo do cliente após seu período de validade.
13. Copie o Valor secreto do cliente e salve-o para uso posterior
    
    

    

    
    
14. Compartilhe os valores do ID do diretório (tenant), ID do aplicativo (cliente) e Segredo do cliente com o administrador da organização para que ele possa prosseguir com a configuração.

Implantação da integração

Após a configuração do Azure ser concluída, você pode se preparar para a integração, ativá-lo e então limpar as contas antigas.

O processo é dividido em etapas, para que não haja nenhuma interrupção para seus usuários.

Observação:

Você deve ser um organization administrator para executar as tarefas nesta seção.

Limpe usuários inativos

Observação: se endereços de e-mail inativos não forem reutilizados em sua organização, o que também é conhecido como reciclagem de endereços de email, você pode pular essa etapa.

Quando você se conectar ao Azure AD, ativando a integração, as contas com endereços de e-mail correspondentes são vinculadas para que a conta do Azure AD se beneficie das mesmas permissões da conta correspondente da UiPath (conta local).

Se sua organização pratica a reciclagem de e-mails, isso significa que um endereço de e-mail que foi usado no passado poderia ser atribuído a um novo usuário no futuro, isso pode levar a um alto risco de acesso.

Exemplo

Digamos que você já teve um funcionário cujo endereço de email era [e-mail] e esse funcionário tinha uma conta local na qual ele era administrador da organização. Porém, ele deixou a empresa e o endereço de email foi desativado, mas o usuário não foi removido.

Quando um novo funcionário que também se chama João entra na empresa, ele recebe o mesmo endereço de e-mail [e-mail] . Nesse caso, quando as contas são vinculadas como parte da integração com o Azure AD, o João herda os privilégios de administrador da organização.

Para evitar essas situações, certifique-se de remover todos os usuários que não estão mais ativos da organização UiPath antes de prosseguir para a próxima etapa.

Ativar a Integração do Azure AD

Antes de começar

• Certifique-se de que a configuração do Azure está completa.
• Obtenha os valores do ID do diretório (tenant), ID do aplicativo (cliente) e Segredo do cliente para o registro do aplicativo no Azure do seu administrador do Azure.

Para ativar a integração do Azure AD, siga estas etapas:

1. Acesse Admin e, se ainda não estiver selecionado, selecione a organização na parte superior do painel esquerdo.
2. Selecione Segurança.
3. Na guia Configurações de autenticação, clique em Configurar SSO.
   
   

   

   
   
4. Selecione Azure Active Directory no painel de configuração do SSO.
   
   
   
   
5. Preencha os campos com as informações recebidas de seu administrador do Azure.
   
   
   
   
6. Marque a caixa de seleção.
   Isso é necessário porque após salvar suas alterações, as contas correspondentes são automaticamente vinculadas.
7. Clique em Testar Conexão.
8. Quando solicitado, faça login com sua conta do Azure AD. Um login bem-sucedido indica que a integração foi configurada corretamente.
   Caso ele falhar, peça ao seu administrador do Azure para verificar se o Azure está configurado corretamente e depois tente novamente.
9. Clique em Salvar, se a seleção ainda não tiver sido feita.

   A integração agora está ativa para sua organização.

10. Acesse Administrador > Configurações da organização e anote o URL para sua organização.
11. Faça logoff.
12. Navegue até o URL da organização ( https://govcloud.uipath.us/orgID/) e faça login usando sua conta do Azure AD.

Agora, você pode trabalhar com os usuários e grupos no Azure do tenant vinculado. Você pode encontrar usuários e grupos do Azure AD usando a pesquisa, por exemplo, para adicionar um usuário a um grupo. Consulte também as perguntas Frequentes abaixo para obter mais informações sobre quais mudanças ocorrerão após a integração estar ativa.

Observação: contas e grupos do Directory não estão relacionadas nas páginas Usuários ou Grupos em Admin > Contas e grupos; você só pode encontrá-las por meio de pesquisa.

Testar a integração do Azure AD

Para verificar se a integração está funcionando, faça login como administrador da organização com uma conta do Azure AD e tente pesquisar os usuários e grupos no Azure AD em qualquer página relacionada, como o painel Editar Grupo na UiPath platform (Administrador > Contas e Grupos > Grupos > Editar).

• Se você pode pesquisar por usuários e grupos que se originam no Azure AD, isso significa que a integração está em andamento. Você pode identificar o tipo de usuário ou grupo através de seu ícone .

  Nota: Os usuários e grupos do Azure AD não estão listados nas páginas Usuários ou Grupos; eles só estão disponíveis por meio de pesquisa.

• Se você encontrar um erro ao tentar pesquisar pelos usuários, conforme exibido no exemplo abaixo, isso indica que há algo errado com a configuração no Azure. Entre em contato com o administrador do Azure e peça que verifiquem se o Azure está configurado conforme descrito na Configuração do Azure para a Integração.

  Conselho: Peça ao seu administrador do Azure para confirmar que eles selecionaram a caixa de seleção Conceder consentimento de administrador durante a configuração do Azure. Esta é uma causa comum de falha na integração.

Solução de problemas

Os administradores do Azure podem usar o script de teste do Azure AD da UiPath testAzureADappRegistration.ps1, que está disponível no GitHub , para encontrar e corrigir qualquer problema de configuração quando a causa não estiver clara, como no caso abaixo:

Completando a Transição para o Azure AD

Depois que a integração estiver ativa, recomendamos que você siga as instruções nesta seção para assegurar que a criação de usuários e a atribuição de grupos seja transferida para o Azure AD. Dessa forma, você pode criar em cima da sua infraestrutura de identidade e gerenciamento de acesso existente para facilitar a governança e o controle de gerenciamento de acesso sobre seus recursos da UiPath.

Configurar Grupos para Permissões e Robôs (Opcional)

Você pode fazer isso para garantir que o administrador do Azure também possa inserir novos usuários com as mesmas permissões e a configuração de robôs que você configurou antes da integração. Isso pode ser feito adicionando quaisquer novos usuários a um grupo do Azure AD se o grupo já tiver as funções necessárias atribuídas.

Você pode mapear seus grupos de usuários existentes da plataforma da UiPath para grupos novos ou existentes no Azure AD. Você pode fazer isso de várias maneiras, dependendo como de como você usa grupos no Azure AD:

• Se os usuários com as mesmas funções na UiPath Platform já estão nos mesmos grupos no Azure AD, o administrador da organização pode adicionar esses grupos do Azure AD aos grupos de usuários em que esses usuários estavam. Isso garante que os usuários mantenham as mesmas permissões e configurações de robô.
• Caso contrário, o administrador do Azure pode criar novos grupos no Azure AD para corresponder aos da plataforma UiPath e adicionar os mesmos usuários que estão nos grupos de usuários da UiPath. Então o administrador da organização pode adicionar os novos grupos do Azure AD aos grupos de usuários existentes para garantir que os mesmos usuários tenham as mesmas funções.

Em ambos os casos, certifique-se de verificar se existem funções que foram explicitamente atribuídas aos usuários . Se possível, elimine as atribuições explícitas de funções adicionando esses usuários aos grupos que têm as funções que foram atribuídas explicitamente.

Exemplo: digamos que o grupo de Administradores na plataforma UiPath inclui os usuários Roger, Tom e Jaime. Esses mesmos usuários também estão em um grupo no Azure AD chamado admins. O administrador da organização pode adicionar o grupo de admins ao grupo de Administradores . Dessa forma, Roger, Tom e Jerry, como membros do grupo admins do Azure AD, se beneficiam das funções do grupo Administradores .

Como os admins agora fazem parte do grupo de Administradores , quando você precisar integrar um novo administrador, o administrador do Azure pode adicionar o novo usuário ao grupo de admins no Azure, concedendo-lhe assim permissões de administração na plataforma da UiPath sem ter que fazer nenhuma alteração Plataforma da UiPath.

Observação:

As alterações nas atribuições de grupo do Azure AD se aplicam na UiPath Platform quando o usuário faz login com sua conta do Azure AD, ou se já estiver logado, dentro de uma hora.

Migrar Usuários Existentes

Login inicial: para que as permissões atribuídas aos usuários e grupos do Azure AD sejam aplicadas, os usuários devem fazer login pelo menos uma vez. Recomendamos que, após a integração estar em execução, você avise a todos os seus usuários para saírem de sua conta local e fazerem login novamente com sua conta do Azure AD. Eles podem fazer login com sua conta do Azure AD:

• navegando para a URL específica da organização, que no caso o tipo de login já está selecionado;

  Nota: A URL deve incluir o ID da organização e terminar em uma barra, tal como https://govcloud.uipath.us/orgID/.

• selecionando Enterprise SSO na página de login principal.

  Observação: certifique-se de fornecer o URL específico da sua organização para o Automation Cloud^TM Public Sector a todos os seus usuários. Apenas os administradores da organização podem ver essas informações no Automation Cloud^TM Public Sector.

Os usuários migrados se beneficiam da união das permissões que lhes foram diretamente atribuídas e as dos seus grupos do Azure AD.

Configuração do Studio e Assistant para usuários: para configurar esses produtos para se conectar às contas do Azure AD:

1. No Assistant, abra Preferências e selecione a aba Conexão do Orchestrator.
2. Clique em Sair.
3. Para o tipo de conexão, selecione URL do Serviço.

4. No campo Service URL, adicione a URL específica da organização

   Nota: A URL deve incluir o ID da organização e terminar em uma barra, tal como https://govcloud.uipath.us/orgID/. Caso contrário, a conexão falha dizendo que o usuário não pertence a nenhuma organização.
5. Faça o login novamente com a conta do Azure AD.

Important: As Permissões dos grupos do Azure AD não influenciam as automações de pastas clássicas ou os robôs que estão conectados usando a chave da máquina. Para operar sob as permissões baseadas em grupo, configure as automações nas pastas modernas e use a opção de URL do Serviço para se conectar ao UiPath Assistant ou ao Studio.

Parar de usar as contas locais do UiPath (Opcional)

Embora opcional, recomendamos que você remova o uso de contas locais para maximizar os benefícios de conformidade principal e eficiência da integração completa entre a UiPath Platform e o Azure AD.

Importante: Apenas remova contas de não-administrador . É recomendável manter pelo menos uma conta local de administrador na organização para poder alterar as configurações de autenticação no futuro.

Após a migração de todos os usuários, você poderá remover os usuários não admin da guia Usuários , para que seus usuários não possam mais fazer login usando sua conta local. Você pode encontrar essas contas com base nos seus ícones de usuário .

Você também pode limpar as permissões individuais nos serviços de nuvem da UiPath, como o serviço do Orchestrator e remover usuários individuais de grupos para que as permissões dependam exclusivamente da associação de grupo do Azure AD.

Exceções

Se você decidir interromper o uso das contas locais, tenha em mente o seguinte:

• Acesso de API: se você tiver processos implementados que dependem das informações obtidas clicando em Acesso de API (Admin > página Tenants) para fazer chamadas de API para um serviço, você precisa de uma conta local, porque o botão não está disponível quando logado com uma conta do Azure AD.

  Alternativamente, você pode optar por usar o OAuth para a autorização ; neste caso as informações do Acesso de API não são mais necessárias.

Melhores práticas

Aqui estão algumas dicas úteis para os recursos avançados que você pode aproveitar agora que tem a integração do Azure AD configurada.

Restringir o acesso à sua organização

Como a integração com o Azure AD é realizada ao nível do tenant do Azure, por padrão todos os usuários do Azure AD podem acessar a UiPath Platform. A primeira vez que um usuário do Azure AD faz login em sua organização da UiPath, ele é automaticamente incluído no grupo Everyone do UiPath, que concede a ele a função de User organization-level .

Se você quiser permitir que apenas alguns usuários acessem sua organização, você pode ativar a atribuição de usuários para o registro do aplicativo UiPath no Azure. Dessa forma, os usuários precisam ser atribuídos explicitamente ao aplicativo para poderem acessá-lo. Para obter instruções, consulte este artigo na documentação do Azure AD.

Restringir o acesso às redes ou dispositivos confiáveis

Se você quiser permitir que seus usuários acessem a UiPath Platform apenas de uma rede confiável ou dispositivo confiável, pode usar a funcionalidade Acesso condicional do Azure AD .

Governança para grupos no Azure AD

Se você criou grupos no Azure AD para facilitar a integração de usuários à UiPath diretamente do Azure AD conforme descrito em Configurar grupos para permissões e robôs , você pode usar as opções de segurança avançadas do Gerenciamento de identidade privilegiada (PIM) para esses grupos para governar as solicitações de acesso para a UiPath grupos.

Perguntas frequentes

O que muda para os meus usuários após a ativação da integração?

Os usuários podem fazer login imediatamente usando sua conta do Azure AD e se beneficiar das mesmas permissões que tiveram em sua conta local.

Se você não tiver removido suas contas locais, os usuários também podem continuar a fazer login com sua conta local (ambos os métodos funcionam).

Para usar sua conta do Azure AD, eles devem navegar para o URL específico de sua organização, que é do formuláriohttps://govcloud.uipath.us/orgID/, ou selecionar o Enterprise SSO na página de logon principal.

Outra mudança que os usuários podem notar é que, se eles já estiverem logados em suas contas do Azure AD usando outro aplicativo, eles são automaticamente logados quando navegarem para esta URL.

Quais são as funções de cada conta?

Conta do Azure AD: quando um usuário faz login com sua conta do Azure AD, ele se beneficia imediatamente de todas as funções que tinha na conta local, além de qualquer função atribuída dentro da UiPath para a conta do Azure AD ou aos grupos do Azure AD aos quais pertence . Estas funções podem vir da inclusão do usuário do Azure AD ou do grupo do Azure AD nos grupos, ou de outros serviços em que as funções foram atribuídas ao usuário ou ao grupo do Azure AD.

Conta local: com a integração do Azure AD ativa, para contas locais, ela depende de:

• Se o usuário não tiver feito login pelo menos uma vez com sua conta do Azure AD, ele terá apenas as funções da conta local.
• Se os usuários fizerem login usando sua conta do Azure AD, a conta local terá todas as funções que o usuário do AAD tem dentro da UiPath, quer explicitamente atribuídas, quer herdadas das associações de grupos.

Preciso aplicar novamente as permissões para as contas do Azure AD?

Não. Como as contas correspondentes são automaticamente vinculadas, suas permissões existentes também se aplicam quando logados com a conta do Azure AD. Entretanto, se você decidir interromper o uso das contas locais, certifique-se de que as permissões apropriadas tenham sido previamente definidas para os usuários e grupos do Azure AD.