Robot のポリシーの設定

ランタイム アナライザーの設定とガバナンス制御により、アプリ/URL の制限など、ロボットの実行中に組織のポリシーを適用できます。

ランタイム アナライザー

ランタイム アナライザー ルールは、ロボットがプロセスを実行する際にそのプロセスが組織のポリシーに準拠していることを確認し、プロセスの実行中にベスト プラクティスを適用できるようにします。これにより、ロボットが組織外にメールを送信したり、自動化すべきでないアプリや Web ページを自動化したりするのを防ぐことができます。

ランタイム ルールはアクティビティ パッケージに含まれており、それらのパッケージ内の特定のアクティビティに適用されます。設定されているランタイム ルールはロボットによって取得され、対象のアクティビティが実行される際に各ルールが検証されます。

[ ランタイム アナライザー ] タブでは、有効化するランタイム ルールを選択したり、ルール アクションやルール パラメーターを設定したりできます。このルールは、 ワークフロー アナライザー ルールを設定する方法と同様に設定されます。

Automation Ops™ には、以下の既定のランタイム ルールが付属しています。

• RT-UIA-001 (アプリ/URL の制限) - UI Automation アクティビティ パッケージ内のアクティビティで許可/ブロックされているアプリケーションまたは URL のリストを定義できます。
• RT-OUT-001 (ブロックするメール アドレス リスト) - GSuite、Mail、Office 365 アクティビティ パッケージのアクティビティでメールを送信できないアドレスを定義できます。

ルールは既定で有効化されていますが、パラメーターは定義されていません。アクションは Error に設定されています。つまり、ルール違反が検出されると、エラーがスローされて実行が停止します。

ランタイム ガバナンスを有効化する

ランタイム ガバナンスは既定では有効化されていません。Automation Ops™ のページの上部に、この機能が無効化されたことを示すバナーが表示されます。バナーで [ 有効化 ] を選択してランタイム アナライザーを有効化します。

以下の API 要求を使用して、ランタイム ガバナンスを有効化/無効化することもできます。

POST "https://govcloud.uipath.us/{organizationName}/roboticsops_/api/Product/Robot/enable" -H "Authorization: Bearer {token}"

POST "https://govcloud.uipath.us/{organizationName}/roboticsops_/api/Product/Robot/disable" -H "Authorization: Bearer {token}"

You can retrieve the token from the browser developer tools. In Google Chrome, the token is available under Developer Tools > Application > Storage > Local Storage > the application (for example, cloud.uipath.com), in the token key.

RT-UIA-001 - アプリ/URL の制限

このルールは、制限されたアプリケーションまたは Web ページがプロジェクトで使用されているかどうかを確認します。利用可能なパラメーターを使用し、許可またはブロックされているアプリケーションおよび URL のリストを定義して、制限を設定します。ルールではローカル アプリケーションとリモート アプリケーション (RDP 接続で自動化されたアプリケーションなど) の両方がチェックされます。

注:

このルールは UiPath.UIAutomation.Activities v21.10.3 以降で使用できます。

注:

The following parameter names (whitelistApps, blacklistApps, whitelistUrls, blacklistUrls) are legacy API names maintained for backward compatibility. New configurations should use the updated parameter names from the Orchestrator API documentation.

許可されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• whitelistApps - Execution is allowed only for the applications that are on this list.
• whitelistUrls - Execution is allowed only for the URLs that are on this list.

禁止されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• blacklistApps - Execution is allowed for all the applications that are not on this list.
• blacklistUrls - Execution is allowed for all the URLs that are not on this list.

同じスコープ (アプリケーションまたは URL) に対して禁止されているリストと許可されているリストの両方が設定されている場合、許可されているリストが優先されます。

CustomMessage パラメーターを使用すると、ランタイム ガバナンス ルールがトリガーされたときにカスタム メッセージをユーザーに表示できます。このパラメーターの既定値は、 UI Automation が '{0}' で検出されました。これは、組織で定義されている許可されたアプリケーション/URL ではありません。

制限を設定する

URL/アプリケーション名のリストをコンマ (,) またはセミコロン (;) で区切って指定します。複数の項目を指定すると、そのすべてが検証されます。

