Mac の Chrome 拡張機能

この拡張機能を使用すると、Mac 上で Google Chrome ブラウザーの操作を自動化できます。

インストール方法

The UiPath extension for Chrome can be installed for the current user or for all users, depending on how much user interaction is permitted.

拡張機能は、特定のユーザーまたはマシンごと (すべてのユーザー) にインストールできます。これら 2 つのインストールの種類の唯一の違いは、構成ファイルの場所です。

インストールの種類	構成ファイルの場所
ユーザーごと	~{userId}/Library/Application Support/Google/Chrome/External Extensions/ ~{userId}/Library/Application Support/Google/Chrome/NativeMessagingHosts/ {userId} をユーザーのユーザー名に置き換えます。
マシンごと	/Library/Application Support/Google/Chrome/External Extensions/ /Library/Google/Chrome/NativeMessagingHosts/

UiPath Assistant からインストールする

UiPath Assistant を使用したインストールは、UiPath Assistant がすでにインストールされている限り、数回クリックするだけで追加の設定を行う必要はありません。この方法では、Web ストアに公開されている最新の拡張機能バージョンを 現在のユーザー に対してのみインストールできます。

1. UiPath Assistant にアクセスします。

2. アカウント アイコンを選択します。

3. [ 設定] を選択します。

4. [UiPath 拡張機能] に移動します。

5. Google Chrome の [インストール] を選択します。

   

6. Google Chrome の確認ポップアップで [ 拡張機能を有効化 ] を選択します。

   

結果

拡張機能がインストールされ、有効化されている。

ターミナルからインストールする (UiPath.ExtensionControl.Portable.dll 経由)

UiPath では、拡張機能のインストールを管理するためのツールとして UiPath.ExtensionControl.Portable.dllを提供しています。このツールは、拡張機能の実行に必要な追加ファイルとともに UiPath Assistant と共に配布されます。

前提条件

• コマンドは必ず /Applications ディレクトリの UiPath.ExtensionControl.Portable.dll ファイルを使用して実行してください。macOS は他の場所からバイナリを実行する際に敏感であるためです。
• コマンドを実行する前に、すべての Chrome ウィンドウを閉じます。

次のいずれかのインストール方法を使用できます。

• 現在のユーザー
• すべてのユーザー
• グループ ポリシー (オンライン)
• グループ ポリシー (オフライン)

現在のユーザー

この方法では、現在のユーザーにのみ拡張機能がインストールされます。Chrome が拡張機能を検出するために使用する JSON 構成ファイルを作成または更新します。これらのファイルは、拡張機能 ID、更新 URL、およびネイティブ メッセージング ホストへのパスを定義します。

注:

• 特定の拡張機能バージョンを対象にするには、[ --ext-id={extensionId} ] オプションを追加します。{extensionId} を目的の拡張機能の ID に置き換えます。利用可能な ID のリストについては、「 Studio - Chrome 拡張機能のリスト」をご覧ください。
• コマンドの --ext-id={extensionId} 部分は省略可能です。省略すると、Web ストアに公開されている拡張機能の最新バージョンがインストールされます。

インストール手順

1. ターミナルを開いて、次のコマンドを実行します。

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

2. Google Chrome の確認ポップアップで [ 拡張機能を有効化 ] を選択します。

   

Result The extension is installed and enabled.

すべてのユーザー

この方法では、マシン上のすべてのユーザーに拡張機能がインストールされます。これは、Chrome が拡張機能を検出するために使用する JSON 構成ファイルを作成または更新することで、 現在のユーザーの 方法と同様に機能します。違いはファイルの場所にあり、このメソッドは設定ファイルをシステム全体の場所に書き込みますが、 Current User メソッドはユーザー固有の場所に書き込みます。

注:

• このコマンドを実行するには、システム構成ファイルを更新するため、sudoが必要です。
• 特定の拡張機能バージョンを対象にするには、[ --ext-id={extensionId} ] オプションを追加します。{extensionId} を目的の拡張機能の ID に置き換えます。利用可能な ID のリストについては、「 Studio - Chrome 拡張機能のリスト」をご覧ください。
• コマンドの --ext-id={extensionId} 部分は省略可能です。省略すると、Web ストアに公開されている拡張機能の最新バージョンがインストールされます。

インストール手順

1. ターミナルを開いて、次のコマンドを実行します。

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

2. Google Chrome の確認ポップアップで [ 拡張機能を有効化 ] を選択します。

   

Result The extension is installed and enabled.

グループ ポリシー (オンライン)

この方法では、Chrome を最初に起動した後に拡張機能を有効にする手動の手順は必要ありません。これは、MDM (モバイル デバイス管理) ツールによってデプロイされる構成プロファイルに依存しているためです。

構成プロファイルは、 ExtensionInstallForcelist ポリシーを設定します。このポリシーにより、拡張機能が有効化され、手動で無効にすることはできません。

この手順は、Windows グループ ポリシー (オンライン) のインストール方法「 Studio - Chrome 拡張機能」に記載されている手順と似ています。

構成プロファイル ( .mobileconfig ファイル) をインストールするには、MDM アプリケーションがマシンに存在し、マシンを登録して管理する必要があります。

MDM の例は次のとおりです。

• Jamf(ジャム)
• Microsoft Intune
• カンジ
• MicroMDM (オープンソース)

