Chrome-Erweiterung für Mac

Diese Erweiterung hilft Ihnen, Browser-Automatisierungen in Google Chrome auf Mac zu erstellen.

Installationsmethoden

Die UiPath-Erweiterung für Chrome kann auf verschiedene Arten installiert werden, je nachdem, wie viel Benutzerinteraktion zulässig ist.

Erweiterungen können entweder für einen bestimmten Benutzer oder pro Gerät (für alle Benutzer) installiert werden. Der einzige Unterschied zwischen diesen beiden Installationstypen ist der Speicherort der Konfigurationsdateien.

Installationstyp	Speicherorte von Konfigurationsdateien
Pro Benutzer	~{userId}/Library/Application Support/Google/Chrome/External Extensions/ ~{userId}/Library/Application Support/Google/Chrome/NativeMessagingHosts/ Ersetzen Sie {userId} durch den Benutzernamen des Benutzers.
Pro Maschine	/Library/Application Support/Google/Chrome/External Extensions/ /Library/Google/Chrome/NativeMessagingHosts/

Installieren über UiPath Assistant

Die Installation mit UiPath Assistant erfordert nur wenige Klicks und keine zusätzliche Konfiguration, wenn UiPath Assistant bereits installiert ist. Diese Methode installiert die neueste im Webshop veröffentlichte Version der Erweiterung nur für den aktuellen Benutzer.

1. Greifen Sie auf UiPath Assistant zu.

2. Wählen Sie das Kontosymbol aus.

3. Wählen Sie Einstellungen aus.

4. Wechseln Sie zu UiPath-Erweiterungen.

5. Wählen Sie Installieren für Google Chrome.

   

6. Wählen Sie im Google Chrome-Bestätigungs-Popup die Option Erweiterung aktivieren aus.

   

Ergebnis

Die Erweiterung ist installiert und aktiviert.

Über Terminal installieren (über UiPath.ExtensionControl.Portable.dll)

UiPath bietet ein Tool zur Verwaltung von Installationen von Erweiterungen: UiPath.ExtensionControl.Portable.dll.Dieses Tool wird mit UiPath Assistant verteilt, zusammen mit den zusätzlichen Dateien, die für die Ausführung der Erweiterung erforderlich sind.

Voraussetzungen

• Führen Sie den Befehl immer mit der UiPath.ExtensionControl.Portable.dll Datei aus dem /Applications Verzeichnis aus, da macOS empfindlich ist, wenn es um die Ausführung von Binärdateien von anderen Speicherorten geht.
• Schließen Sie alle Chrome-Fenster, bevor Sie den Befehl ausführen.

Sie können eine der folgenden Installationsmethoden verwenden:

• Aktueller Benutzer
• Alle Benutzer
• Gruppenrichtlinie online
• Gruppenrichtlinie offline

Aktueller Benutzer

Diese Methode installiert die Erweiterung nur für den aktuellen Benutzer. Sie erstellt oder aktualisiert die JSON-Konfigurationsdateien, die von Chrome zur Erkennung von Erweiterungen verwendet werden. Diese Dateien definieren die Erweiterungs-ID, die Update-URL und den Pfad zum Native Messaging-Host.

Hinweis:

• Fügen Sie die --ext-id={extensionId} Option hinzu, um eine bestimmte Erweiterungsversion als Ziel zu wählen. Ersetzen Sie {extensionId} durch die ID der gewünschten Erweiterung. Eine Liste der verfügbaren IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.
• Der Teil --ext-id={extensionId} des Befehls ist optional.Wenn diese Option weggelassen wird, wird die neueste Version der im Web Store veröffentlichten Erweiterung installiert.

Installationsschritte

1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

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

2. Wählen Sie im Google Chrome-Bestätigungs-Popup die Option Erweiterung aktivieren aus.

   

Ergebnis

Die Erweiterung ist installiert und aktiviert.

Alle Benutzer

Diese Methode installiert die Erweiterung für alle Benutzer auf dem Gerät.Sie funktioniert ähnlich wie die Methode Aktueller Benutzer, indem die JSON-Konfigurationsdateien erstellt oder aktualisiert werden, die Chrome zur Erkennung von Erweiterungen verwendet.Der Unterschied liegt im Dateispeicherort: Diese Methode schreibt die Konfigurationsdateien an einen systemweiten Speicherort, während die Methode Aktueller Benutzer sie an einen benutzerspezifischen Speicherort schreibt.

