Extensión de Chrome en Mac

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

Métodos de instalación

La extensión UiPath para Chrome se puede instalar de varias maneras, dependiendo de cuánta interacción del usuario se permita.

Las extensiones se pueden instalar para un usuario específico o por máquina (para todos los usuarios). La única diferencia entre estos dos tipos de instalación es la ubicación de los archivos de configuración.

Tipo de instalación	Ubicaciones de los archivos de configuración
Por usuario	~{userId}/Library/Application Support/Google/Chrome/External Extensions/ ~{userId}/Library/Application Support/Google/Chrome/NativeMessagingHosts/ Sustituye {userId} por el nombre de usuario del usuario.
Por máquina	/Library/Application Support/Google/Chrome/External Extensions/ /Library/Google/Chrome/NativeMessagingHosts/

Instalar desde UiPath Assistant

La instalación utilizando UiPath Assistant requiere solo unos pocos clics, sin configuración adicional, siempre que UiPath Assistant ya esté instalado. Este método instala la última versión de la extensión publicada en la Tienda web solo para el usuario actual .

1. Acceder a UiPath Assistant.

2. Selecciona el icono de la cuenta.

3. Selecciona Preferencias.

4. Ve a Extensiones de UiPath.

5. Selecciona Instalar para Google Chrome.

   

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

   

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

Instalar desde terminal (a través de UiPath.ExtensionControl.Portable.dll)

UiPath proporciona una herramienta para gestionar la instalación de extensiones: UiPath.ExtensionControl.Portable.dll. Esta herramienta se distribuye con UiPath Assistant, junto con los archivos adicionales necesarios para ejecutar la extensión.

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.

Puedes utilizar uno de los siguientes métodos de instalación:

• Usuario actual
• Todos los usuarios
• Póliza de grupo en línea
• Política de grupo sin conexión

Usuario actual

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

Nota:

• Añade la --ext-id={extensionId} para apuntar a una versión de extensión específica. Reemplaza {extensionId} por el ID de la extensión deseada. Para obtener una lista de ID disponibles, consulta Studio: lista de extensiones para Chrome.
• La parte --ext-id={extensionId} del comando es opcional. Si se omite, se instala la última versión de la extensión publicada en la Web Store.

Pasos de instalación

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.

Todos los usuarios

Este método instala la extensión para todos los usuarios en la máquina. Funciona de forma similar al método Usuario actual creando o actualizando los archivos de configuración JSON que Chrome utiliza para detectar extensiones. La diferencia radica en la ubicación del archivo: este método escribe los archivos de configuración en una ubicación de todo el sistema, mientras que el método Usuario actual los escribe en una ubicación específica del usuario.

Nota:

• sudo es necesario para ejecutar este comando, ya que actualiza los archivos de configuración del sistema.
• Añade la --ext-id={extensionId} para apuntar a una versión de extensión específica. Reemplaza {extensionId} por el ID de la extensión deseada. Para obtener una lista de ID disponibles, consulta Studio: lista de extensiones para Chrome.
• La parte --ext-id={extensionId} del comando es opcional. Si se omite, se instala la última versión de la extensión publicada en la Web Store.

Pasos de instalación

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.

Póliza de grupo en línea

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

El perfil de Configuración establece la política 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 descrito aquí: Studio - Extensión para Chrome.

Para instalar un perfil de configuración (un archivo .mobileconfig ), debe haber una aplicación MDM en la máquina, y la máquina debe estar inscrita para ser gestionada.

Ejemplos de MDM incluyen:

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

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

<?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>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
         depending on the already present configuration -->
         <!-- This policy enables the Developer mode in chrome://extensions -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>
			
			<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>

Si el dispositivo no está inscrito en una solución MDM, la herramienta UiPath.ExtensionControl.Portable.dll escribe la configuración necesaria localmente, sin que sea anulada por las políticas aplicadas por MDM. Esto permite a Chrome aplicar la política y garantiza que la extensión esté habilitada sin requerir la interacción del usuario.

Nota:

