Robot のポリシーの設定

ランタイム アナライザー

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

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

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

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

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

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

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

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

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

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

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

ブラウザーの開発者ツールからトークンを取得できます。Google Chrome で、次の手順を実行します。

1. Automation Ops™ ページから [開発者ツール ] を開き、[ アプリケーション] を選択します。
2. [ストレージ] で [ローカル ストレージ] を選択してから、アプリケーション (cloud.uipath.com など) を選択します。
3. トークン キーを見つけて、その値をコピーします。

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

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

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

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

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

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

• blacklistApps - このリストにないすべてのアプリケーションに対して、実行が許可されます。
• blacklistUrls - このリストにないすべての URL に対して、実行が許可されます。

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

CustomMessage パラメーターを使用すると、ランタイム ガバナンス ルールがトリガーされたときにカスタム メッセージを表示できます。このパラメーターの既定値は、「 UI Automation detected on '{0}' which is not an allowed application/url as your organization defined (UI オートメーションが '{ }' で検出されました。これは組織で定義されている許可されたアプリケーション/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 が自身で生成した推奨手段を使用して自律的に自己修復することを許可するかどうかを指定します。無効にすると、実行時に自己修復は試行されません。

• スクリーンショットの保存を許可する—[ 推奨される修正を許可 ] オプションが有効化されている場合にのみ使用できます。ヒーリングエージェントが実行中にスクリーンショットをキャプチャできるかどうかを指定します。

• エージェントのアプリ/URL の制限を修復する—ターゲットアプリケーションおよびURLと対話する際のエージェントの動作を制御します。レコメンデーションや修復の提供を許可または制限するアプリまたは URL を指定します。

• [ポップアップ制限の制御(Control Popup Restrictions)]:予期しないポップアップと対話するときのエージェントの動作を制御します。たとえば、ヒーリングエージェントがセキュリティポップアップを閉じないようにします。

これらの設定は 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 です。
• パラメーター - パラメーターを編集するには、パラメーターの横にある [ 編集 ] を選択し、[既定値 を使用 ] オプションをオフにして [ 値 ] ボックスの制限を設定します。