ワイルドカード文字 * と ? を使用してパターンを定義できます。例:

• *uipath*.exe - uipath で始まる名前のすべての実行可能ファイルをブロックします。
• *www.uipath*.com - 使用されているプロトコルに関係なく、uipath で始まるすべての URL をブロックします。

ルールが検証する項目

モダン アクティビティとクラシック アクティビティのどちらについても、このルールは実行時に、定義済みのセレクターや入力 UI 要素を使用して検出された各ターゲット UI 要素を検証します。

注:

パフォーマンスへの影響を回避するため、[ クリック トリガー ] や [キー押下トリガー ] などの UI 自動化関連のトリガーでは検証は実行されません。チェックは、基になるワークフロー アクティビティによって実行されます。

RT-OUT-001 - ブロックするメール アドレス リスト

このルールは、メール、Microsoft 365、および Google Worskpace パッケージに含まれる、メールの送信、返信、転送、通知の送信、イベントの作成、予定表の招待の送信を行うすべてのアクティビティを確認し、ブロックするメール リストに追加された受信者にメールが送信されないことを確認します。

注:

このルールは、以下のパッケージ バージョン以降で使用できます。

• UiPath.GSuite.Activities v1.11.3
• UiPath.Mail.Activities v1.12.2
• UiPath.Office365.Activities v1.11.1

制限を設定する

EmailRegex パラメーターを使用して、許可されないメール アドレスのパターンを正規表現で指定します。

例:

• .*@uipath.com - uipath.com ドメインのアドレスに送信されるすべてのメールをブロックします。
• .*@(?!uipath\.com$) - uipath.com ドメインのアドレスに送信されるメール以外のすべてのメールをブロックします。

カスタム エラー メッセージ

CustomMessage パラメーターを使用して、[RT-OUT-001 - ブロックするメール アドレス リスト] ルールをトリガーしたときに表示されるエラー メッセージをカスタマイズします。長さの制限は 2000 文字に設定されています。

[ 既定値を使用 ] パラメーターは既定で有効化されています。カスタム メッセージを使用するには無効化します。

ルールが検証する項目

このルールは、メールを送信できる以下のアクティビティで、メールの受信者を示すすべてのプロパティを検証します。

• Mail パッケージ:
  • [連携] カテゴリ (StudioX) のアクティビティ - [メールを送信]、[メールを転送]、[メールに返信]、[カレンダー/予定表の招待を送信]
    注:

    このルールは、アクティビティがメッセージを送信するのではなく下書きとして保存する場合には適用されません。

  • [アプリの連携] カテゴリのアクティビティ - [Exchange メール メッセージを送信]、[IBM Notes メール メッセージを送信]、[Outlook メール メッセージを送信]、[Outlook メール メッセージに返信]
• Google Workspace パッケージ - メール メッセージを送信、イベントを作成、参加者を追加、ファイルを共有、イベントを削除、イベント/予定を変更
• Microsoft 365 パッケージ - メールを送信、メールに返信、メールを転送、出席者を追加、ファイル/フォルダーを共有

Healing Agent ランタイム ガバナンス

ヒーリングエージェントのランタイムガバナンスは、組織管理者がエージェントのランタイム機能を制御するのに役立ちます。

次の値を設定できます。

• 修正の推奨事項を許可 — UI Automation のエラーが発生したときに、Healing Agent で推奨の修復手順を生成できるようにします。無効にすると、実行時に Healing Agent の機能がすべて無効になり、他のガバナンス オプションに影響します。
• 自己修復を許可 — [推奨の推奨事項を許可] オプションが有効な場合にのみ使用できます。Healing Agent が生成した推奨手段を使用して自律的に自己修復することを Healing Agent に許可するかどうかを指定します。無効にすると、実行時に自己修復は試行されません。
• スクリーンショットの保存を許可 — [推奨の修正事項を許可] オプションを有効にしている場合にのみ使用できます。Healing Agent がその実行中にスクリーンショットをキャプチャできるかどうかを指定します。
• Healing Agent のアプリ/URL の制限 — 対象のアプリケーションおよび URL を操作しているときにエージェントの動作を制御します。推奨の修復方法の提供を許可または制限するアプリまたは URL を指定します。
• ポップアップ制御の制限 — 予期しないポップアップを操作するときにエージェントの動作を制御します。たとえば、セキュリティのポップアップが Healing Agent によって閉じられないようにします。

