Conexões

Sobre conexões

As conexões ajudam a estabelecer tarefas entre usuários únicos e aplicativos externos. As conexões são criadas após os usuários se autenticarem com um provedor de API.

Criando uma conexão

1. No trilho esquerdo, selecione Integration Service. As janelas do Integration Service incluem três guias separadas: Conectores, Conexões e Gatilhos. Por padrão, a guia Conectores está selecionada.
2. Na seção Minhas Pastas, você pode selecionar se deseja trabalhar em seu espaço de trabalho pessoal ou em uma pasta compartilhada, onde as conexões criadas podem ser usadas por todos os usuários que têm acesso a essa pasta.
3. Selecione o Conector desejado para criar uma nova conexão ou atualizar uma existente.
4. Selecione Conectar a <Connector name>. Dependendo do conector que você escolher, as credenciais específicas necessárias para suas conexões serão solicitadas.
5. Selecione a pasta ou subpasta onde a conexão deve residir. Você pode trabalhar em seu espaço de trabalho pessoal ou em uma pasta compartilhada, onde as conexões criadas podem ser usadas por todos os usuários que têm acesso a essa pasta.

Observação:

Para criar uma conexão com sucesso, você deve configurar uma lista de permissão de endereços IP para o Integration Service. Para obter mais informações, consulte Configuração do firewall no Guia do administrador do Automation Cloud.

Conexões compartilhadas

Quando uma conexão é criada em uma pasta compartilhada, todos os usuários com acesso a essa pasta podem usar a conexão em seus fluxos de trabalho de automação. A conexão pode ser editada por todos os usuários com acesso a ela.

Observação:

Todos os conectores do Integration Service são compatíveis com o compartilhamento e a configuração no tempo de execução. Para obter mais informações sobre como configurar conexões no tempo de execução, consulte o Guia do usuário do Orchestrator.

Modificando conexões

