Chrome-Erweiterung für Mac

Installieren Sie die UiPath-Erweiterung für Chrome auf Mac für die Browser-Automatisierung mit Optionen für eine Installation auf Benutzerebene oder für eine Maschine.

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

Installieren

Sie können die Chrome-Erweiterung mit einer der folgenden Methoden installieren:

• Aktueller Benutzer
• Alle Benutzer
• Gruppenrichtlinie online
• Gruppenrichtlinie offline
• Aktueller Benutzer (nur Native Messaging-Host)
• Alle Benutzer (nur Native Messaging-Host)

Installationen können mit UiPath Assistant oder über Terminal (Aufruf von UiPath.ExtensionControl.Portable.dll) durchgeführt werden.

UiPath Assistant und UiPath.ExtensionControl.Portable.dll installieren die neueste Erweiterungsversion wie folgt:

Installationstyp	Erweiterungsversion
Aktueller Benutzer	Neueste UiPath-Erweiterung für Studio Web, veröffentlicht im Chrome WebStore.
Alle Benutzer	Neueste UiPath-Erweiterung für Studio Web, veröffentlicht im Chrome WebStore.
Gruppenrichtlinie online	Neueste UiPath-Erweiterung für Studio Web, veröffentlicht im Chrome WebStore.
Gruppenrichtlinie offline	Neueste selbst gehostete Erweiterung im Paket mit UiPath Assistant.
Aktueller Benutzer (nur Native Messaging-Host)	Neueste UiPath-Erweiterung für Studio Web, veröffentlicht im Chrome WebStore.
Alle Benutzer (nur Native Messaging-Host)	Neueste UiPath-Erweiterung für Studio Web, veröffentlicht im Chrome WebStore.

Sie können auch UiPath.ExtensionControl.Portable.dll verwenden, um eine bestimmte Browser-Erweiterungsversion zu installieren. Führen Sie es mit dem Befehl help aus, um Details zu erhalten:

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

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.

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp für den aktuellen Benutzer auszuwählen.

   

6. Wählen Sie Installieren aus.

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

   

Ergebnis: Die Erweiterung wird installiert und aktiviert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.

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 wird installiert und aktiviert.

Hinweis:

Fügen Sie die Option --ext-id={extensionId} hinzu, um eine bestimmte Erweiterungsversion anzuvisieren; Wenn keine Angabe erfolgt, wird die neueste Version installiert, die im Web Store veröffentlicht wurde. Verfügbare IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.

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.

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp Alle Benutzer auszuwählen.

   

6. Wählen Sie Installieren aus.

7. Geben Sie das Administratorkennwort in das Bestätigungs-Popup von UiPath Assistant ein.

   

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

   

Ergebnis: Die Erweiterung wird installiert und aktiviert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.

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 wird installiert und aktiviert.

Hinweis:

• sudo ist zum Ausführen dieses Befehls erforderlich, da es Systemkonfigurationsdateien aktualisiert.
• Fügen Sie die Option --ext-id={extensionId} hinzu, um eine bestimmte Erweiterungsversion anzuvisieren; Wenn keine Angabe erfolgt, wird die neueste Version installiert, die im Web Store veröffentlicht wurde. Verfügbare IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.

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.

MDM-Anforderungen

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

Wenn das Gerät nicht für eine MDM-Lösung registriert ist, werden die erforderlichen Konfigurationsdateien lokal geschrieben, ohne dass sie durch von MDM angewandte Richtlinien überschrieben werden. Dadurch kann Chrome die Richtlinie anwenden und stellt sicher, dass die Erweiterung aktiviert ist, ohne dass ein Benutzereingriff erforderlich ist.

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp Nach Richtlinie auszuwählen.

   

6. Wählen Sie Installieren aus.

7. Geben Sie das Administratorkennwort in das Bestätigungs-Popup von UiPath Assistant ein.

   

Ergebnis: Die Erweiterung wird installiert und aktiviert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.
• Um nur für den aktuellen Benutzer anstelle für alle Benutzer zu installieren, ersetzen Sie --scope=machine durch --scope=user im folgenden Befehl; bei anderen Benutzern wird die Erweiterung nicht installiert.

Warnung:

Wenn die Maschine MDM-registriert ist, müssen Sie sicherstellen, dass die Richtlinien nicht überschrieben werden. Weitere Informationen finden Sie in den MDM-Anforderungen .

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
   

Ergebnis: Die Erweiterung wird installiert und aktiviert.

Hinweis:

• sudo ist erforderlich, um diesen Befehl auszuführen, da er Systemkonfigurationsdateien aktualisiert, und mit der Option bypolicy wird der Scope automatisch auf Maschine festgelegt.
• Fügen Sie die Option --ext-id={extensionId} hinzu, um eine bestimmte Erweiterungsversion anzuvisieren; Wenn keine Angabe erfolgt, wird die neueste Version installiert, die im Web Store veröffentlicht wurde. Verfügbare IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome .

