Extension Chrome sur Mac

Installez l’extension UiPath pour Chrome sur Mac afin d’automatiser le navigateur, avec des options d’installation au niveau de l’utilisateur ou à l’échelle de la machine.

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

Installer

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

• Utilisateur actuel
• Tous les utilisateurs (All Users)
• Stratégie de groupe en ligne
• Stratégie de groupe hors ligne
• 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:

Type d'installation	Extension version
Utilisateur actuel	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Tous les utilisateurs (All Users)	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Stratégie de groupe en ligne	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Stratégie de groupe hors ligne	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

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.

A. Install Steps using UiPath Assistant

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. Use the dropdown for Google Chrome to select the Current User install type.

   

6. Sélectionnez Installer (Install).

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

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

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.

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.

Remarque :

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.

Tous les utilisateurs (All Users)

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. 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. Use the dropdown for Google Chrome to select the All Users install type.

   

6. Sélectionnez Installer (Install).

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

   

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

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

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.

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.

Remarque :

• sudo est nécessaire pour exécuter cette commande, car il met à jour les fichiers de configuration système.
• 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.

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.

Exigences du gestionnaire d'appareils mobiles

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>
			<!-- 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. 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. Use the dropdown for Google Chrome to select the By Policy install type.

   

6. Sélectionnez Installer (Install).

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

   

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

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

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

Avertissement :

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

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

Remarque :

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

Stratégie de groupe hors ligne

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.

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. Il configure également les politiques DeveloperToolsAvailabilityAllowlist / DevelopmentToolsAvailability Blocklist pour autoriser spécifiquement les outils de développement à accéder à l'extension UiPath.

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

Avertissement :

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

A. Install Steps using UiPath Assistant

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. Use the dropdown for Google Chrome to select the By Policy (Offline) install type.

   

6. Sélectionnez Installer (Install).

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

   

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

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

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.
• 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. Ouvrez un terminal et exécutez la commande suivante :

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

2. Démarrez Chrome.

3. Concevez et exécutez des automatisations.

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

Remarque :

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.

Avertissement :

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. 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. Use the dropdown for Google Chrome to select the Current User (Native Messaging Host only) install type.

   

6. Sélectionnez Installer (Install).

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

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

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.

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

   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.

Remarque :

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.

Avertissement :

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. 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. Use the dropdown for Google Chrome to select the All Users (Native Messaging Host only) install type.

   

6. Sélectionnez Installer (Install).

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)

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.

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

   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.

Remarque :

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.

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