1. No trilho esquerdo, selecione Integration Service. A janela Integration Service inclui três guias separadas: Conectores, Conexões e Gatilhos.
2. Selecione a pasta na qual você deseja modificar a conexão. Observação: a pasta na qual você deseja criar a conexão também pode ser selecionada após a etapa 4.
3. Go to the Connections tab, where the list of created connections is displayed.
4. Selecione o botão Mais correspondente à conexão desejada para modificá-la. É possível executar as seguintes ações:
   • Exclua a conexão.
   • Defina-o como padrão (essa opção fica disponível apenas se você tiver várias conexões estabelecidas para o mesmo aplicativo.
   • Verifique a conexão para verificar seu status.

Renomear conexões

Para renomear uma conexão, você precisa:

1. Access the Connections tab.
2. No menu à esquerda, selecione Integration Service. A janela do Integration Service inclui guias separadas para Conectores, Conexões e Gatilhos, além de uma janela de navegação à esquerda que exibe as pastas.
3. Selecione a pasta na qual você deseja modificar a conexão. Observação: a pasta pode ser selecionada após a etapa 4.
4. Go to the Connections tab, where the list of created connections is displayed.
5. Passe o cursor do mouse sobre o nome da conexão que você deseja modificar. O botão Editar é exibido. Observação: como alternativa, você pode selecionar sua conexão na lista para acessar a visualização detalhada. O botão Editar está localizado no lado direito do nome da sua conexão.
6. Selecione o botão Editar e você poderá escolher um novo nome para sua conexão.

Como gerenciar conexões

Você pode gerenciar conexões do Integration Service diretamente no UiPath Assistant. Para saber mais, consulte Conexões no UiPath Assistant.

Selecione Configurar no navegador para abrir a página Conexões no Studio Web. Para saber mais, consulte Gerenciamento de conexões no guia do usuário do Studio Web.

Observação:

Os usuários da Automation Cloud para o Setor Público podem visualizar conexões no UiPath Assistant, mas não gerenciá-las. Em vez disso, eles podem configurar e gerenciar conexões do Integration Service usando a aba Requisitos de pacote no Orchestrator.

Selecionando o tipo de autenticação

Alguns conectores no Integration Service são compatíveis com vários métodos de autenticação. Você pode selecionar seu método preferido antes de iniciar uma conexão.

1. No Integration Service, na lista Conectores , selecione um conector compatível.

2. Selecione Conectar a <connector name> para acessar a página de configuração da conexão.

3. Use o menu suspenso Pasta na qual a conexão é armazenada para escolher a pasta apropriada (por exemplo, Meu espaço de trabalho).

4. Use o menu suspenso Tipo de autenticação para selecionar as opções disponíveis, como:

   • Código de autorização do OAuth 2.0
   • Senha do OAuth 2.0
   • Traga seu próprio aplicativo OAuth 2.0
   • Token de acesso pessoal (PAT)

   Observação: as opções disponíveis podem variar dependendo do conector.

5. Insira as credenciais necessárias para seu tipo de autenticação selecionado e, em seguida, selecione Conectar para estabelecer a conexão.

Traga seu próprio aplicativo OAuth 2.0

A experiência de autenticação permite que você use a opção Traga seu próprio aplicativo OAuth 2.0 (BYOA) para conectores que são compatíveis com o código de autorização OAuth 2.0. Isso permite que você selecione um aplicativo privado ao fazer a autenticação antes de fazer sua conexão.

Para criar uma conexão usando o método Traga seu próprio aplicativo OAuth 2.0 , você precisa das seguintes credenciais:

• ID do Cliente
• Segredo do cliente

Observação:

Se sua organização usar BYOA, você pode definir valores padrão para essas credenciais por meio de uma política de governança do Integration Service no Automation Ops. Para obter mais informações, consulte Configurações para políticas do Integration Service.

Quando você cria um aplicativo do OAuth privado com um terceiro, siga a documentação específica de terceiros para configurá-lo. Certifique-se de definir o URI de redirecionamento (ou URL de retorno de chamada) para seu aplicativo como: https://cloud.uipath.com/provisioning_/callback.

Para criar uma conexão com seu aplicativo privado OAuth 2.0, execute as seguintes etapas:

1. Vá para Integration Service. Na lista Conectores , selecione um conector compatível.
2. Selecione o botão Conectar a .
3. Você será redirecionado para a página de conexão.
4. Selecione Trazer seu próprio aplicativo OAuth 2.0
5. Insira seu ID do cliente e Segredo do cliente e selecione Conectar.

Observação:

Para conexões de aplicativo OAuth 2.0, criptografamos e armazenamos o token de autenticação, mas não o usamos para acessar nenhum dado do cliente.

Conexões em Soluções

Você pode gerenciar conexões e gatilhos de eventos como parte do seu pacote de solução. Consulte Visão geral do gerenciamento de soluções para saber o que são pacotes de soluções, como funcionam e como criar, gerenciar e implantá-los.

Quando você cria um pacote de solução, as conexões e seus gatilhos de eventos associados ficam disponíveis no painel Componentes . Você pode editar as seguintes propriedades: Nome da conexão, Descrição da conexão e Tipo de autenticação. Para gatilhos de eventos, você pode executar as mesmas etapas de configuração que no Orchestrator.

Observação:

Você também pode editar esses campos no momento da implantação, a menos que eles estejam bloqueados para edição.

Após a solução ser criada e publicada, as conexões ficam disponíveis no painel Componentes da solução. Todas as conexões selecionadas ao criar o pacote da solução agora podem ser implantadas.

O Gerenciamento de soluções não exibe conexões para processos, a menos que um gatilho de evento também esteja conectado. O problema pode afetar a implantação da solução, exigindo configuração manual da conexão para a operação adequada.

Você pode optar por implantar o pacote de solução em uma pasta específica que ainda não existe no Integration Service. Nesse caso, a pasta é criada automaticamente.

Tipo de autenticação de conexão

Como administrador, você decide durante a implantação se deve usar uma conexão existente, criar uma nova ou permitir que o usuário final selecione a conexão.

Observação:

As soluções movem as conexões e suas relações de entidade associadas (como fluxos de trabalho e processos aos quais a conexão pertence), mas não transferem credenciais de autenticação.

Durante a implantação, o administrador pode definir o Tipo de autenticação como:

• Configurável por usuários: nenhuma conexão é criada ou usada a partir das existentes. Espera-se que os usuários configurem a conexão depois que a solução for implantada no runtime. Consulte Configuração de conexões na documentação do Orchestrator.

• Autenticar após a implantação ser concluída: uma nova conexão é criada e requer autenticação após a implantação. A conexão permanece inativa até que a etapa de autenticação seja concluída.

  • Antes que a autenticação seja concluída, o nome de usuário é exibido como System. Assim que a autenticação for bem-sucedida, o nome de usuário será atualizado para exibir as credenciais do autenticador.

Também há a opção de vincular componentes. Quando você seleciona Vincular à existente, uma janela pop-up exibe todas as conexões acessíveis ao usuário que implanta o pacote da solução. Você pode escolher qualquer conexão existente para fazer parte do pacote da solução.

Observação:

Se você selecionar conexões existentes para os conectores incluídos no pacote da solução e também selecionar uma nova pasta durante a implantação, a pasta será criada no Integration Service, sem conexões nela. Use essa pasta se as preferências forem modificadas ou se novas conexões forem adicionadas.

A opção Vincular a existente não está disponível ao editar uma configuração usando os seguintes métodos: Configuração da implantação ou Editar configuração da implantação. Para vincular componentes ou editar o tipo de autenticação após a implantação, você deve atualizar o pacote da solução. Isso requer editar a solução e implantar a nova versão novamente.

As conexões criadas em qualquer pasta por meio de Soluções não são excluídas, mesmo ao atualizar o fluxo de trabalho para usar conexões diferentes. Isso garante que os processos e automações que dependem dessas conexões não sejam impactados pela atualização.