Mac の Chrome 拡張機能

ブラウザーを自動化するために Mac に Chrome 用の UiPath 拡張機能をインストールします。ユーザー レベルのインストールまたはマシン全体へのインストールのオプションがあります。

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

インストール

以下のいずれかの方法で、Chrome 拡張機能をインストールできます。

• 現在のユーザー
• すべてのユーザー
• グループ ポリシー (オンライン)
• グループ ポリシー (オフライン)
• 現在のユーザー (ネイティブ メッセージング ホストのみ)
• すべてのユーザー (ネイティブ メッセージング ホストのみ)

インストールは、 UiPath Assistant を使用して実行するか、ターミナルから ( UiPath.ExtensionControl.Portable.dll を呼び出します)。

UiPath Assistant と UiPath.ExtensionControl.Portable.dll は、次のように最新の拡張機能バージョンをインストールします。

インストールの種類	拡張機能のバージョン
現在のユーザー	Chrome ウェブストアで公開された最新の UiPath Studio Web 拡張機能。
すべてのユーザー	Chrome ウェブストアで公開された最新の UiPath Studio Web 拡張機能。
グループ ポリシー (オンライン)	Chrome ウェブストアで公開された最新の UiPath Studio Web 拡張機能。
グループ ポリシー (オフライン)	UiPath Assistant にバンドルされている最新のセルフホスト拡張機能。
現在のユーザー (ネイティブ メッセージング ホストのみ)	Chrome ウェブストアで公開された最新の UiPath Studio Web 拡張機能。
すべてのユーザー (ネイティブ メッセージング ホストのみ)	Chrome ウェブストアで公開された最新の UiPath Studio Web 拡張機能。

UiPath.ExtensionControl.Portable.dll を使用して、特定のバージョンのブラウザー拡張機能をインストールすることもできます。詳細については、 help コマンドで実行します。

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

現在のユーザー

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

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンから [現在のユーザー] のインストールの種類を選択します。

   

6. [インストール] を選択します。

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

   

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

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

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

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

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

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

   

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

注:

拡張機能の特定のバージョンを対象とする場合は、[ --ext-id={extensionId} ] オプションを追加します。省略すると、ウェブ ストアに公開されている最新バージョンがインストールされます。利用可能な ID については、「 Studio - Chrome 拡張機能のリスト」をご覧ください。

すべてのユーザー

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

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンを使用して、[すべてのユーザー] のインストールの種類を選択します。

   

6. [インストール] を選択します。

7. UiPath Assistant の確認ポップアップで管理者パスワードを入力します。

   

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

   

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

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

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

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

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

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

   

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

注:

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

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

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

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

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

MDM の要件

構成プロファイル ( .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>

デバイスが MDM ソリューションに登録されていない場合、必要な構成ファイルはローカルに書き込まれ、MDM が適用されたポリシーによって上書きされることはありません。これにより、Chrome はポリシーを適用し、ユーザーの操作なしに拡張機能を確実に有効化できます。

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンを使用して、[ポリシー別] のインストールの種類を選択します。

   

6. [インストール] を選択します。

7. UiPath Assistant の確認ポップアップで管理者パスワードを入力します。

   

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

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

• コマンドは必ず /Applications ディレクトリの UiPath.ExtensionControl.Portable.dll ファイルを使用して実行してください。macOS は他の場所からバイナリを実行する際に敏感であるためです。
• コマンドを実行する前に、すべての Chrome ウィンドウを閉じます。
• すべてのユーザーではなく現在のユーザーにのみインストールするには、以下のコマンドで --scope=machine を --scope=user に置き換えます。他のユーザーに拡張機能はインストールされません。

警告:

マシンが MDM に登録されている場合は、ポリシーが上書きされないようにする必要があります。詳しくは、「 MDM の要件 」をご覧ください。

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

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

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

注:

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

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

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

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

このメソッドは、

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

警告:

• この方法は、MDM に登録されているマシンでのみ機能します。詳しくは、「 MDM の要件 」をご覧ください。

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンを使用して、[ポリシー別 (オフライン)] のインストールの種類を選択します。

   

6. [インストール] を選択します。

7. UiPath Assistant の確認ポップアップで管理者パスワードを入力します。

   

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

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

• コマンドは必ず /Applications ディレクトリの UiPath.ExtensionControl.Portable.dll ファイルを使用して実行してください。macOS は他の場所からバイナリを実行する際に敏感であるためです。
• コマンドを実行する前に、すべての Chrome ウィンドウを閉じます。
• すべてのユーザーではなく現在のユーザーにのみインストールするには、以下のコマンドに --scope=user を追加します。既定では、[ bypolicy ] オプションは [スコープ] を [マシン] に設定します。

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

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

2. Chrome を起動します。

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

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

注:

このコマンドを実行するにはシステム構成ファイルを更新するsudoが必要です。[ bypolicy ] オプションを使用すると、スコープは自動的に [マシン] に設定されます。

現在のユーザー (ネイティブ メッセージング ホストのみ)

このメソッドは、現在のユーザーに対して拡張機能のネイティブ メッセージング ホスト コンポーネントのみをインストールします。ネイティブ ホストとの通信を可能にするために Chrome で使用される JSON 構成ファイルを作成または更新します。

警告:

拡張機能は、ウェブストアから手動で、または MDM 構成を使用してインストールする必要があります。詳しくは、「 MDM の要件 」をご覧ください。

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンから、インストールの種類として [現在のユーザー (ネイティブ メッセージング ホストのみ)] を選択します。

   

6. [インストール] を選択します。

結果: 拡張機能のネイティブ メッセージング ホスト コンポーネントがインストールされます。

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

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

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

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

結果: 拡張機能のネイティブ メッセージング ホスト コンポーネントがインストールされます。

注:

拡張機能の特定のバージョンを対象とする場合は、[ --ext-id={extensionId} ] オプションを追加します。省略すると、ウェブ ストアに公開されている最新バージョンがインストールされます。利用可能な ID については、「 Studio - Chrome 拡張機能のリスト」をご覧ください。

すべてのユーザー (ネイティブ メッセージング ホストのみ)

この方法では、拡張機能のネイティブ メッセージング ホスト コンポーネントのみがすべてのユーザーに対してインストールされます。ネイティブ ホストとの通信を可能にするために Chrome で使用される JSON 構成ファイルを作成または更新します。

警告:

拡張機能は、ウェブストアから手動で、または MDM 構成を使用してインストールする必要があります。詳しくは、「 MDM の要件 」をご覧ください。

A. UiPath Assistant を使用したインストール手順

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

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

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

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

5. Google Chrome のドロップダウンを使用して、インストールの種類として [すべてのユーザー (ネイティブ メッセージング ホストのみ)] を選択します。

   

6. [インストール] を選択します。

7. UiPath Assistant の確認ポップアップで管理者パスワードを入力します。

   

結果: 拡張機能のネイティブ メッセージング ホスト コンポーネントがインストールされます。

B. UiPath.ExtensionControl.Portable.dll を使用してステップをインストールする (ターミナルから)

前提条件:

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

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

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

結果: 拡張機能のネイティブ メッセージング ホスト コンポーネントがインストールされます。

注:

拡張機能の特定のバージョンを対象とする場合は、[ --ext-id={extensionId} ] オプションを追加します。省略すると、ウェブ ストアに公開されている最新バージョンがインストールされます。利用可能な ID については、「 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 bypolicy --offline --scope=machine
  

• 現在のユーザー (ネイティブ メッセージング ホストのみ)

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

• すべてのユーザー (ネイティブ メッセージング ホストのみ)

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