Gruppenrichtlinie offline

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

Diese Methode basiert auf Konfigurationsprofilen, die von MDM-Tools (Mobile Device Management) bereitgestellt werden. Das Konfigurationsprofil wendet die ExtensionInstallForcelist- Richtlinie an, die sicherstellt, dass die Erweiterung automatisch aktiviert wird und von Benutzern nicht deaktiviert werden kann. Sie konfiguriert auch die Richtlinien DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist , um den Zugriff von Entwicklertools auf die UiPath-Erweiterung speziell zuzulassen.

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

Warnung:

• Diese Methode funktioniert nur auf Maschinen, die bei MDM registriert sind. Weitere Informationen finden Sie in den MDM-Anforderungen .

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp Nach Richtlinie (Offline) auszuwählen.

   

6. Wählen Sie Installieren aus.

7. Geben Sie das Administratorkennwort in das Bestätigungs-Popup von UiPath Assistant ein.

   

Ergebnis: Die Erweiterung wird installiert und aktiviert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.
• Um nur für den aktuellen Benutzer anstelle für alle Benutzer zu installieren, fügen Sie --scope=user dem folgenden Befehl hinzu; Standardmäßig legt die Option bypolicy den Scope auf Maschine fest.

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

2. Starten Sie Chrome.

3. Automatisierungen entwerfen und ausführen.

Ergebnis: Die Erweiterung wird installiert und aktiviert.

Hinweis:

sudo ist zum Ausführen dieses Befehls erforderlich, da er Systemkonfigurationsdateien aktualisiert. Mit der Option bypolicy wird der Scope automatisch auf Maschine festgelegt.

Aktueller Benutzer (nur Native Messaging-Host)

Diese Methode installiert nur die Native Messaging-Host-Komponente der Erweiterung für den aktuellen Benutzer. Es erstellt oder aktualisiert die von Chrome verwendeten JSON-Konfigurationsdateien, um die Kommunikation mit einem nativen Host zu ermöglichen.

Warnung:

Die Erweiterung muss manuell über den WebStore oder über eine MDM-Konfiguration installiert werden. Weitere Informationen finden Sie in den MDM-Anforderungen .

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp Aktueller Benutzer (nur Native Messaging-Host) auszuwählen.

   

6. Wählen Sie Installieren aus.

Ergebnis: Die native Messaging-Host-Komponente der Erweiterung wird installiert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.

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 native-messaging-host-only
   

Ergebnis: Die native Messaging-Host-Komponente der Erweiterung wird installiert.

Hinweis:

Fügen Sie die Option --ext-id={extensionId} hinzu, um eine bestimmte Erweiterungsversion anzuvisieren; Wenn keine Angabe erfolgt, wird die neueste Version installiert, die im Web Store veröffentlicht wurde. Verfügbare IDs finden Sie unter Studio – Liste der Erweiterungen für Chrome.

Alle Benutzer (nur Native Messaging-Host)

Diese Methode installiert nur die Native Messaging-Host-Komponente der Erweiterung für alle Benutzer. Es erstellt oder aktualisiert die von Chrome verwendeten JSON-Konfigurationsdateien, um die Kommunikation mit einem nativen Host zu ermöglichen.

Warnung:

Die Erweiterung muss manuell über den WebStore oder über eine MDM-Konfiguration installiert werden. Weitere Informationen finden Sie in den MDM-Anforderungen .

A. Installieren Sie Schritte mit UiPath Assistant

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. Verwenden Sie die Dropdownliste für Google Chrome , um den Installationstyp Alle Benutzer (nur Native Messaging-Host) auszuwählen.

   

6. Wählen Sie Installieren aus.

7. Geben Sie das Administratorkennwort in das Bestätigungs-Popup von UiPath Assistant ein.

   

Ergebnis: Die native Messaging-Host-Komponente der Erweiterung wird installiert.

B. Installieren Sie die Schritte mithilfe von UiPath.ExtensionControl.Portable.dll (über das Terminal)

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.

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 native-messaging-host-only --scope=machine
   

Ergebnis: Die native Messaging-Host-Komponente der Erweiterung wird installiert.

Hinweis:

Fügen Sie die Option --ext-id={extensionId} hinzu, um eine bestimmte Erweiterungsversion anzuvisieren; Wenn keine Angabe erfolgt, wird die neueste Version installiert, die im Web Store veröffentlicht wurde. Verfügbare IDs finden Sie unter Studio – Liste der Erweiterungen 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 bypolicy --offline --scope=machine
  

• Aktueller Benutzer (nur Native Messaging-Host)

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

• Alle Benutzer (nur Native Messaging-Host)

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