Robot をプロキシ サーバー経由でリダイレクトする

UiPath Robot のプロキシ サーバーを設定して、異なるネットワーク経由で Orchestrator と通信できるようにします。

ご使用のインフラストラクチャでマシン/ユーザーがインターネットに接続するためにプロキシを使用している場合は、そのプロキシを使用するように Robot を設定する必要もあります。

Robot のインストール モードに基づいて、次の 2 つの設定が可能です。

1. Attended Robot - ユーザー モードのインストール
2. Unattended Robot - サービス モードのインストール

Attended ロボット (ユーザー モード) のプロキシを構成する

Attended ロボットは、Web ブラウザーに対して構成されているプロキシ設定を継承します。

プロキシで基本認証が必要な場合は、ロボットを初めて Orchestrator に接続しようとしたときに資格情報の入力を求められます。

「Web ブラウザーを使用してプロキシを構成する」または「Windows の設定を使用してプロキシを構成する」で説明されている古い方法を使用して、プロキシを設定できます。

Unattended ロボット (サービス モード) のプロキシを構成する

プロキシを使用するようにサービス モードの Robot を正しく設定するには、proxy.json ファイルと、オートメーションを実行するユーザー アカウントの対応する Windows の設定の両方を変更する必要があります。

プロキシを proxy.json で構成するには、「proxy.json ファイルを使用してプロキシを構成する」の手順に従います。

オートメーションを実行するユーザー アカウントのプロキシを構成するには、「Attended ロボット (ユーザー モード) のプロキシを構成する」の手順に従います。

注:

proxy.jsonでプロキシを 1 回だけ設定するには、「すべてのロボット プロセスにマシンレベルのプロキシを使用する」をご覧ください。

proxy.json ファイルを使用してプロキシを構成する

v2025.10 から、Unattended ロボット (サービス モード) のプロキシを構成するには、proxy.json ファイルを変更する必要があります。古いバージョンから更新する際に、すでにプロキシが設定されている場合、設定は自動的に新しいファイルに移行されます。

1. %ProgramData%\UiPath\Shared に移動します。
2. proxy.json ファイルを探し、Notepad++ などのテキスト エディターを使用して管理者権限で開きます。

proxy.json ファイルでは複数の構成がサポートされていますが、すべての構成が同時にサポートされるわけではありません。ScriptAddress と ProxyAddress の両方が存在する場合、ScriptAddress が優先されます。

{
  "ScriptAddress": "http://localhost/proxy.pac",
  "ProxyAddress": "http://1.1.1.1:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "myPassword",
  "Domain": "myDomain"
}

注:

バイパス リストには、バイパスするサーバーの URI を含む正規表現文字列の配列が含まれている必要があります。正規表現内の文字をエスケープする場合は、\\ を使用する必要があります (例: . は \\. としてエスケープされます)。

1. プロキシ スクリプトを使用するには、次の JSON を指定します。

   {
   "ScriptAddress" : "http://proxy.address/proxy.pac"
   }
   

2. プロキシ アドレスを指定するには、次の JSON を指定します。

   {
     "ProxyAddress": "http://proxy.address:1234/",
     "BypassLocalAddresses": true,
     "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
     "UserName": "myUser", #used for basic auth
     "Password": "myPassword", #used for basic auth
     "Domain": "myDomain"
   }
   

3. proxy.json ファイルを保存します。
4. Robot サービスまたはデバイスを再起動します。

暗号化されたパスワードを使用してプロキシを設定する

注:

この機能は 2025.10.12 以降で利用できます。

セキュリティ ポリシーによってプロキシ パスワードをクリア テキストで保存することが禁止されている場合は、Password ではなく EncryptedPassword フィールドに入力します。ロボットは、プロキシに対して認証するときにこのパスワードを復号します。

このフィールドには以下のセマンティクスがあります。

• クリア テキストが優先される。Password と EncryptedPassword の両方が存在する場合、Password が優先されます。暗号化された値を利用するには、Password を空のままにするか、完全に削除します。
• Windows Data Protection API (DPAPI) はこのマシンにバインドされる。暗号文は DPAPI で生成され (LocalMachine スコープ)、暗号文が生成されたマシンでのみ有効です。

暗号化された値を生成する

次のスクリプトをロボット端末に Encrypt-ProxyPassword.ps1 として保存し、通常の PowerShell から実行します。昇格は不要です。

.\Encrypt-ProxyPassword.ps1 -Password 'myPassword'

このスクリプトは、Base64 でエンコードされた暗号文を標準出力に出力します。

param(
    [Parameter(Mandatory = $true)]
    [string] $Password
)

Add-Type -AssemblyName System.Security

[Convert]::ToBase64String(
    [Security.Cryptography.ProtectedData]::Protect(
        [Text.Encoding]::UTF8.GetBytes($Password),
        $null,
        [Security.Cryptography.DataProtectionScope]::LocalMachine))