Hinweis:

• sudo ist zum Ausführen dieses Befehls erforderlich, da es Systemkonfigurationsdateien aktualisiert.
• Fügen Sie die --ext-id={extensionId} Option hinzu, um eine bestimmte Erweiterungsversion als Ziel zu wählen. Ersetzen Sie {extensionId} durch die ID der gewünschten Erweiterung. Eine Liste der verfügbaren IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.
• Der Teil --ext-id={extensionId} des Befehls ist optional.Wenn diese Option weggelassen wird, wird die neueste Version der im Web Store veröffentlichten Erweiterung installiert.

Installationsschritte

1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

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

2. Wählen Sie im Google Chrome-Bestätigungs-Popup die Option Erweiterung aktivieren aus.

   

Ergebnis

Die Erweiterung ist installiert und aktiviert.

Gruppenrichtlinie online

Diese Methode erfordert den manuellen Schritt zum Aktivieren der Erweiterung nach dem ersten Start von Chrome nicht. Das liegt daran, dass sie auf Konfigurationsprofilen basiert, die von MDM-Tools (Mobile Device Management) eingesetzt werden.

Das Konfigurationsprofil legt die Richtlinie ExtensionInstallForcelist fest. Diese Richtlinie stellt sicher, dass die Erweiterung aktiviert ist und nicht manuell deaktiviert werden kann.

Dieses Verfahren ähnelt der hier beschriebenen Installationsmethode von Windows-Gruppenrichtlinie Online: Studio – Erweiterung für Chrome.

Um ein Konfigurationsprofil (eine .mobileconfig Datei) zu installieren, muss eine MDM-Anwendung auf dem Gerät vorhanden sein, und das Gerät muss registriert werden, um verwaltet zu werden.

Beispiele für MDMs sind:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (Open-Source)

Wenn das Gerät in einer MDM-Lösung angemeldet ist, stellen Sie sicher, dass die Konfiguration nicht durch die über MDM gepushten Konfigurations-Updates überschrieben wird. Um dies zu verhindern, stellen Sie das Konfigurationsprofil direkt über MDM bereit.Das Profil sollte Einstellungen enthalten, die denen des folgenden Beispiels ähneln:

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

Wenn das Gerät nicht in einer MDM-Lösung angemeldet ist, schreibt das UiPath.ExtensionControl.Portable.dll Tool die erforderliche Konfiguration lokal, ohne dass es durch angewendete MDM-Richtlinien überschrieben wird. Dies ermöglicht es Chrome, die Richtlinie anzuwenden und stellt sicher, dass die Erweiterung aktiviert ist, ohne dass eine Benutzerinteraktion erforderlich ist.

Hinweis:

• sudo ist zum Ausführen dieses Befehls erforderlich, da es Systemkonfigurationsdateien aktualisiert.
• Mit der bypolicy Option wird der Geltungsbereich automatisch auf das Gerät festgelegt.
• Der Befehl kann mit --scope=user anstelle von --scope=machine ausgeführt werden, was zur Folge hat, dass nur der aktuelle Benutzer die Erweiterung installiert und automatisch aktiviert bekommt.Bei allen anderen Benutzern wird die Erweiterung nicht installiert.
• Fügen Sie die --ext-id={extensionId} Option hinzu, um eine bestimmte Erweiterungsversion als Ziel zu wählen. Ersetzen Sie {extensionId} durch die ID der gewünschten Erweiterung. Eine Liste der verfügbaren IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.
• Der Teil --ext-id={extensionId} des Befehls ist optional.Wenn diese Option weggelassen wird, wird die neueste Version der im Web Store veröffentlichten Erweiterung installiert.

Installationsschritte

A. Bei MDM registrierte Maschine

1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:Das bypolicy Argument kann entfernt werden, wenn die über MDM gepushte Konfiguration so eingestellt ist, dass vorhandene Werte überschrieben werden.

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

2. Erstellen Sie eine neue .mobileconfig Datei, um die erforderlichen Richtlinien zu konfigurieren. Die .mobileconfig Datei sollte in etwa den oben beschriebenen Inhalt haben.

3. Installieren Sie das Konfigurationsprofil mit dem MDM-Anbieter.

4. Starten Sie Chrome.

5. Automatisierungen entwerfen und ausführen.

Ergebnis

Die Erweiterung ist installiert und aktiviert.

B. Keine bei MDM registrierte Maschine

1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

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

