Conexões

Crie e gerencie conexões no Integration Service para Automation Suite, estabelecendo links autenticados entre usuários e aplicativos externos.

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.

Pré-requisitos

Antes de poder usar conexões, certifique-se de que as seguintes condições sejam atendidas:

• O Integration Service é habilitado e provisionado para seu tenant.
• Os usuários que trabalham com conexões têm as permissões necessárias no Orchestrator. Para criar uma conexão, um usuário deve ter a permissão Conexões - Criar na pasta de destino. Para obter mais informações sobre permissões, consulte Configuração de acesso para contas no guia do usuário do Orchestrator.

Criando uma conexão

1. Acesse o Automation Suite.
2. No menu à esquerda, 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. Apenas os conectores instalados em seu ambiente local são exibidos.

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

2. Selecione o Conector desejado para criar uma nova conexão ou atualizar uma existente.
3. Selecione Conectar a <connector name>. Dependendo do conector que você escolher, as credenciais específicas necessárias para suas conexões serão solicitadas.

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.

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:

   Alternatively, you can select your connection from the list to access the detailed view. The Edit button is located on the right side of your connection name.

6. Selecione o botão Editar e você poderá escolher um novo nome para sua conexão.

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.

Configuração de conexões por ambiente

Você pode configurar conexões separadas para diferentes ambientes de implantação, como desenvolvimento, testes e produção, sem modificar seus fluxos de trabalho de automação. Todos os conectores do Integration Service são compatíveis com a configuração de conexão de runtime.

Para configurar conexões por ambiente:

1. Crie uma conexão nomeada para cada ambiente de destino usando o mesmo conector. Por exemplo, Salesforce Dev, Salesforce Test e Salesforce Production.
2. Coloque cada conexão na pasta do Orchestrator que corresponde ao ambiente de destino.
3. No Orchestrator, use a aba Requisitos do pacote para especificar qual conexão um processo usa quando é executado em cada ambiente.

Quando você executa uma automação publicada, o Orchestrator usa a conexão atribuída à pasta para esse ambiente.

Para obter instruções passo a passo, consulte Configuração de conexões no guia do usuário do Orchestrator.

Traga seu próprio aplicativo OAuth 2.0

O UiPath Integration Service oferece um modelo de traga seu próprio aplicativo OAuth 2.0 (BYOA) , que permite que as empresas se conectem usando seus próprios aplicativos OAuth 2.0 em vez do aplicativo OAuth público padrão da UiPath.

A UiPath registra e mantém aplicativos OAuth 2.0 em portais de desenvolvedores de fornecedores para a maioria dos conectores (por exemplo, Microsoft, Google, Salesforce, Atlassian Jira etc.). Na maioria dos casos, esses aplicativos vêm com escopos predefinidos e são gerenciados totalmente pela UiPath.

No entanto, algumas organizações podem ter políticas rigorosas de TI, segurança ou conformidade que as impedem de usar registros de aplicativos externos. Nesses casos, a BYOA permite que os clientes usem seu próprio ID do cliente e Segredo do cliente para autenticar e autorizar conexões do Integration Service.

Observação:

Ao usar o Integration Service em um ambiente no local, se for solicitado que você autentique usando um ID e segredo do cliente, você deve criar seu próprio aplicativo OAuth 2.0, semelhante à opção Traga seu próprio aplicativo OAuth 2.0 .

Cenários comuns de quando usar BYOA

Use o BYOA quando:

• O aplicativo é compatível com o tipo de autenticação de concessão de código de autorização OAuth 2.0. Outros tipos de OAuth 2.0 não podem ser usados em BYOA.
• Sua empresa exige que todas as integrações de terceiros usem aplicativos OAuth gerenciados internamente.
• Você precisa adicionar ou modificar escopos que não fazem parte do aplicativo registrado padrão do UiPath.
• As políticas de segurança ou conformidade da sua organização proíbem o uso de aplicativos compartilhados.
• Você deseja controlar o ciclo de vida do aplicativo OAuth, incluindo a rotação de segredos.

Observação:

Os aplicativos OAuth públicos da UiPath usam escopos fixos e não podem ser modificados por solicitação do cliente. Se você precisar de escopos adicionais, BYOA é a opção correta.

Como a BYOA funciona

Ao criar uma conexão no Integration Service, você pode selecionar Traga seu próprio aplicativo OAuth 2.0 como o tipo de autenticação.

Isso permite que você insira:

