Extensão para Chrome

Importante:

UiPath Inc. and its affiliates do not process, use, access, or store any customer data when using this product.

Atualização do Chrome para a versão 149

A atualização do Chrome para a versão 149 (iniciada em 2 de junho de 2026) introduziu uma alteração upstream do Chromium que restringe os recursos de extensões instaladas forçadamente por meio da política empresarial quando o acesso às Ferramentas do desenvolvedor não é explicitamente permitido. Para obter detalhes, consulte esta postagem do fórum.

Para mitigar esse problema, foram lançadas as seguintes atualizações de extensão:

1. Em 1º de junho de 2026, a versão da Chrome Web Store da extensão UiPath instalada por meio do método de Política de grupo Online (extensão ID pgbnimfaaifjpebleldfhgcjdnaeafdi) foi atualizada para a versão 26.10. Essa versão é compatível com versões anteriores e continua a funcionar com versões mais antigas do UiPath Studio e do UiPath Robot.
2. A partir do Studio 24.10.22 e Studio 25.10.12, a versão das extensões do Chrome instaladas por meio do método de Política de grupo off-line (ID da extensão ndmegdjihnhfmljjoaiimbipfhodnbgf) foi atualizada para a versão 26.10. Versões anteriores 24.10 e 25.10 do Studio instalam a versão 24.10 da extensão do Chrome.

Essa extensão ajuda a criar automações do navegador no Google Chrome.

Você pode instalar essa extensão de várias maneiras, conforme mostrado abaixo:

Instalar a partir do UiPath Studio

1. Abra o Studio.
2. Navegue até Início > Ferramentas > Extensões da UiPath.
3. Selecione Chrome > Instalar. Escolha um dos métodos disponíveis no menu suspenso:
   • Política de grupo off-line
   • Política de grupo on-line
   • Todos os usuários
   • Usuário atual
   • Somente host nativo
4. Open Chrome and navigate to chrome://extensions.
5. Habilite a extensão UiPath Browser Automation se necessário.

Resultado

The UiPath Extension for Chrome is installed and active in Google Chrome.

Instalar a partir do Instalador do Studio

1. Execute o instalador UiPathStudio.msi.
2. Select an install mode, and then select Advanced Settings > Extensions > UiPath extension for Chrome. If Chrome is installed on your machine, the option is selected by default.
3. Select Install. Studio setup continues while also installing the extension for Chrome.

A Extensão UiPath para Chrome também pode ser instalada a partir da linha de comando do UiPathStudio.msi.

Resultado

The UiPath Extension for Chrome is installed.

Instalar a partir da Política de Grupo

Você também pode instalar a Extensão do UiPath para o Chrome usando as Políticas de Grupo. Esse método instala silenciosamente a extensão, habilitando-a sem exigir confirmação por parte do usuário.

Para ambos os métodos de instalação de Política de Grupo, o navegador não mostra o banner quando a extensão usa a API do depurador.

Recomendamos usar a instalação Política de grupo off-line porque o ID da extensão não muda ao ser atualizado para versões mais recentes. Esse método usa uma extensão que é assinada pela UiPath em vez da Chrome Web Store. Isso significa que, após atualizar a versão, não há necessidade de atualizar as Políticas de grupo internas (ou seja, a política ExtensionInstallForceList) com um novo ID de extensão.

Outra vantagem da reutilização do mesmo ID de extensão é que as configurações definidas para a extensão (como Permitir no modo anônimo ou Permitir acesso a URLs de arquivo) não são redefinidas após uma atualização de versão.

Offline

O método de instalação offline da política de grupo requer que a máquina de destino esteja ingressada em um domínio do Microsoft Active Directory ou Azure Active Directory.

Não é necessário ter acesso à Chrome Web Store para que ele possa ser usado em máquinas com acesso restrito à Internet.

O UiPathStudio.msi usa esse método de instalação por padrão se seus requisitos forem atendidos.

Você também pode usar este método de instalação executando a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chrome-policy-offline /silent

Se sua organização usar Políticas de Grupo para gerenciamento de extensões de navegador, as seguintes alterações também terão que ser feitas na definição de políticas de grupo da sua organização:

1. Na política ExtensionInstallForcelist, adicione o valor: ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml

2. Na política NativeMessagingAllowlist, adicione o valor: com.uipath.chromenativemsg_v2.

   Observação:

   Você só precisa definir o valor da política NativeMessagingAllowlist quando a política NativeMessagingBlockList for definida com o valor de *.

3. Na política DeveloperToolsAvailabilityAllowlist , adicione o valor: chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf.

   Na política DeveloperToolsAvailabilityBlocklist , adicione o valor: https://uipath-devtools-blocklist-placeholder.invalid/.

   Observação:

   Em vez de configurar DeveloperToolsAvailabilityAllowlist e DeveloperToolsAvailabilityBlocklist, você também tem a opção de definir a Política de Grupo DeveloperToolsAvailability como o valor 1 (Permitir o uso das Ferramentas de Desenvolvedor) para habilitar a funcionalidade de extensão completa.

   No entanto, recomendamos a opção de políticas de lista de permissões/lista de bloqueios, pois permite que você especifique apenas o ID da extensão da UiPath, limitando o escopo da alteração à extensão necessária.

Se você precisa hospedar a extensão da UiPath na sua loja virtual interna você pode encontrar o arquivo .crx neste local:

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_chrome_self_hosted_mv3.crx.