2. Automatisierungen entwerfen und ausführen.

Ergebnis

Die Erweiterung ist installiert und aktiviert.

Gruppenrichtlinie offline

UiPath.ExtensionControl.Portable.dll kann nicht verwendet werden, um diesen Installationstyp vollständig auszuführen, da ein Eingriff erforderlich ist (entweder auf dem lokalen Gerät oder von einem Administrator-Gerät aus).

UiPath.ExtensionControl.Portable.dll bietet Unterstützung für die Aktualisierung der Konfigurationsdateien, die die Erweiterung für ihre Kommunikation mit dem Native-Host benötigt.Daher kann sie wie zuvor gezeigt verwendet werden, um die Erweiterung pro Benutzer oder pro Gerät zu installieren, es sind jedoch zusätzliche Schritte erforderlich, um sicherzustellen, dass die Erweiterung installiert und aktiviert wird.

Das Konfigurationsprofil legt die Richtlinie ExtensionInstallForcelist fest. Diese Richtlinie stellt sicher, dass die Erweiterung aktiviert ist und nicht manuell deaktiviert werden kann.

Diese Methode:

• Ermöglicht Ihnen die Installation beliebiger Erweiterungen, unabhängig davon, ob sie im Webshop veröffentlicht sind oder nicht veröffentlicht.
• Ist nützlich in Umgebungen mit eingeschränktem Internetzugang (wo kein Zugriff auf https://clients2.google.com/service/update2/crx möglich ist).

Das Konfigurationsprofil sollte ungefähr den folgenden Inhalt haben:

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

Die ExtensionInstallForcelist Zeichenfolge hat die folgenden Formate:

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

Der {urlWithThePathToTheUpdateManifestXmlFile} Wert muss durch eine URL (https:// oder file://) für die XML-Manifest-Aktualisierungsdatei ersetzt werden. Diese Datei hat den folgenden Inhalt:

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

Hinweis:

• Ersetzen Sie {extensionId} durch die ID der Erweiterung.
• {crxUrl} muss durch die URL des CRX ersetzt werden (https:// – wenn der CRX auf einem Server gehostet wird, oder file:// – wenn die Datei auf dem lokalen Gerät platziert wird).
• {extensionVersion} muss durch die Version der Erweiterung ersetzt werden (etwa 24.10.3).

Installationsschritte

Hinweis:

Die Schritte 1 und 2 werden auf dem Administratorgerät ausgeführt.

1. Erstellen Sie das Konfigurationsprofil wie oben beschrieben.

2. Übertragen Sie das Profil mit einem MDM-Anbieter.

3. Installieren Sie den Native Messaging-Host, indem Sie ein Terminal öffnen und den folgenden Befehl ausführen:

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

4. Starten Sie Chrome.

5. Automatisierungen entwerfen und ausführen.

Ergebnis

Die Erweiterung ist installiert und aktiviert.

Diese Methode basiert auf Konfigurationsprofilen, die von MDM-Tools (Mobile Device Management) bereitgestellt werden. Das Konfigurationsprofil wendet die Richtlinie ExtensionInstallForcelist an, was sicherstellt, dass die Erweiterung automatisch aktiviert wird und von Benutzern nicht deaktiviert werden kann.

Dieses Verfahren ähnelt der hier beschriebenen Installationsmethode von Windows-Gruppenrichtlinie Offline Studio – Erweiterung für Chrome.

Deinstallieren

Deinstallieren über UiPath Assistant

1. Greifen Sie auf UiPath Assistant zu.

2. Wechseln Sie zu UiPath-Erweiterungen.

3. Wählen Sie Deinstallieren für Google Chrome.

   

Ergebnis

Die Erweiterung wird deinstalliert.

Deinstallieren über das Terminal

Sie können die UiPath-Erweiterung für Chrome ungeachtet der Installationsmethode deinstallieren, indem Sie den folgenden Befehl ausführen:

dotnet UiPath.ExtensionControl.Portable.dll cleanup chrome

Ergebnis

Die Erweiterung wird deinstalliert.

Überprüfen des Status

Um den Status der Chrome-Erweiterung zu prüfen, führen Sie den entsprechenden Terminal-Befehl basierend auf Ihrer Installationsmethode aus:

• Aktueller Benutzer

  dotnet UiPath.ExtensionControl.Portable.dll status chrome
  

• Alle Benutzer

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

• Gruppenrichtlinie online

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

• Gruppenrichtlinie offline

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