暗号化された値を適用する

1. %ProgramData%\UiPath\Shared\proxy.json を管理者権限で開きます。
2. Password フィールドが存在する場合は削除します。
3. EncryptedPassword を追加し、スクリプトによって生成された値を設定します。

   {
     "ProxyAddress": "http://proxy.address:1234/",
     "BypassLocalAddresses": true,
     "UserName": "myUser",
     "EncryptedPassword": "AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAA...",
     "Domain": "myDomain"
   }
   

4. ファイルを保存します。
5. Robot サービスを再起動する。

Web ブラウザーを使用してプロキシを構成する

1. [インターネットのプロパティ] ウィンドウを開きます。

2. [接続] タブで [LAN の設定] を選択します。[ローカル エリア ネットワーク (LAN) の設定] ウィンドウが開きます。設定に応じて、プロキシ構成スクリプトまたはプロキシ サーバーを設定できます。

   

   1. プロキシ スクリプトを使用するには、[自動構成スクリプトを使用する] を選択し、スクリプトのアドレスを指定します。
   2. プロキシ サーバーを手動で設定するには、[LAN にプロキシ サーバーを使用する] を選択し、プロキシ サーバーのアドレスとポートを指定します。

3. 設定を保存するために、[OK] を選択します。

4. Web ブラウザーで Orchestrator の URL にアクセスして、接続をテストします。

Windows の設定を使用してプロキシを構成する

1. [プロキシの設定] ウィンドウを開きます。
2. プロキシ スクリプトを使用するには、[自動プロキシ セットアップ] で [セットアップ スクリプトを使う] をオンにします。スクリプトのアドレスを指定します。
3. プロキシ サーバーを手動で設定するには、[手動プロキシ セットアップ] で [プロキシ サーバーを使う] をオンにします。プロキシ サーバーのアドレスとポートを指定します。
   重要:

   プロキシ サーバーのアドレスにプレフィックス http:// を追加すると、ロボットは HTTPS 呼び出しを実行できなくなります。プロキシを期待どおりに動作させるには、プレフィックス http:// を完全に削除するか、http:// と https:// の両方のプレフィックスを使用してプロキシ アドレスを追加します。 以下に例を示します。

   • 誤った表記 - http://proxyaddress
   • 正しい表記 - https://proxyaddress、http://proxyaddress; https://proxyaddress
4. 設定を保存するために、[保存] を選択します。

すべてのロボット プロセスにマシンレベルのプロキシを使用する

既定では、 proxy.json は Windows サービスとして実行されるプロセス、Robot サービス、および Update Worker によって読み取り専用になります。他のロボット プロセス (たとえば、ジョブ Executor や UiRobot.exeなど) は、そのプロセスを実行するアカウントの Windows プロキシ設定からプロキシを取得します。代わりに、これらのプロセスが proxy.json と読まれるようにするには、以下の手順を実行します。

1. 「proxy.json ファイルを使用してプロキシを構成する」の説明に従ってproxy.jsonを設定します。プロキシで基本認証が必要な場合は、プロキシ資格情報も含めます。
2. マシン全体の環境変数 UIPATH_APPLY_SERVICE_PROXY を に作成し、値を Trueに設定します。
3. Robot サービスまたはデバイスを再起動します。

重要:

プロキシで基本認証が必要な場合は、proxy.jsonに UserName と Password、または EncryptedPasswordを含めます。この変数を設定すると、ユーザーごとのプロキシ資格情報は読み取られません。統合 Windows 認証では、プロセスは実行されるアカウントとして認証されるため、資格情報は必要ありません。proxy.json が ProxyAddress も ScriptAddressも宣言していない場合、プロセスはユーザーごとの資格情報なしで、実行しているアカウントの Windows プロキシ設定が保持され、ロボットは警告をログに記録します。

Robot のインストール時にプロキシ設定を構成する

Unattended ロボット (サービス モード) のインストール時にプロキシ設定を追加するには、インストール コマンドで専用のコマンド ライン パラメーターを使用します。

たとえば、次のコマンドは、Robot をサービス モードでインストールし、スクリプトを使用してプロキシを構成します。

UiPathStudio.msi ADDLOCAL=Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

次のコマンドは、Robot をサービス モードでインストールし、プロキシの設定に基本認証を設定します。

UiPathStudio.msi ADDLOCAL=Robot,RegisterService PROXY_ADDRESS=http://my.proxy.net:8008 PROXY_USERNAME="myUser" PROXY_PASSWORD="myUser" PROXY_DOMAIN="myUser"

プロキシ サーバーの接続を確認する

1. Robot を Orchestrator に接続します。
2. 既に構成済みのロボットがある環境に、いくつかパッケージをデプロイします。
3. %userprofile%\.nuget\ フォルダーに移動し、対応するプロセスおよびアクティビティ パッケージがダウンロードされているか確認します。
4. 対応するジョブを実行して、正しく実行されるか確認します。