Configuração da conexão de serviço do Azure DevOps

Você pode usar a conexão de serviço no Azure Pipelines para se conectar aos serviços do UiPath Orchestrator para poder executar tarefas de automação.

Para obter mais informações, consulte Gerenciar conexões de serviço.

Considerações

Antes de começar a configurar a conexão de serviço do UiPath Orchestrator, considere o seguinte:

• Se você executa o Orchestrator em suas instalações locais, pode usar o método de Autenticação Básica.
• Para versões Cloud do Orchestrator (SaaS), você pode usar o método de Autenticação Externa para registrar o plug-in no Automation Cloud™ ou Automation Suite.
• Se sua instância do Orchestrator estiver implantada no Microsoft Azure Marketplace (PaaS), você precisa acessar informações do Orchestrator e do Identity Server. Para obter mais informações, consulte Implantação do Azure Marketplace.

Configuração da conexão de serviço do UiPath Orchestrator

Para adicionar o Orchestrator ao Azure DevOps, você precisa adicionar e configurar uma conexão de serviço, da seguinte forma:

1. Abra seu projeto do Azure DevOps (por exemplo, https://yourCompany.visualstudio.com/yourProject).

2. Navegue até Configurações do projeto > Conexões de serviço.

3. Clique em Nova conexão de serviço e use a função de pesquisa para encontrar Conexão do UiPath Orchestrator.

4. Clique em Avançar e escolha um método de autenticação.

5. Pule até um dos métodos de autenticação e depois volte para continuar a configuração.

6. Defina as configurações da conexão de serviço a seguir:

   • Nome da conexão de serviço e Descrição: insira um nome para sua conexão de serviço e adicione uma descrição opcional.
   • Conceder permissão de acesso a todos os pipelines: selecione essa opção para conceder permissões para pipelines no nível do projeto.

Configuração da autenticação

Esta seção descreve os métodos de autenticação que você pode usar, dependendo do cenário de implantação do Orchestrator.

Implantação do Orchestrator	Método de autenticação
MSI	Autenticação básica Autenticação de aplicativo externo
Automation Suite	Autenticação básica Autenticação de aplicativo externo Autenticação Baseada em Token
Automation Cloud	Autenticação básica Autenticação de aplicativo externo Autenticação Baseada em Token

Observação:

O método recomendado é usar a Autenticação de aplicativo externo.

Autenticação básica

Use este método se sua instância do Orchestrator estiver sendo executada em suas instalações locais. Defina as seguintes configurações para esse método de autenticação:

• URL do Orchestrator: adicione o URL Público do Orchestrator ao qual o Identity Server se conecta. (por exemplo, https://orchestrator.yourDomain.local)
• Nome de usuário e Senha: insira seu nome de usuário e senha do Orchestrator. Se você usa a autenticação federada em sua organização, é necessário adicionar o nome de usuário da seguinte forma: yourDomain\yourUsername.
• Tenant: adicione seu tenant provisionado.

Após concluir as configurações básicas de autenticação, volte para Configuração da conexão de serviço do UiPath Orchestrator para concluir a configuração da conexão de serviço.

Autenticação Baseada em Token

Para a autenticação baseada em token, defina as seguintes configurações:

• URL do Orchestrator: adicione o URL Público do Orchestrator ao qual o Identity Server se conecta. (por exemplo, https://orchestrator.yourDomain.local).
• Nome da conta: adicione a URL exclusiva de sua organização.
• Chave da API: a chave da API pode ser encontrada no Automation Cloud™ ou Automation Suite, em Tenants > Acesso à API. Para obter mais informações, consulte Visualização de informações de acesso à API.
• Tenant: adicione seu tenant provisionado.

Após concluir as configurações de autenticação baseada em token, volte para Configuração da conexão de serviço do UiPath Orchestrator para concluir a configuração da conexão de serviço.

Autenticação de aplicativo externo

Você pode usar esse método se sua instância do Orchestrator estiver sendo executada na nuvem ou pelo Automation Suite. Para esse método de autenticação, você precisa configurar um aplicativo externo e fornecer os escopos no Automation Cloud™ ou Automation Suite.

1. Faça login no Automation Cloud™ ou Automation Suite como Administrador e navegue até Administrador > Aplicativos externos.

2. Clique em Adicionar aplicativo e defina as seguintes configurações:

   • Nome do aplicativo: insira um nome para o seu aplicativo.
   • Tipo de aplicativo: defina este valor como aplicativo Confidencial.
   • Recursos: configure os seguintes escopos do aplicativo:

3. Clique em Adicionar escopos.

4. Selecione Acesso de API do Orchestrator como Recurso.

5. Selecione os seguintes escopos:

   • OR.Folders
   • OR.BackgroundTasks
   • OR.TestSets
   • OR.TestSetExecutions
   • OR.TestSetSchedules
   • OR.Settings.Read
   • OR.Robots.Read
   • OR.Machines.Read
   • OR.Execution OR.Assets
   • OR.Users.Read
   • OR.Jobs
   • OR.Monitoring

Você pode usar esse bloco de código para copiar a lista de escopos do aplicativo:

OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring

6. Clique em Salvar.

   • URL de redirecionamento: você pode deixar este campo em branco.

7. Clique em Adicionar para registrar o aplicativo.

   Importante:

   • Um ID de aplicativo e um Segredo serão gerados no final. Mantenha essas informações em um local seguro e de fácil acesso para uso posterior.
   • Se você gerar e usar um novo Segredo, o antigo será invalidado.

   Para obter mais informações, consulte Adicionar aplicativo externo no Automation Cloud™ ou Gerenciamento de aplicativos externos no Automation Suite.

Após concluir o registro do aplicativo externo no Automation Cloud™ ou Automation Suite, você pode definir as seguintes configurações:

• URL do Orchestrator: adicione o URL Público do Orchestrator ao qual o Identity Server se conecta. (por exemplo, https://orchestrator.yourDomain.local).
• URL do Identity (apenas para o Orchestrator implantado no Azure Marketplace): adicione o URL do Identity Server. Encontre-o na seção Visão geral do seu Serviço de Aplicativo.

Observação:

Para os Cloud Orchestrators, o campo URL de Identidade deve ser deixado em branco.

• Nome da conta: adicione a URL exclusiva de sua organização. Isso é opcional se seu Orchestrator tiver sido implantado no Azure Marketplace.
• ID do aplicativo e Segredo: adicione o ID do aplicativo e Segredo gerados no registro do aplicativo externo.
• Escopos do aplicativo: adicione os escopos que você registrou como Recursos para o aplicativo externo.
• Tenant: isso é opcional se seu Orchestrator tiver sido implantado no Azure Marketplace.

Após concluir as configurações do aplicativo externo, volte para Configuração da conexão de serviço do UiPath Orchestrator para concluir a configuração da conexão de serviço.