Extensión de Chrome en Mac

Instala la extensión UiPath para Chrome en Mac para la automatización del navegador, con opciones para la instalación a nivel de usuario o en toda la máquina.

Esta extensión ayuda a crear automatizaciones de navegador en Google Chrome en Mac.

Instalar

You can install the Chrome extension using one of the following methods:

• Usuario actual
• Todos los usuarios
• Póliza de grupo en línea
• Política de grupo sin conexión
• Current User (Native Messaging Host only)
• All Users (Native Messaging Host only)

Installs can be performed using UiPath Assistant or from Terminal (invoking UiPath.ExtensionControl.Portable.dll).

UiPath Assistant and UiPath.ExtensionControl.Portable.dll install the latest extension version, as follows:

Tipo de instalación	Extension version
Usuario actual	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Todos los usuarios	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Póliza de grupo en línea	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Política de grupo sin conexión	Latest self-hosted extension bundled with UiPath Assistant.
Current User (Native Messaging Host only)	Latest UiPath extension for Studio Web published on the Chrome WebStore.
All Users (Native Messaging Host only)	Latest UiPath extension for Studio Web published on the Chrome WebStore.

You can also use UiPath.ExtensionControl.Portable.dll to install a specific browser extension version. Run it with the help command for details:

dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll help install chrome

Usuario actual

Este método instala la extensión solo para el usuario actual. Crea o actualiza los archivos de configuración JSON que utiliza Chrome para detectar extensiones. Estos archivos definen el ID de extensión, la URL de actualización y la ruta al host nativo de mensajería.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the Current User install type.

   

6. Selecciona Instalar.

7. Selecciona Habilitar extensión en la ventana emergente de confirmación de Google Chrome.

   

Resultado: la extensión está instalada y habilitada.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.

1. Abra una Terminal y ejecute el siguiente comando:

   dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome
   

2. Selecciona Habilitar extensión en la ventana emergente de confirmación de Google Chrome.

   

Resultado: la extensión está instalada y habilitada.

Nota:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

Todos los usuarios

This method installs the extension for all users on the machine. It works similarly to the Current User method by creating or updating the JSON configuration files that Chrome uses to detect extensions. The difference lies in the file location: this method writes the configuration files to a system-wide location, whereas the Current User method writes them to a user-specific location.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the All Users install type.

   

6. Selecciona Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

8. Selecciona Habilitar extensión en la ventana emergente de confirmación de Google Chrome.

   

Resultado: la extensión está instalada y habilitada.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.

1. Abra una Terminal y ejecute el siguiente comando:

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome --scope=machine
   

2. Selecciona Habilitar extensión en la ventana emergente de confirmación de Google Chrome.

   

Resultado: la extensión está instalada y habilitada.

Nota:

• sudo es necesario para ejecutar este comando, ya que actualiza los archivos de configuración del sistema.
• Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

Póliza de grupo en línea

Este método no requiere el paso manual para habilitar la extensión después de que Chrome se haya iniciado por primero vez. Esto se debe a que depende de los perfiles de configuración implementados por las herramientas de gestión de dispositivos móviles (MDM).

El perfil de configuración establece la política de ExtensionInstallForcelist. Esta política garantiza que la extensión esté habilitada y que no se pueda deshabilitar manualmente.

Este procedimiento es similar al método de instalación de la Política de grupo en línea de Windows que se describe aquí: Studio: extensión para Chrome.

Requisitos de MDM

Para instalar un perfil de configuración (un archivo .mobileconfig), la máquina debe tener una aplicación de MDM y esta debe estar inscrita para gestionarla.

Ejemplos de MDM incluyen:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (código abierto)

Si el dispositivo está registrado en una solución MDM, asegúrate de que la configuración no se vea anulada por las actualizaciones de configuración enviadas a través de MDM. Para evitar esto, implementa el perfil de configuración directamente a través de MDM. El perfil debe contener configuraciones similares a las del ejemplo siguiente:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PayloadContent</key>
	<array>
		<dict>
			<!-- This policy ensures that the {extensionId} is enabled -->
			<key>ExtensionInstallForcelist</key>
			<array>
				<string>{extensionId};https://clients2.google.com/service/update2/crx</string>
			</array>
			<!-- These policies specifically enable the Developer mode for {extensionId} -->
			<key>DeveloperToolsAvailabilityAllowlist</key>
			<array>
				<string>chrome-extension://{extensionId}</string>
			</array>
			<key>DeveloperToolsAvailabilityBlocklist</key>
			<array>
				<string>https://uipath-devtools-blocklist-placeholder.invalid</string>
			</array>
			<!-- Alternatively, this policy globally enables the Developer mode in chrome://extensions.
			Can be used in place of DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
			depending on the already present configuration -->
			<key>BlockExternalExtensions</key>
			<false/>
			
			<key>ExtensionAllowedTypes</key>
			<array>
				<string>extension</string>
			</array>
			
			<key>NativeMessagingUserLevelHosts</key>
			<true/>
			
			<key>NativeMessagingAllowlist</key>
			<array>
				<string>com.uipath.portable_host</string>
			</array>
			
			<key>PayloadDisplayName</key>
			<string>Google Chrome</string>
			<key>PayloadIdentifier</key>
			<string>com.google.Chrome.2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadType</key>
			<string>com.google.Chrome</string>
			<key>PayloadUUID</key>
			<string>2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadVersion</key>
			<integer>1</integer>
		</dict>
	</array>
	<key>PayloadDisplayName</key>
	<string>UiPath Studio Web Automation Chrome Extension Installation</string>
	<key>PayloadIdentifier</key>
	<string>com.uipath.chrome.extension.A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadOrganization</key>
	<string>com.uipath</string>
	<key>PayloadScope</key>
	<string>System</string>
	<key>PayloadType</key>
	<string>Configuration</string>
	<key>PayloadUUID</key>
	<string>A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadVersion</key>
	<integer>1</integer>
	<key>TargetDeviceType</key>
	<integer>5</integer>