デバイスがMDMソリューションに登録されている場合は、MDMを介してプッシュされた構成の更新によって構成が上書きされていないことを確認してください。これを防ぐには、MDM を使用して構成プロファイルを直接デプロイします。プロファイルには、以下の例のような設定が含まれています。

<?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 UiPath.ExtensionControl.Portable.dll tool writes the required configuration locally, without it being overridden by MDM-applied policies. This allows Chrome to apply the policy and ensures that the extension is enabled without requiring user interaction.

注:

• このコマンドを実行するには、システム構成ファイルを更新するため、sudoが必要です。
• bypolicyオプションを使用すると、スコープが自動的にマシンに設定されます。
• このコマンドは、--scope=machineではなく --scope=user で発行できます。この効果により、現在のユーザーのみが拡張機能がインストールされ、自動的に有効化されます。それ以外のユーザーは拡張機能をインストールしません。
• 特定の拡張機能バージョンを対象にするには、[ --ext-id={extensionId} ] オプションを追加します。{extensionId} を目的の拡張機能の ID に置き換えます。利用可能な ID のリストについては、「 Studio - Chrome 拡張機能のリスト」をご覧ください。
• コマンドの --ext-id={extensionId} 部分は省略可能です。省略すると、Web ストアに公開されている拡張機能の最新バージョンがインストールされます。

A. Install Steps on MDM-enrolled machine

1. ターミナルを開き、次のコマンドを実行します。bypolicy 引数は、MDM を介してプッシュされる設定が既存の値を上書きするように設定されている場合は削除できます。

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

2. 新しい .mobileconfig ファイルを作成して、必要なポリシーを設定します。.mobileconfig ファイルは、おおよそ上記の内容になっているはずです。

3. MDM プロバイダーを使用して構成プロファイルをインストールします。

4. Chrome を起動します。

5. オートメーションを設計して実行する。

Result The extension is installed and enabled.

B. Install Steps on Not MDM-enrolled machine

1. ターミナルを開いて、次のコマンドを実行します。

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

2. オートメーションを設計して実行する。

Result The extension is installed and enabled.

グループ ポリシー (オフライン)

この手順は、Windows グループ ポリシーによるオフライン インストールの方法に似ています。詳しくは、「 Studio - Chrome 向け拡張機能」をご覧ください。

This method relies on Configuration profiles deployed by MDM (Mobile Device Management) tools. The Configuration profile applies the ExtensionInstallForcelist policy, which ensures that the extension is automatically enabled and cannot be disabled by users. It also configures the DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist policies to specifically allow Developer Tools access to UiPath extension.

このメソッドは、

• Lets you install any extension, whether published to Web Store or unpublished.
• インターネットへのアクセスが制限されている環境 ( https://clients2.google.com/service/update2/crx にアクセスできない環境) で便利です。

UiPath.ExtensionControl.Portable.dll を使用してこのインストールの種類を完全に実行することはできません。(ローカル マシン上または管理者マシンからの) 介入が必要になるためです。

UiPath.ExtensionControl.Portable.dll では、拡張機能がネイティブ ホストと通信するために必要な構成ファイルの更新がサポートされています。したがって、前述したように、このアクティビティを使用してユーザー単位またはマシン単位で拡張機能をインストールできますが、拡張機能を確実にインストールして有効化するには、追加の手順が必要です。

設定プロファイルの内容は、おおよそ次のようになります。

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

ExtensionInstallForcelist 文字列の形式は次のとおりです。

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

{urlWithThePathToTheUpdateManifestXmlFile}値は、更新マニフェスト XML ファイルへの URL (https:// または file://) に置き換える必要があります。このファイルの内容は次のとおりです。

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

注:

• {extensionId} を拡張機能の ID に置き換えます。
• {crxUrl} は CRX の URL (CRX がサーバーでホストされている場合はhttps://、ファイルがローカルマシンに配置されている場合は file:// で置き換える必要があります)。
• {extensionVersion}は、拡張機能のバージョン (24.10.3 など) に置き換える必要があります。

インストール手順

注:

手順 1 と 2 は管理者マシンで実行します。

1. 上記のように構成プロファイルを作成します。

2. MDM プロバイダーを使用してプロファイルをプッシュします。

3. ターミナルを開き、次のコマンドを実行して、ネイティブ メッセージング ホストをインストールします。

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

4. Chrome を起動します。

5. オートメーションを設計して実行する。

Result The extension is installed and enabled.

アンインストール

UiPath Assistant からアンインストールする

1. UiPath Assistant にアクセスします。

2. [UiPath 拡張機能] に移動します。

3. Google Chrome の [アンインストール] を選択します。

   

結果

拡張機能がアンインストールされます。

ターミナルからアンインストールする

インストール方法に関係なく、次のコマンドを実行すると UiPath Chrome 拡張機能をアンインストールできます。

dotnet UiPath.ExtensionControl.Portable.dll cleanup chrome

結果

拡張機能がアンインストールされます。

ステータスを確認する

Chrome 拡張機能のステータスを確認するには、インストール方法に応じて対応するターミナル コマンドを実行します。

• 現在のユーザー

  dotnet UiPath.ExtensionControl.Portable.dll status chrome
  

• すべてのユーザー

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

• グループ ポリシー (オンライン)

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

• グループ ポリシー (オフライン)

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