Configuração da conexão de serviço

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](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/service-endpoints?view=azure-devops&tabs=yaml).

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 Azure Marketplace da Microsoft (PaaS), você precisa acessar informações do Orchestrator e 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:

Abra seu projeto do Azure DevOps (por exemplo, https://yourCompany.visualstudio.com/yourProject).
Navegue até Configurações do projeto > Conexões de serviço.
Clique em Nova conexão de serviço e use a função de pesquisa para encontrar Conexão do UiPath Orchestrator.
Clique em Avançar e escolha um método de autenticação.
Pule até um dos métodos de autenticação e depois volte para continuar a configuração.
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.

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, retorne à etapa 6 em 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 Exibição de informações de acesso à API.
Tenant: adicione seu tenant provisionado.

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

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.

Faça logon no Automation Cloud ou Automation Suite como Administrador e navegue até Administrador > Aplicativos externos.
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:

Clique em Adicionar escopos.
Selecione Acesso de API do Orchestrator como Recurso
Selecione os seguintes escopos:
- OU.Pastas
- OR.BackgroundTasks
- OR.TestSets
- OR.TestSetExecutions
- OR.TestSetSchedules
- OU.Configurações.Ler
- OU.Robôs.Leitura
- OR.Machines.Read
- OU. Execução
- OU. Ativos
- OU.Usuários.Leitura
- OU.Empregos
- OR.Monitoring
  
  Você pode usar este 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.MonitoringOR.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
```
Clique em Salvar.
- URL de redirecionamento: você pode deixar este campo em branco.
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, 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).
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.
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, retorne à etapa 6 em Configuração da conexão de serviço do UiPath Orchestrator para concluir a configuração da conexão de serviço.