Mac の Chrome 拡張機能

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

インストール方法

UiPath Chrome 拡張機能は、許可されるユーザー操作の量に応じて、いくつかの方法でインストールできます。

拡張機能は、特定のユーザーまたはマシンごと (すべてのユーザー) にインストールできます。これら 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 の確認ポップアップで [ 拡張機能を有効化 ] を選択します。

   

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

すべてのユーザー

この方法では、マシン上のすべてのユーザーに拡張機能がインストールされます。これは、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 の確認ポップアップで [ 拡張機能を有効化 ] を選択します。

   

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

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

この方法では、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>

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

デバイスが MDM ソリューションに登録されていない場合、 UiPath.ExtensionControl.Portable.dll ツールは必要な構成をローカルに書き込み、MDM 適用ポリシーによってオーバーライドされません。これにより、Chrome でポリシーが適用され、ユーザーの操作なしで拡張機能が有効化されます。

注:

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

インストール手順

A. MDM に登録されたマシン:

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. オートメーションを設計して実行する。

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

B。MDM に登録されていないマシン:

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

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

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

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

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

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

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

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

このメソッドは、

• Web ストアに公開されているか、非公開であるかに関係なく、任意の拡張機能をインストールできます。
• インターネットへのアクセスが制限されている環境 ( https://clients2.google.com/service/update2/crx にアクセスできない環境) で便利です。

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

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

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. オートメーションを設計して実行する。

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

この方法は、MDM (モバイル デバイス管理) ツールによってデプロイされる構成プロファイルに依存します。構成プロファイルは ExtensionInstallForcelist ポリシーを適用し、拡張機能が自動的に有効化され、ユーザーが無効にすることができないようにします。

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

アンインストール

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