Extension Chrome sur Mac

Cette extension vous aide à créer des automatisations de navigation dans Google Chrome sur Mac.

Méthodes d'installation

L' extension UiPath pour Chrome peut être installée de plusieurs manières, en fonction du nombre d'interactions utilisateur autorisées.

Les extensions peuvent être installées pour un utilisateur spécifique ou par machine (pour tous les utilisateurs). La seule différence entre ces deux types d'installation est l'emplacement des fichiers de configuration.

Type d’installation	Emplacements des fichiers de configuration
Par utilisateur	~{userId}/Library/Application Support/Google/Chrome/External Extensions/ ~{userId}/Library/Application Support/Google/Chrome/NativeMessagingHosts/ Remplacez {userId} par le nom d'utilisateur de l'utilisateur.
Par machine	/Library/Application Support/Google/Chrome/External Extensions/ /Library/Google/Chrome/NativeMessagingHosts/

Installer à partir de l'Assistant UiPath

L'installation à l'aide de l'Assistant UiPath ne nécessite que quelques clics, sans configuration supplémentaire, tant que l'Assistant UiPath est déjà installé. Cette méthode installe la dernière version de l’extension publiée sur Web Store pour l’ utilisateur actuel uniquement.

1. Accédez à l'Assistant UiPath.

2. Sélectionnez l'icône du compte.

3. Sélectionnez Preferences (Préférences).

4. Accédez à Extensions UiPath (UiPath Extensions).

5. Sélectionnez Installer pour Google Chrome.

   

6. Sélectionnez l' option Activer l'extension dans la fenêtre de confirmation du navigateur Google Chrome.

   

Résultat: l'extension est installée et activée.

Installer depuis un terminal (via UiPath.ExtensionControl.Portable.dll)

UiPath fournit un outil pour gérer l’installation de l’extension: UiPath.ExtensionControl.Portable.dll. Cet outil est distribué avec UiPath Assistant, ainsi que les fichiers supplémentaires requis pour exécuter l’extension.

Prérequis :

• Exécutez toujours la commande à l'aide du fichier UiPath.ExtensionControl.Portable.dll du répertoire /Applications , car macOS est sensible lorsqu'il s'agit d'exécuter des fichiers binaires à partir d'autres emplacements.
• Fermez toutes les fenêtres Chrome avant d’exécuter la commande.

Vous pouvez utiliser l'une des méthodes d'installation suivantes:

• Utilisateur actuel
• Tous les utilisateurs (All Users)
• Stratégie de groupe en ligne
• Stratégie de groupe hors ligne

Utilisateur actuel

Cette méthode installe l’extension uniquement pour l’utilisateur actuel. Il crée ou met à jour les fichiers de configuration JSON utilisés par Chrome pour détecter les extensions. Ces fichiers définissent l'ID d'extension, l'URL de mise à jour et le chemin vers l'hôte de messagerie natif.

Remarque :

• Ajoutez l’option --ext-id={extensionId} pour cibler une version d’extension spécifique. Remplacez {extensionId} par l'ID de l'extension souhaitée. Pour obtenir la liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si elle est omise, la dernière version de l'extension publiée dans Web Store est installée.

Étapes d’installation

1. Ouvrez un terminal et exécutez la commande suivante :

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

2. Sélectionnez l' option Activer l'extension dans la fenêtre de confirmation du navigateur Google Chrome.

   

Résultat: l'extension est installée et activée.

Tous les utilisateurs (All Users)

Cette méthode installe l’extension pour tous les utilisateurs sur la machine. Elle fonctionne de la même manière que la méthode Utilisateur actuel en créant ou en mettant à jour les fichiers de configuration JSON qu’utilise Chrome pour détecter les extensions. La différence réside au niveau de l'emplacement des fichiers: cette méthode écrit les fichiers de configuration dans un emplacement au niveau du système, tandis que la méthode Utilisateur actuel les écrit dans un emplacement spécifique à l'utilisateur.

Remarque :

• sudo est nécessaire pour exécuter cette commande, car il met à jour les fichiers de configuration système.
• Ajoutez l’option --ext-id={extensionId} pour cibler une version d’extension spécifique. Remplacez {extensionId} par l'ID de l'extension souhaitée. Pour obtenir la liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si elle est omise, la dernière version de l'extension publiée dans Web Store est installée.

Étapes d’installation

1. Ouvrez un terminal et exécutez la commande suivante :

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

2. Sélectionnez l' option Activer l'extension dans la fenêtre de confirmation du navigateur Google Chrome.

   

Résultat: l'extension est installée et activée.

Stratégie de groupe en ligne

Cette méthode ne nécessite pas l’étape manuelle pour activer l’extension après le premier démarrage de Chrome. En effet, il repose sur des profils de configuration déployés par les outils MDM (Gestion des appareils mobiles).

Le profil de configuration définit la stratégie ListeInstallationsForcéesExtension . Cette stratégie garantit que l’extension est activée et qu’elle ne peut pas être désactivée manuellement.

Cette procédure est similaire à la méthode d’installation de stratégie de groupe Windows en ligne décrite ici: Studio - Extension pour Chrome.

Pour installer un profil de configuration (un fichier .mobileconfig ), une application MDM doit être présente sur la machine, et la machine doit être inscrit pour être géré.

Voici quelques exemples de MDM:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (open source)

Si l’appareil est inscrit dans une solution du gestionnaire d’appareils mobiles, assurez-vous que la configuration n’est pas remplacée par les mises à jour de configuration transmises via le gestionnaire d’appareils mobiles. Pour éviter cela, déployez le profil de configuration directement via MDM. Le profil doit contenir des paramètres similaires à l'exemple ci-dessous:

