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

Vous pouvez installer l'extension Chrome à l'aide de l'une des méthodes suivantes:

• Utilisateur actuel
• Tous les utilisateurs (All Users)
• Stratégie de groupe en ligne
• Stratégie de groupe hors ligne
• Utilisateur actuel (Hôte de messagerie natif uniquement)
• Tous les utilisateurs (hôte de messagerie natif uniquement)

Les installations peuvent être effectuées à l’aide de l’Assistant UiPath ou à partir du terminal (en invoquant UiPath.ExtensionControl.Portable.dll).

UiPath Assistant et UiPath.ExtensionControl.Portable.dll installent la dernière version de l’extension, comme suit:

Type d'installation	Version de l’extension
Utilisateur actuel	Dernière extension UiPath pour Studio Web publiée sur le Chrome WebStore.
Tous les utilisateurs (All Users)	Dernière extension UiPath pour Studio Web publiée sur le Chrome WebStore.
Stratégie de groupe en ligne	Dernière extension UiPath pour Studio Web publiée sur le Chrome WebStore.
Stratégie de groupe hors ligne	Dernière extension auto-hébergée fournie avec UiPath Assistant.
Utilisateur actuel (Hôte de messagerie natif uniquement)	Dernière extension UiPath pour Studio Web publiée sur le Chrome WebStore.
Tous les utilisateurs (hôte de messagerie natif uniquement)	Dernière extension UiPath pour Studio Web publiée sur le Chrome WebStore.

Vous pouvez également utiliser UiPath.ExtensionControl.Portable.dll pour installer une version spécifique de l'extension du navigateur. Exécutez-la avec la commande help pour plus de détails:

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. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Utilisateur actuel .

   

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. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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 :

Ajoutez l'option --ext-id={extensionId} pour cibler une version d'extension spécifique; si elle est omise, la dernière version publiée dans Web Store est installée. Pour connaître les identifiants disponibles, consultez Studio - Liste des extensions pour Chrome.

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.

A. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Tous les utilisateurs .

   

6. Sélectionnez Installer (Install).

7. Saisissez le mot de passe de l'administrateur dans la fenêtre de confirmation de l'Assistant UiPath .

   

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. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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.
• Ajoutez l'option --ext-id={extensionId} pour cibler une version d'extension spécifique; si elle est omise, la dernière version publiée dans Web Store est installée. Pour connaître les identifiants disponibles, consultez Studio - Liste des extensions pour 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>

Si l’appareil n’est pas inscrit dans une solution de gestionnaire d’appareils mobiles, les fichiers de configuration requis sont écrits localement sans être remplacés par les politiques appliquées dans le gestionnaire d’appareils mobiles. Cela permet à Chrome d’appliquer la stratégie et garantit que l’extension est activée sans nécessiter d’interaction de l’utilisateur.

A. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Par stratégie .

   

6. Sélectionnez Installer (Install).

7. Saisissez le mot de passe de l'administrateur dans la fenêtre de confirmation de l'Assistant UiPath .

   

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

B. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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.
• Pour installer pour l'utilisateur actuel uniquement plutôt que pour tous les utilisateurs, remplacez --scope=machine par --scope=user dans la commande ci-dessous; l'extension ne sera pas installée pour les autres utilisateurs.

Avertissement :

Si la machine est enregistrée dans le gestionnaire d'appareils mobiles, vous devez vous assurer que les politiques ne sont pas écrasées. Pour plus de détails, consultez les Exigences du 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
   

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, et l'option bypolicy définit automatiquement l'étendue sur machine.
• Ajoutez l'option --ext-id={extensionId} pour cibler une version d'extension spécifique; si elle est omise, la dernière version publiée dans Web Store est installée. Pour obtenir les ID disponibles, consultez la section Studio - Liste des extensions pour Chrome .

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 :

• Cette méthode ne fonctionne que sur les machines inscrites dans le gestionnaire d'appareils mobiles. Pour plus de détails, consultez les Exigences du gestionnaire d'appareils mobiles .

A. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Par stratégie (hors ligne) .

   

6. Sélectionnez Installer (Install).

7. Saisissez le mot de passe de l'administrateur dans la fenêtre de confirmation de l'Assistant UiPath .

   

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

B. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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.
• Pour installer pour l'utilisateur actuel uniquement au lieu de tous les utilisateurs, ajoutez --scope=user à la commande ci-dessous; par défaut, l'option bypolicy définit l'étendue sur 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 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.

Utilisateur actuel (Hôte de messagerie natif uniquement)

Cette méthode installe uniquement le composant Hôte de messagerie natif de l'extension pour l'utilisateur actuel. Il crée ou met à jour les fichiers de configuration JSON utilisés par Chrome pour permettre la communication avec un hôte natif.

Avertissement :

L’ extension doit être installée manuellement depuis WebStore ou via une configuration MDM. Pour plus de détails, consultez les Exigences du gestionnaire d'appareils mobiles .

A. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Utilisateur actuel (Hôte de messagerie natif uniquement) .

   

6. Sélectionnez Installer (Install).

Résultat: le composant hôte de messagerie natif de l'extension est installé.

B. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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
   

Résultat: le composant hôte de messagerie natif de l'extension est installé.

Remarque :

Ajoutez l'option --ext-id={extensionId} pour cibler une version d'extension spécifique; si elle est omise, la dernière version publiée dans Web Store est installée. Pour connaître les identifiants disponibles, consultez Studio - Liste des extensions pour Chrome.

Tous les utilisateurs (hôte de messagerie natif uniquement)

Cette méthode installe uniquement le composant Hôte de messagerie natif de l'extension pour tous les utilisateurs. Il crée ou met à jour les fichiers de configuration JSON utilisés par Chrome pour permettre la communication avec un hôte natif.

Avertissement :

L’ extension doit être installée manuellement depuis WebStore ou via une configuration MDM. Pour plus de détails, consultez les Exigences du gestionnaire d'appareils mobiles .

A. Étapes d'installation à l'aide de l'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. Utilisez la liste déroulante de Google Chrome pour sélectionner le type d'installation Tous les utilisateurs (hôte de messagerie natif uniquement) .

   

6. Sélectionnez Installer (Install).

7. Saisissez le mot de passe de l'administrateur dans la fenêtre de confirmation de l'Assistant UiPath .

   

Résultat: le composant hôte de messagerie natif de l'extension est installé.

B. Installez les étapes à l'aide de UiPath.ExtensionControl.Portable.dll (depuis le 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
   

Résultat: le composant hôte de messagerie natif de l'extension est installé.

Remarque :

Ajoutez l'option --ext-id={extensionId} pour cibler une version d'extension spécifique; si elle est omise, la dernière version publiée dans Web Store est installée. Pour connaître les identifiants disponibles, consultez Studio - Liste des extensions 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 bypolicy --offline --scope=machine
  

• Utilisateur actuel (Hôte de messagerie natif uniquement)

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

• Tous les utilisateurs (hôte de messagerie natif uniquement)

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