これらの設定は Orchestrator プロセスのオプションを制御するものではなく、実行時にのみ適用されます。

注:

ロボット ログは、Orchestrator によって有効化されたヒーリング エージェント機能がランタイム ガバナンスによって無効化されるたびに更新されます。

HA-UIA-001 - アプリケーション/URL の制限

このルールは、ヒーリングエージェントがプロジェクトで使用される特定のアプリケーションやWebページとの対話を制限されているかどうかを確認します。制限を設定するには、使用可能なパラメーターを使用して、許可または禁止するアプリケーションおよび URL のリストを定義します。このルールは、ローカルとリモートの両方のアプリケーション (RDP 接続で自動化されるアプリケーションなど) をチェックします。

注:

このルールは、[推奨の修正事項を許可] を有効化し、UiPath.UIAutomation.Activities v25.10 を使用している場合にのみ適用されます。

レコメンデーションの発行や自己修復のためにヒーリングエージェントが操作できるアプリケーションまたはURLを定義するには、次のパラメータを使用します。

• allowedApps - 実行は、このリストにあるアプリケーションに対してのみ許可されます。
• allowedUrls—実行は、このリストにある URL に対してのみ許可されます。

禁止されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• forbiddenApps - このリストにあるすべてのアプリケーションの実行が禁止されています。
• forbiddenUrls:このリストにあるすべての URL に対して実行が禁止されます。

同じスコープ (アプリケーションまたは URL) に対して禁止されているリストと許可されているリストの両方が設定されている場合、許可されているリストが優先されます。

制限を設定する

制限を設定するには、URL/アプリケーション名をコンマ (,) またはセミコロン (;)) で区切ったリストを指定します。複数の項目を指定した場合は、すべて検証します。***** と ?ワイルドカード文字を使用してパターンを定義します。

例:

• *uipath*.exe — uipath で始まる名前の実行可能ファイルをすべてブロックします。
• *www.uipath*.com - 使用されているプロトコルに関係なく、uipath で始まるすべての URL をブロックします。

ルールが検証する項目

モダン アクティビティの場合、ルールは実行時に、ヒーリング エージェントと定義されたアプリケーションとの対話が許可されているかどうかを検証します。これは、レコメンデーションと自己修復オプションの両方に当てはまります。

HA-UIA-002 - ポップアップを閉じるの制限

このルールは、ヒーリング エージェントが、予期せず表示され、オートメーションをブロックする可能性のある定義済みのポップアップやウィンドウを閉じないように制限されているかどうかを確認します。

注:

このルールは、[推奨の修正事項を許可] を有効化し、UiPath.UIAutomation.Activities v25.10 を使用している場合にのみ適用されます。

ポップアップ リストを定義するには、次のパラメーターを使用します。

• forbiddenPopups - 自然言語を使用して、エージェントが操作を禁止されているポップアップまたはウィンドウを表します。例えば：
  • セキュリティ アラート
  • 不審なアクティビティの検出
  • [許可]、[このまま続行]、[ブロック] などのボタンのあるアラート。
• 制限の構成 - 自然言語を使用して、ポップアップの説明のリストをコンマ (,) またはセミコロン (;)) で区切って指定します。複数の項目を指定した場合は、すべて検証します。

ルールが検証する項目

モダン アクティビティの場合、ルールは実行時に、ヒーリング エージェントが記述されたポップアップの種類との対話を許可されているかどうかを検証します。これは、レコメンデーションと自己修復オプションの両方に当てはまります。

ランタイム ルールを設定する

既定のルールそれぞれに、以下のオプションを設定できます。

• 有効化 - ルールを有効化するには、このオプションを選択します。
• アクション - ルールのアクションを設定します。Error、Warning、Info、または Verbose のいずれかです。既定のアクションは Error です。
• パラメーター - パラメーターを編集するには、その横にある [ 編集 ] を選択し、[ 既定値を使用 ] オプションの選択を解除して、[ 値 ] ボックスで制限を設定します。