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 de UiPath para Chrome puede instalarse de varias maneras, dependiendo de la interacción permitida por el usuario.

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/ Reemplazar {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 con UiPath Assistant solo requiere unos pocos clics y no requiere ninguna 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 Web Store 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 el terminal (a través de UiPath.ExtensionControl.Portable.dll)

UiPath ofrece 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.

Requisitos previos

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

Nota:

• Añade la opción --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 de la máquina. Funciona de forma similar al método Usuario actual: crea o actualiza 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 del 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 opción --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 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.

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>

			<!-- 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á registrado en ninguna solución de MDM, la herramienta UiPath.ExtensionControl.Portable.dll escribe la configuración necesaria localmente, sin que las políticas aplicadas de MDM la anulen. Esto permite a Chrome aplicar la política y garantiza que la extensión se habilite sin necesidad de 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 opción bypolicy establece automáticamente el ámbito en máquina.
• El comando se puede emitir 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 opción --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 se puede eliminar si la configuración enviada a través de MDM se establece 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 requeridas. El archivo .mobileconfig debería tener aproximadamente el contenido descrito anteriormente.

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

4. Inicia Chrome.

5. Diseña y ejecuta 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ña y ejecuta 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 (en la máquina local o desde una máquina de administrador).

UiPath.ExtensionControl.Portable.dll proporciona ayuda para actualizar los archivos de configuración que la extensión necesita para comunicarse con el host nativo. Por lo tanto, puede utilizarse para instalar la extensión por usuario o por máquina, como se muestra anteriormente, pero es necesario realizar pasos adicionales para garantizar que la extensión se instale y se encuentre habilitada.

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

• Reemplaza {extensionId} por el ID de la extensión.
• El {crxUrl} debe reemplazarse por la URL del CRX (https:// si el CRX está alojado en un servidor, o file:// si el archivo se coloca en la máquina local).
• El {extensionVersion} debe reemplazarse por la versión de la extensión (algo parecido a 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 describe anteriormente.

2. Envía el perfil mediante un proveedor de MDM.

3. Instala el host nativo de mensajería 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ña y ejecuta automatizaciones.

Resultado

La extensión está instalada y habilitada.

Este método depende de los perfiles de configuración implementados por las herramientas de gestión de dispositivos móviles (MDM). El perfil de configuración aplica la política ExtensionInstallForcelist, que garantiza que la extensión se habilite automáticamente y que 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 que se describe 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 ya está desinstalada.

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 ya está desinstalada.

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 native-messaging-host-only --scope=machine