• ID do cliente e Segredo do cliente - Credenciais obtidas a partir do registro do seu aplicativo no portal do desenvolvedor do fornecedor.
• Escopos - Permissões exigidas pelo conector.
• URI de redirecionamento – URL de retorno de chamada não editável (https://{yourDomain}/provisioning_/callback para o Automation Suite). Essa é a URL de retorno de chamada que o Integration Service usa para concluir o fluxo do OAuth.

O Integration Service usa suas credenciais para executar o fluxo do OAuth e armazena com segurança os tokens de acesso resultantes e atualização.

Configurando uma conexão BYOA

Etapa 1: registrar um aplicativo OAuth no portal do fornecedor

Crie um aplicativo OAuth 2.0 no portal do desenvolvedor do fornecedor (por exemplo, Salesforce, Microsoft, Jira ou Google). Durante o registro:

• Defina o URI de redirecionamento/retorno de chamada como https://{yourDomain}/provisioning_/callback.
• Adicione os escopos necessários . Consulte a documentação específica do conector para escopos obrigatórios.
• Certifique-se de que o fornecedor ofereça suporte ao tipo de concessão exigido pelo conector (Concessão de código de autorização).

Etapa 2: criar uma conexão no Integration Service

1. No Integration Service, na lista de Conectores , selecione o conector desejado e, em seguida, selecione Conectar para abrir a página de criação de conexão.

2. Se vários tipos de autenticação estiverem disponíveis, selecione o tipo de autenticação Traga seu próprio aplicativo OAuth 2.0.

3. Insira os seguintes detalhes do aplicativo registrado:

   • ID do Cliente
   • Segredo do Cliente
   • Escopos (selecione entre os existentes ou os digite manualmente)
   Observação:

   Muitos fornecedores (Atlassian Jira, Coupa etc.) esperam que os mesmos escopos também estejam presentes em seu aplicativo.

4. Siga as solicitações na tela para concluir o fluxo de consentimento do OAuth fornecendo seu nome de usuário e senha na página de login do fornecedor.

5. Após a autorização, a conexão será armazenada com segurança e estará disponível para uso.

6. O Integration Service se encarrega de atualizar periodicamente o token de acesso.

Etapa 3: verificar escopos obrigatórios

Cada conector tem escopos obrigatórios necessários para suas atividades e gatilhos.

Se seu aplicativo BYOA não incluir esses escopos, a criação da conexão falhará ou certas ações podem não funcionar conforme o esperado.

Consulte a documentação do conector para confirmar a lista de escopos obrigatórios.

Melhores práticas

• Usar um registro de aplicativo empresarial dedicado para o UiPath Integration Service; evite reutilizar IDs de aplicativos de integrações não relacionadas.
• Inclua apenas os escopos necessários para acesso com privilégio mínimo.
• Mantenha os segredos do cliente rotacionados periodicamente e atualize-os no Integration Service editando conexões.
• Documente a propriedade do aplicativo e garanta a continuidade se os administradores mudarem.
• Verifique se os URIs de redirecionamento correspondem exatamente ao valor exibido no Integration Service; URIs incompatíveis causam erros de OAuth.

Segurança e manutenção

• As credenciais da BYOA são criptografadas e armazenadas com segurança no UiPath Integration Service e nunca são expostas em texto simples.
• A UiPath não gerencia nem monitora suas credenciais ou escopos de aplicativos personalizados.
• A rotação de segredo, cancelamento de registro de aplicativo ou manutenção de escopo são de responsabilidade do cliente.

Problemas comuns

A tabela a seguir lista problemas comuns encontrados ao usar conexões BYOA, juntamente com suas possíveis causas e resoluções.

Issue	Possível causa	Resolution
Segredo ou cliente inválido	Segredo ou ID do cliente incorreto.	Verifique as credenciais do registro de aplicativo do fornecedor.
Incompatibilidade de URI de redirecionamento	O URI de redirecionamento no aplicativo de fornecedor não corresponde ao valor da UiPath.	Atualize o URI de redirecionamento no registro de aplicativo do fornecedor.
Escopos insuficientes ou acesso negado	Escopos obrigatórios ausentes no aplicativo do fornecedor.	Adicione os escopos necessários e reautorize.
Token expirando com frequência	Aplicativo do fornecedor configurado com tokens de vida curta.	Habilite os tokens de atualização no aplicativo ou estenda a validade dos tokens.

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.

Solução de problemas de conexão

Para obter informações sobre como corrigir problemas comuns que você pode encontrar ao usar conexões, consulte Solução de problemas de conexões.