Extensão para Chrome

Importante:

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

Chrome update to version 149

The Chrome update to version 149 (started on June 2, 2026) introduced an upstream Chromium change that restricts the capabilities of extensions force-installed via enterprise policy when Developer Tools access is not explicitly allowed. For details, see this forum post.

To mitigate this issue, the following extension updates were released:

1. On June 1, 2026, the Chrome Web Store version of the UiPath extension installed via the Group Policy Online method (extension ID pgbnimfaaifjpebleldfhgcjdnaeafdi) was updated to version 26.10. This version is backward compatible and continues to work with older UiPath Studio and Robot versions.
2. Starting with Studio 24.10.22 and Studio 25.10.12, the version of the Chrome extensions installed via the Group Policy Offline method (extension ID ndmegdjihnhfmljjoaiimbipfhodnbgf) was updated to version 26.10. Earlier 24.10 and 25.10 Studio versions install version 24.10 of the Chrome extension.

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. Enable the UiPath Browser Automation extension if needed.

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. Clique em Instalar. A configuração do Studio continua enquanto também se instala a extensão para o Chrome.

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

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. In the DeveloperToolsAvailabilityAllowlist policy, add the value: chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf.

   In the DeveloperToolsAvailabilityBlocklist policy, add the value: https://uipath-devtools-blocklist-placeholder.invalid/.

   Observação:

   Instead of configuring DeveloperToolsAvailabilityAllowlist and DeveloperToolsAvailabilityBlocklist, you also have the option to set DeveloperToolsAvailability Group Policy to the value 1 (Allow usage of the Developer Tools) to enable the full extension functionality.

   However, we recommend the allowlist/blocklist policies option, as it enables you to specify only the UiPath extension ID, limiting the scope of the change to the required extension.

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. In the DeveloperToolsAvailabilityAllowlist policy, add the value: chrome-extension://pgbnimfaaifjpebleldfhgcjdnaeafdi.

   In the DeveloperToolsAvailabilityBlocklist policy, add the value: https://uipath-devtools-blocklist-placeholder.invalid/.

   Observação:

   Instead of configuring DeveloperToolsAvailabilityAllowlist and DeveloperToolsAvailabilityBlocklist, you also have the option to set DeveloperToolsAvailability Group Policy to the value 1 (Allow usage of the Developer Tools) to enable the full extension functionality.

   However, we recommend the allowlist/blocklist policies option, as it enables you to specify only the UiPath extension ID, limiting the scope of the change to the required extension.

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

Your system administrator might have configured Group Policies that prevent the UiPath Extension for Chrome from working. To enable it, please follow the instructions from the Group Policies page.

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