Importante:

Se essas alterações não forem feitas após a instalação, as configurações da extensão UiPath poderão ser substituídas durante as atualizações periódicas da Política de grupo.

Online

O método de instalação da política de grupo online requer que a máquina de destino tenha acesso à Chrome Web Store (https://clients2.google.com/service/update2/crx e https://clients2.googleusercontent.com/crx).

O UiPathStudio.msi usa esse método de instalação se seus requisitos forem atendidos e a máquina não estiver associada a um Microsoft Active Directory.

Você também pode usar este método de instalação executando a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromepolicyglobal /silent

Se sua organização usar Políticas de Grupo para gerenciamento de extensões de navegador, as seguintes alterações também terão que ser feitas na definição de políticas de grupo da sua organização:

1. Na política ExtensionInstallForcelist, adicione o valor: pgbnimfaaifjpebleldfhgcjdnaeafdi;https://clients2.google.com/service/update2/crx

2. Na política NativeMessagingAllowlist, adicione o valor: com.uipath.chromenativemsg_v2.

   Observação:

   Você só precisa definir o valor da política NativeMessagingAllowlist quando a política NativeMessagingBlockList for definida com o valor de *.

3. Na política DeveloperToolsAvailabilityAllowlist , adicione o valor: chrome-extension://pgbnimfaaifjpebleldfhgcjdnaeafdi.

   Na política DeveloperToolsAvailabilityBlocklist , adicione o valor: https://uipath-devtools-blocklist-placeholder.invalid/.

   Observação:

   Em vez de configurar DeveloperToolsAvailabilityAllowlist e DeveloperToolsAvailabilityBlocklist, você também tem a opção de definir a Política de Grupo DeveloperToolsAvailability como o valor 1 (Permitir o uso das Ferramentas de Desenvolvedor) para habilitar a funcionalidade de extensão completa.

   No entanto, recomendamos a opção de políticas de lista de permissões/lista de bloqueios, pois permite que você especifique apenas o ID da extensão da UiPath, limitando o escopo da alteração à extensão necessária.

Importante:

Se essas alterações não forem feitas após a instalação, as configurações da extensão UiPath poderão ser substituídas durante as atualizações periódicas da Política de grupo.

Desinstalando

A extensão UiPath para Chrome pode ser desinstalada executando uma solicitação a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromecleanup /silent

Você também pode desinstalar abrindo o Studio, navegando até Página inicial > Ferramentas > UiPath Extensions e selecionando Chrome > Desinstalar. A extensão será desinstalada com o mesmo método usado para a instalação. Esse método é exibido no menu suspenso desabilitado ao lado do botão Desinstalar.

Chrome version requirements

A extensão UiPath para Chrome MV2 requer o Chrome versão 64 ou superior.

A extensão UiPath para Chrome MV3 requer o Chrome versão 98 ou superior.

Ao usar um dos métodos de instalação descritos acima, a versão do navegador será verificada e a extensão com o formato apropriado (MV2 ou MV3) será instalada automaticamente.

New extension features

Automatizando apps do Chrome

A partir da versão UiPathStudio.msi2022.4, a extensão UiPath para Chrome pode ser usada para automatizar Apps do Chrome.

Várias instâncias do Chrome com vários perfis de usuário

A partir da versão 2023.10 do UiPath, a extensão UiPath para Chrome é compatível com a automação de várias instâncias de navegador em execução com vários perfis de usuário ao mesmo tempo.

Para versões anteriores à versão 2023.10, a extensão UiPath para Chrome não era compatível com a automação de várias instâncias de navegador em execução com vários perfis de usuário ao mesmo tempo. Dessa forma, a automação do navegador exigia que você fechasse todas as instâncias ativas do Chrome e reiniciasse o navegador usando um único perfil do usuário. A partir da versão 2023.10, é possñivel acomodar cenários de vários processos de navegador em execução sob diferentes perfis de navegador, como o caso em que um aplicativo específico deve ser executado em um perfil dedicado para isolar dados confidenciais de outros aplicativos.

Observação:

A automação de vários perfis de navegador requer UiPath.UIAutomation.Activities v23.10 ou mais recente e a extensão de navegador instalada com UiPathStudio.msi v2023.10 ou mais recente.

Agora é possível abrir o navegador com um perfil específico ao usar a atividade Use Application/Browser. Para especificar um perfil na inicialização do navegador, é necessário anexar um argumento à linha de comando do navegador. Para isso, use a propriedade Argumentos no campo de entrada Destino do Aplicativo Unificado.

Para Chrome, o argumento necessário é: --profile-directory="profile_path".

O profile_path é o caminho relativo para o caminho da pasta de dados do usuário especificado para essa atividade Use Application/Browser. Se o caminho da pasta de dados do usuário não for especificado, o caminho do perfil será relativo ao diretório de dados do usuário padrão %LOCALAPPDATA%\Google\Chrome\User Data%. Para descobrir o caminho do perfil, navegue até chrome://profile-internals/ e obtenha-o na entrada Caminho do perfil.

Solução de problemas

O administrador do seu sistema pode ter configurado Políticas de Grupo que que impedem que a Extensão do UiPath para o Chrome funcione. Para habilitá-la, siga as instruções da página Políticas de Grupo.

Para quaisquer outros problemas relacionados à Extensão do UiPath para o Chrome, consulte a página detalhada de solução de problemas.