</dict>
</plist>

If the device is not enrolled in an MDM solution, the required configuration files are written locally, without them being overridden by MDM-applied policies. This allows Chrome to apply the policy and ensures that the extension is enabled without requiring user interaction.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the By Policy install type.

   

6. Selecciona Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

Resultado: la extensión está instalada y habilitada.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.
• To install for the current user only instead of all users, replace --scope=machine with --scope=user in the command below; other users won't get the extension installed.

ADVERTENCIA:

If the machine is MDM-enrolled you need to make sure that the policies are not overwritten. See the MDM Requirements for more details.

1. Abra una Terminal y ejecute el siguiente comando:

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome bypolicy --scope=machine
   

Resultado: la extensión está instalada y habilitada.

Nota:

• sudo is needed to run this command, as it updates system configuration files, and the bypolicy option automatically sets the scope to machine.
• Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. See Studio - List of extensions for Chrome for available IDs.

Política de grupo sin conexión

Este procedimiento es similar al método de instalación sin conexión de la Política de grupo de Windows que se describe aquí: Studio: extensión para Chrome.

Este método se basa en los perfiles de configuración implementados por las herramientas de MDM (gestión de dispositivos móviles). El perfil de Configuración aplica la política ExtensionInstallForcelist , que garantiza que la extensión se habilite automáticamente y los usuarios no puedan deshabilitarla. También configura las políticas DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist para permitir específicamente el acceso a las herramientas de desarrollador a la extensión UiPath.

Este método:

• Te permite instalar cualquier extensión, ya sea publicada en la tienda web o no publicada.
• Es útil en entornos con acceso restringido a Internet (donde no se puede acceder a https://clients2.google.com/service/update2/crx).

ADVERTENCIA:

• This method only works on machines that are MDM enrolled. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the By Policy (Offline) install type.

   

6. Selecciona Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

Resultado: la extensión está instalada y habilitada.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.
• To install for the current user only instead of all users, add --scope=user to the command below; by default, the bypolicy option sets the scope to machine.

1. Abra una Terminal y ejecute el siguiente comando:

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome bypolicy --offline
   

2. Inicia Chrome.

3. Diseña y ejecuta automatizaciones.

Resultado: la extensión está instalada y habilitada.

Nota:

sudo is needed to run this command, as it updates system configuration files. Using the bypolicy option automatically sets the scope to machine.

Current User (Native Messaging Host only)

This method installs only the extension's Native Messaging Host component for the current user. It creates or updates the JSON configuration files used by Chrome to allow communication with a native host.

ADVERTENCIA:

The extension needs to be installed manually from the WebStore or via a MDM configuration. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the Current User (Native Messaging Host only) install type.

   

6. Selecciona Instalar.

Result: The extension's native messaging host component is installed.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.

1. Abra una Terminal y ejecute el siguiente comando:

   dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome native-messaging-host-only
   

Result: The extension's native messaging host component is installed.

Nota:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

All Users (Native Messaging Host only)

This method installs only the extension's Native Messaging Host component for all users. It creates or updates the JSON configuration files used by Chrome to allow communication with a native host.

ADVERTENCIA:

The extension needs to be installed manually from the WebStore or via a MDM configuration. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Use the dropdown for Google Chrome to select the All Users (Native Messaging Host only) install type.

   

6. Selecciona Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

Result: The extension's native messaging host component is installed.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the Terminal)

Prerrequisitos:

• Ejecuta siempre el comando utilizando el archivo UiPath.ExtensionControl.Portable.dll del directorio /Applications, ya que macOS es sensible a la hora de ejecutar binarios desde otras ubicaciones.
• Cierra todas las ventanas de Chrome antes de ejecutar el comando.

1. Abra una Terminal y ejecute el siguiente comando:

   dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome native-messaging-host-only --scope=machine
   

Result: The extension's native messaging host component is installed.

Nota:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

Desinstalar

Desinstalar desde UiPath Assistant

1. Acceder a UiPath Assistant.

2. Ve a Extensiones de UiPath.

3. Selecciona Desinstalar para Google Chrome.

   

Resultado: se desinstala la extensión.

Desinstalar desde Terminal

Puedes desinstalar la extensión de UiPath para Chrome, independientemente del método de instalación, ejecutando el siguiente comando:

dotnet UiPath.ExtensionControl.Portable.dll cleanup chrome

Resultado: se desinstala la extensión.

Comprobar estado

Para comprobar el estado de la extensión de Chrome, ejecuta el comando de terminal correspondiente en función de tu método de instalación:

• Usuario actual

  dotnet UiPath.ExtensionControl.Portable.dll status chrome
  

• Todos los usuarios

  dotnet UiPath.ExtensionControl.Portable.dll status chrome --scope=machine
  

• Póliza de grupo en línea

  dotnet UiPath.ExtensionControl.Portable.dll status chrome bypolicy --scope=machine
  

• Política de grupo sin conexión

  dotnet UiPath.ExtensionControl.Portable.dll status chrome bypolicy --offline --scope=machine
  

• Current User (Native Messaging Host only)

  dotnet UiPath.ExtensionControl.Portable.dll status chrome native-messaging-host-only
  

• All Users (Native Messaging Host only)

  dotnet UiPath.ExtensionControl.Portable.dll status chrome native-messaging-host-only --scope=machine