<?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 l'appareil n'est pas inscrit dans une solution MDM, l'outil UiPath.ExtensionControl.Portable.dll écrit la configuration requise localement sans qu'elle soit remplacée par les politiques appliquées par le MDM. Cela permet à Chrome d’appliquer la stratégie et garantit que l’extension est activée sans nécessiter d’interaction de l’utilisateur.

Remarque :

• sudo est nécessaire pour exécuter cette commande, car il met à jour les fichiers de configuration système.
• L’utilisation de l’option bypolicy définit automatiquement l’étendue sur machine.
• La commande peut être émise avec --scope=user au lieu de --scope=machine, avec l'effet que seul l'utilisateur actuel obtient l'extension installée et automatiquement activée. Tout autre utilisateur ne verra pas l'extension installée.
• Ajoutez l’option --ext-id={extensionId} pour cibler une version d’extension spécifique. Remplacez {extensionId} par l'ID de l'extension souhaitée. Pour obtenir la liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si elle est omise, la dernière version de l'extension publiée dans Web Store est installée.

Étapes d’installation

A. Machine enregistrée dans le gestionnaire d'appareils mobiles:

1. Ouvrez un terminal et exécutez la commande suivante. L'argument bypolicy peut être supprimé si la configuration transmise via le gestionnaire d'appareils mobiles est définie pour remplacer les valeurs existantes.

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

2. Créez un nouveau fichier .mobileconfig pour configurer les stratégies requises. Le .mobileconfig doit avoir à peu près le contenu décrit ci-dessus.

3. Installez le profil de configuration à l’aide du fournisseur MDM.

4. Démarrez Chrome.

5. Concevoir et exécuter des automatisations.

Résultat: l'extension est installée et activée.

B. Machine non enregistrée dans le gestionnaire d'appareils mobiles:

1. Ouvrez un terminal et exécutez la commande suivante :

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

2. Concevoir et exécuter des automatisations.

Résultat: l'extension est installée et activée.

Stratégie de groupe hors ligne

UiPath.ExtensionControl.Portable.dll ne peut pas être utilisé pour effectuer entièrement ce type d'installation, car il nécessite une intervention (soit sur la machine locale, soit à partir d'une machine administrateur).

UiPath.ExtensionControl.Portable.dll prend en charge la mise à jour des fichiers de configuration nécessaires à l'extension pour sa communication avec l'hôte natif. Par conséquent, il peut être utilisé pour installer l'extension par utilisateur ou par machine, comme indiqué précédemment, mais des étapes supplémentaires sont nécessaires pour garantir que l'extension est installée et activée.

Le profil de configuration définit la stratégie ListeInstallationsForcéesExtension . Cette stratégie garantit que l’extension est activée et qu’elle ne peut pas être désactivée manuellement.

Cette méthode:

• Vous permet d’installer n’importe quelle extension, qu’elle soit publiée dans WebStore ou non.
• Est utile dans les environnements avec accès Internet restreint (où https://clients2.google.com/service/update2/crx n'est pas accessible).

Le profil de configuration doit avoir à peu près le contenu suivant:

<?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 chaîne ListeInstallationsForcéesExtension a les formats suivants:

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

La valeur {urlWithThePathToTheUpdateManifestXmlFile} doit être remplacée par une URL (https:// ou file://) vers le fichier manifeste de la mise à jour. Ce fichier a le contenu suivant:

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

Remarque :

• Remplacez {extensionId} par l'ID de l'extension.
• Le {crxUrl} doit être remplacé par l'URL du CSX (https:// - si le CX est hébergé sur un serveur, ou file:// - si le fichier est placé sur la machine locale).
• La {extensionVersion} doit être remplacée par la version de l'extension (comme 24.10.3).

Étapes d’installation

Remarque :

Les étapes 1 et 2 sont effectuées sur la machine administrateur.

1. Créez le profil de configuration comme décrit ci-dessus.

2. Transmettez le profil à l'aide d'un fournisseur MDM.

3. Installez l'hôte de messagerie natif en ouvrant un terminal et en exécutant la commande suivante:

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

4. Démarrez Chrome.

5. Concevoir et exécuter des automatisations.

Résultat: l'extension est installée et activée.

Cette méthode s'appuie sur les profils de configuration déployés par les outils MDM (Gestion des appareils mobiles). Le profil de configuration applique la stratégie ListeInstallationsForcéesExtension , qui garantit que l'extension est automatiquement activée et ne peut pas être désactivée par les utilisateurs.

Cette procédure est similaire à la méthode d’installation de stratégie de groupe Windows Hors ligne décrite ici: Studio - Extension pour Chrome.

Désinstaller

Désinstaller depuis l'Assistant UiPath

1. Accédez à l'Assistant UiPath.

2. Accédez à Extensions UiPath (UiPath Extensions).

3. Sélectionnez Désinstaller pour Google Chrome.

   

Résultat: l'extension est désinstallée.

Désinstaller du terminal

Vous pouvez désinstaller l'extension UiPath pour Chrome, quelle que soit la méthode d'installation, en exécutant la commande suivante:

dotnet UiPath.ExtensionControl.Portable.dll cleanup chrome

Résultat: l'extension est désinstallée.

Vérifier le statut

Pour vérifier le statut de l’extension Chrome, exécutez la commande Terminal correspondante en fonction de votre méthode d’installation:

• Utilisateur actuel

  dotnet UiPath.ExtensionControl.Portable.dll status chrome
  

• Tous les utilisateurs (All Users)

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

• Stratégie de groupe en ligne

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

• Stratégie de groupe hors ligne

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