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 niveau d'interaction utilisateur autorisé.

Les extensions peuvent être installées soit pour un utilisateur spécifique, soit 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'UiPath Assistant ne nécessite que quelques clics, sans configuration supplémentaire, tant qu'UiPath Assistant est déjà installé. Cette méthode installe la dernière version de l'extension publiée sur le Web Store pour l'utilisateur actuel uniquement.

1. Accédez à l'Assistant UiPath.

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

3. Sélectionnez Préférences.

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

5. Sélectionnez Installer pour Google Chrome.

   

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

   

Résultat

L’extension est installée et activée.

Installer à partir du 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 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 d'accès à 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 une liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si omise, la dernière version de l'extension publiée sur le 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 Activer l'extension dans la fenêtre contextuelle de confirmation de 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 de la machine. Elle fonctionne de manière similaire à la méthode Utilisateur actuel en créant ou en mettant à jour les fichiers de configuration JSON que Chrome utilise pour détecter les extensions. La différence réside dans l'emplacement du fichier : cette méthode écrit les fichiers de configuration dans un emplacement à l'échelle 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 une liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si omise, la dernière version de l'extension publiée sur le 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 Activer l'extension dans la fenêtre contextuelle de confirmation de 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 s'appuie sur des profils de configuration déployés par des outils MDM (Gestion des appareils mobiles).

Le profil de configuration définit la politique ExtensionInstallForcelist. Cette politique 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 en ligne de la politique de groupe Windows 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 inscrite pour être gérée.

Des exemples de MDM incluent :

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

Si l'appareil est inscrit dans une solution MDM, assurez-vous que la configuration n'est pas remplacée par les mises à jour de configuration transmises via MDM. 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 MDM appliquées. Cela permet à Chrome d'appliquer la politique 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 la machine.
• La commande peut être émise avec --scope=user au lieu de --scope=machine, avec pour effet que seul l'utilisateur actuel obtient l'extension installée et automatiquement activée. Tout autre utilisateur ne fera pas installer l'extension.
• 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 une liste des ID disponibles, consultez Studio - Liste des extensions pour Chrome.
• La partie --ext-id={extensionId} de la commande est facultative. Si omise, la dernière version de l'extension publiée sur le 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 MDM 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 politiques requises. Le fichier .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. Concevez et exécutez 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. Concevez et exécutez 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 Administrator).

UiPath.ExtensionControl.Portable.dll fournit une prise en charge de 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 précédemment montré, mais des étapes supplémentaires sont nécessaires pour s'assurer que l'extension est installée et activée.

Le profil de configuration définit la politique ExtensionInstallForcelist. Cette politique 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 sur WebStore ou non publiée.
• Est utile dans les environnements avec un accès Internet restreint (où https://clients2.google.com/service/update2/crx ne peut pas être consulté).

Le profil de configuration doit contenir à peu près les contenus suivants :

<?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 string ExtensionInstallForcelist a les formats suivants :

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

La valeur {urlWithThePathToTheUpdateManifestXmlFile} doit être remplacée par une URL (https:// ou file://) vers le fichier XML du manifeste de 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 CRX (https:// - si le CRX est hébergé sur un serveur ou file:// - si le fichier est placé sur la machine locale).
• Le {extensionVersion} doit être remplacé par la version de l'extension (quelque chose comme 24.10.3).

Étapes d'installation

Remarque :

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

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

2. Envoyez 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. Concevez et exécutez 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 politique ExtensionInstallForcelist, 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 hors ligne de la politique de groupe Windows 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