• sudo es necesario para ejecutar este comando, ya que actualiza los archivos de configuración del sistema.
• El uso de la bypolicy establece automáticamente el ámbito en máquina.
• El comando puede emitirse con --scope=user en lugar de --scope=machine, con el efecto de que solo el usuario actual obtiene la extensión instalada y habilitada automáticamente. Cualquier otro usuario no tendrá instalada la extensión.
• Añade la --ext-id={extensionId} para apuntar a una versión de extensión específica. Reemplaza {extensionId} por el ID de la extensión deseada. Para obtener una lista de ID disponibles, consulta Studio: lista de extensiones para Chrome.
• La parte --ext-id={extensionId} del comando es opcional. Si se omite, se instala la última versión de la extensión publicada en la Web Store.

Pasos de instalación

A. Máquina inscrita en MDM:

1. Abre un terminal y ejecuta el siguiente comando. El argumento bypolicy puede eliminarse si la configuración enviada a través de MDM está establecida para anular los valores existentes.

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

2. Crea un nuevo archivo .mobileconfig para configurar las políticas necesarias. El archivo .mobileconfig debe tener aproximadamente el contenido descrito anteriormente.

3. Instala el perfil de configuración utilizando el proveedor de MDM.

4. Inicia Chrome.

5. Diseñar y ejecutar automatizaciones.

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

B Máquina no inscrita en MDM:

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
   

2. Diseñar y ejecutar automatizaciones.

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

Política de grupo sin conexión

UiPath.ExtensionControl.Portable.dll no se puede utilizar para realizar completamente este tipo de instalación, ya que requiere intervención (ya sea en la máquina local o desde una máquina de administrador).

UiPath.ExtensionControl.Portable.dll proporciona soporte para actualizar los archivos de configuración que necesita la extensión para su comunicación con el host nativo. Por lo tanto, se puede utilizar para instalar la extensión por usuario o por máquina, como se ha mostrado anteriormente, pero se requieren pasos adicionales para garantizar que la extensión esté instalada y habilitada.

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

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

El perfil de configuración debe tener aproximadamente el siguiente contenido:

<?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}</string>
			</array>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
         depending on the already present configuration -->
			<!-- This policy enables the Developer mode in chrome://extensions -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>
			
			<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>

La cadena ExtensionInstallForcelist tiene los siguientes formatos:

• {extensionId}
• {extensionId};{urlWithThePathToTheUpdateManifestXmlFile}

El valor {urlWithThePathToTheUpdateManifestXmlFile} debe reemplazarse por una URL (https:// o file://) al archivo XML del manifiesto de actualización. Este archivo tiene el siguiente contenido:

<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
	<app appid='{extensionId}'>
	<updatecheck
		codebase='{crxUrl}'
		version='{extensionVersion}' />
	</app>
</gupdate>

Nota:

• Sustituye {extensionId} por el ID de la extensión.
• El {crxUrl} debe reemplazarse por la URL de la CRX (https:// : si la CRX está alojada en un servidor, o file:// : si el archivo está ubicado en la máquina local).
• El {extensionVersion} debe reemplazarse por la versión de la extensión (algo así como 24.10.3).

Pasos de instalación

Nota:

Los pasos 1 y 2 se realizan en la máquina del administrador.

1. Crea el perfil de Configuración como se ha descrito anteriormente.

2. Inserta el perfil utilizando un proveedor de MDM.

3. Instala el host de mensajería nativo abriendo un terminal y ejecutando el siguiente comando:

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

4. Inicia Chrome.

5. Diseñar y ejecutar automatizaciones.

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

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.

Este procedimiento es similar al método de instalación sin conexión de la Política de grupo de Windows descrito aquí: Studio - Extensión para Chrome.

Desinstalar

Desinstalar desde UiPath Assistant

1. Acceder a UiPath Assistant.

2. Ve a Extensiones de UiPath.

3. Selecciona Desinstalar para Google Chrome.

   

Resultado: la extensión se desinstala.

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: la extensión se desinstala.

Comprobar estado

Para comprobar el estado de la extensión de Chrome, ejecuta el comando 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 native-messaging-host-only --scope=machine