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. Acesse o Automation Cloud^TM.
2. No menu do lado esquerdo, clique em Integration Service. A janela do Integration Service inclui três guias separadas: Conectores, Conexões e Gatilhos. Por padrão, a guia Conectores é selecionada.
   
   

   

   
   
   .
3. 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.
   
   

   

   
   
4. Clique no Conector desejado para criar uma nova conexão ou atualizar uma existente.
5. Clique em Adicionar conexão. Dependendo do conector que você escolheu, as credenciais específicas necessárias para suas conexões são solicitadas.

Observação: para criar com sucesso uma conexão, 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 compartilhamento e configuração de conexão em 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. Acesse o Automation Cloud^TM.
2. No menu do lado esquerdo, clique em Integration Service. A janela Integration Service inclui três guias separadas: Conectores, Conexões e Gatilhos.
3. Selecione a Pasta em que 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.

4. Acesse a aba Conexões , onde a lista de conexões criadas será exibida.

5. Clique no 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. Acesse a aba Conexões .
2. No menu do lado esquerdo, clique em Integration Service. A janela do Integration Service inclui abas separadas para Conectores, Conexões e Gatilhos, juntamente com uma janela de navegação à esquerda exibindo as pastas.
3. Selecione a Pasta em que deseja modificar a conexão.
   Observação: a pasta pode ser selecionada após a etapa 4.
4. Acesse a aba Conexões , onde a lista de conexões criadas será exibida.
5. Passe o cursor do mouse sobre o nome da conexão que você deseja modificar e agora você deve ver o botão Editar exibido.
   Observação: como alternativa, você pode selecionar sua conexão na lista para acessar a exibição detalhada. O botão Editar está localizado no lado direito do seu nome de conexão.
6. Clique no botão Editar e poderá escolher um novo nome para sua conexão.

Autenticação múltipla

Você pode configurar opções de autenticação múltipla para conectores compatíveis no Integration Service. Isso permite que você selecione métodos alternativos de autenticação antes de criar uma conexão.

Para criar uma conexão usando autenticação múltipla, você deve executar as seguintes etapas:

1. No Integration Service, na lista Conectores , selecione um conector compatível.
2. Selecione o botão Adicionar conexão . Você será redirecionado para a página na qual é possível criar uma conexão.
3. Clique no ícone ⚙ para alterar seu tipo de autenticação.
4. Selecione seu método de autenticação preferido.
5. Insira as credenciais necessárias e clique em Conectar.

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 Código de Autorização do OAuth 2.0. Isso permite que você selecione um aplicativo privado durante 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ê poderá 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 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. Selecione o Integration Service do Automation Cloud^TM.

2. Na lista Conectores , selecione um conector compatível. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione o botão Adicionar conexão .

4. Você será redirecionado para a página de conexão.

5. Clique no ícone ⚙ para alterar seu tipo de autenticação.

6. Selecione Traga seu próprio aplicativo OAuth 2.0 no menu suspenso.

7. 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 no gerenciamento de soluções

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

Ao criar um pacote da 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 disparadores de eventos, você pode executar as mesmas etapas de configuração do Orchestrator.

Observação: você também pode editar esses campos no momento da implantação, a menos que 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 de solução agora podem ser implantadas.

Importante: 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 a configuração da conexão manual 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:

O Gerenciamento de soluções move 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 transfere as credenciais de autenticação.

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

• Configurável pelos usuários: nenhuma conexão é criada ou usada a partir das conexões 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 conclusão da implantação: 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. Ao selecionar Vincular à existente, uma janela pop-up exibe todas as conexões acessíveis ao usuário que esteja implantando o pacote de 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 nele. Use essa pasta se as preferências forem modificadas ou novas conexões adicionadas.

A opção Vincular a existente não fica disponível quando você edita uma configuração usando os seguintes métodos: Configuração de implantação ou Editar configuração de 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.

Importante:

As conexões criadas em qualquer pasta por meio do Gerenciamento 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 afetados pela atualização.