ガバナンスと信頼

コーディング エージェントが UiPath 組織に対して動作する場合に、アクセス、認証、安全な既定値を適用する方法。

コーディング エージェントは、それ自体で UiPath にアクセスできません。すべての操作は uip CLI を経由し、CLI は 1 つの UiPath ID としてサインインします。これはユーザー自身の ID である必要はありません。その選択によって、エージェントがタッチできる対象と操作できない対象が決まります。

重要:

このページでは、意図する信頼モデルについて説明します。コンプライアンスの決定を任せる前に、組織のセキュリティ ポリシーと現在のプラットフォームの動作に対する詳細を確認してください。

開始する前に推奨されるガイドライン

コーディング エージェントに UiPath の組織を動作させる前に、コンプライアンスに準拠した責任ある使用をサポートするために、次のプラクティスをお勧めします。

• 認証。フル アクセスを継承するアカウントではなく、最小限の権限をスコープとする専用のトークン化されたアカウントをお勧めします。これにより、トークンが侵害された場合の影響が限定され、制御された追跡可能な環境で、エージェントのアクションをユーザーのアクションとは別に監査可能な状態に維持できます。
• 設定。有人実行モードでは、人間の参加ループが維持され、意図しない自律的なアクションのリスクが軽減されます。無人オプションでは、管理者特権または無制限の権限が必要であり、リスクが高くなります。したがって、有人モードが安全な既定値です。
• ガードレール。UiPath 環境へのアクセス権を付与する前に、サードパーティのコーディング エージェントに適切なガードレールを設定することで、エージェントが実行できる操作を制限し、予期しない動作や悪意のある動作のリスクを軽減することができます。エージェントの権限の範囲は、デプロイ前に慎重に定義するのが最適です。
• 個人データ。個人データが処理される場合、エージェントのアクセスを有効化または拡張する前に、組織のポリシーおよび適用されるデータ保護要件に基づいて、そのような処理を許可する必要があります。
• 人間の監視。内部プロセスにコントロール ポイントや承認が必要なステップでは、人間による監視が引き続き必要です。

警告:

免責事項: コーディング エージェントは、生成されたコードへの準拠を検証しません。生成されたすべてのコードを運用環境にデプロイする前に、社内ポリシーに従ってレビューする責任があります。

エージェントはサインイン ID として機能します

CLI は、1 つの組織と 1 つのテナントで、1 つの UiPath ID にサインインします。コーディング エージェントがそれを介して行うことはすべて、その ID の権限に制限され、サインインしているアカウントがアクセスできないリソースには到達できません。したがって、アクセス権のスコープ設定は、UiPath の場合と同じように、ロール、フォルダー、テナントの割り当てを通じて機能します。

どちらのアイデンティティであるかは、あなた次第です。エージェントは、自分のアカウントで、実行できることはすべて実行できます。作業に必要な情報のみを保持する専用の ID があれば、エージェントが得られるのはそれだけです。

その ID に制限が設定されます。個別の設定では、エージェントに付与されるアクセス権が実行される ID よりも少ないものはありません。推奨されるガイドラインでは、専用のガイドラインを優先します。

ID の選択

CLI をログインするには 2 つの方法があり、さまざまな種類の ID が生成されます。

ログイン方法	ID: エージェントが機能する役割	一般的な用途
対話型ログイン — uip loginブラウザーを開きます	ログインするユーザー アカウントとそのすべてのロールとフォルダーの割り当てです	各アクションを確認するために人が立ち会うローカル開発
非対話型認証 — クライアント ID、クライアント シークレット、スコープを使用して uip login します	スコープとフォルダー ロールのみが付与されている外部 OAuth アプリケーション	自動化されたコンテキスト、およびエージェントがユーザーの権限を保持してはならない設定

対話型ログインでは、ブラウザーと組織の通常のサインイン (多要素アクセス ポリシーや条件付きアクセス ポリシーを含む) を使用します。非対話型認証では、ユーザーがプロビジョニングおよび制御した資格情報が使用されます。いずれにせよ、エージェントはユーザーのパスワードを必要とすることはありません。CLI が確立するセッションで機能します。

対話型ログインは、必ずしも日常業務用のアカウントを意味する必要はありません。エージェントの作業用に作成された専用のユーザー アカウントは、まったく同じ方法でログを記録します。重要なのは、ID がどのようにログインするかではなく、その ID がどれだけの権限を持っているかです。

資格情報の取得元

CLI は、環境変数、 uip loginによって保存された資格情報、および同じマシン上の UiPath Robot の 3 つのソースから資格情報を取得できます。それぞれが独自のアイデンティティを持っています。複数の 1 つが使用可能な場合、CLI は次の優先順位で解決します。

1. ロボット セッション ( UIPATH_CLI_ENFORCE_ROBOT_AUTH が設定されている場合)。デスクトップ版の UiPath Studio ではこのパスが使用され、他のすべてのソースが上書きされます。
2. UIPATH_CLI_ENABLE_ENV_AUTHが設定されている場合に、環境変数を通じて提供されるトークンです。
3. uip loginによって、プロジェクト ディレクトリまたはホーム ディレクトリ、または --profileという名前のプロファイルから保存された資格情報です。
4. 同じマシン上の UiPath Robot からのセッションで、保存されている資格情報が見つからなかったときのセッション。

資格情報がロボットから取得される場合、エージェントはロボットのサインインに使用するアカウントとして機能します。ロボットは資格情報ではなく資格情報を提供します。

エージェントのアクセス権を確認する際には、次の 2 つの点が重要です。

• 身元確認。uip login status 、解決されたソースを、組織およびテナントとともに報告します。これは、特定のマシン上でエージェントがどの ID として機能するかを確立するための信頼性の高い方法です。
• ID をピン留めする。プロファイルに名前を付けると、CLI がそのプロファイル上に保持されます。そのプロファイルの資格情報が見つからない場合、CLI は、別の ID にフォールスルーするのではなく、ログインしていないことを報告します。

属性付けと監査

UiPath は、CLI がサインインした ID を記録し、それ以降は記録しません。これは両方に当てはまります。

• あなた自身のアカウントは、記録をその人に結び付けたままにしますが、その人ができることはすべてエージェントに渡します。
• 専用の ID を使用すると、エージェントが実行できる操作は狭くなりますが、レコードは専用の ID に名前を付けます。複数の人が 1 つを共有する場合、レコードでは区別できません。

どのユーザーが何をしたかを知る必要がある場合は、1 人あたり (またはエージェントのワークロードごとに) 1 つの専用 ID を使用して、狭い権限と名前の両方を提供します。

シークレットと資格情報

資格情報とシークレットは、プロンプト、プロジェクト ファイル、ソース管理ではなく、シークレット ストアまたは CI/CD システムのシークレット管理に属します。オートメーションに適用するのと同じ規範がここでも適用されます。

当社が収集するデータ

西ヨーロッパ リージョンでホストされている UiPath 所有の Azure Application Insights に、製品の使用状況テレメトリを送信するソースは 2 つです。 uip CLI 独自のコマンド テレメトリと、コーディング エージェントが CLI を介して呼び出す UiPath スキルです。どちらも同じ UiPath で管理されるリソースに格納され、区別できるようにタグ付けされています。このデータは、どのコマンドとスキルが使用され、どこで失敗するかを理解するのに役立ちます。

どちらのソースも既定で送信されます。以下の 「テレメトリをオンまたはオフにする」 をご覧ください。

収集される内容

• コマンドとスキルの使用状況 — uip コマンドまたはスキル主導のツール呼び出しごとに、コマンド名またはツール名、派生した uip サブコマンド (最初の 1 つまたは 2 つの動詞で、完全なコマンド ラインは使用不可)、スキル名 (UiPath スキルのみ)、実行時間、成功したか、中断されたか、失敗したか (CLI コマンドの場合はエラー メッセージ付き) です。
• ファイルの種類 — ツール呼び出しに関連するファイル拡張子 ( .flowなど) であり、ファイルパスではありません。
• 環境 — CLI とスキルのバージョン、サインインから派生したクラウド環境 (アルファ、ステージング、運用環境など)、CLI を呼び出した AI コーディング エージェント (Claude Code、Cursor、Gemini CLI、Codex など) です。
• Identity — サインインしている UiPath クラウド ID (クラウド ユーザー ID、テナント ID、組織 ID) です。このテレメトリは 匿名ではありません。このアクティビティは、他のすべての uip CLI アクティビティと同じ ID を持ちます。
• 相関 ID — 単一の実行のステップをリンクするセッション識別子と呼び出しごとの識別子。

収集されないもの

以下は、エージェントとCLIがローカルで読み取って作業を行う場合でも、マシンを離れることはありません。

• ファイルの内容、コマンド出力 (stdout と stderr)、エージェントの文字起こし。
• 完全なコマンドライン — 派生したサブコマンド動詞のみ。
• ファイルパスと作業ディレクトリ — ファイル拡張子のみ。

各テレメトリ フィールドは、ペイロードの特定の境界部分から抽出されるため、自由形式のコンテンツ (パスやコマンド名を含む出力など) がフィールドにリークすることはありません。CLI 独自のコマンド テレメトリの場合、値はソースでさらに編集されます。次のいずれかに類似したものは、 [REDACTED]に置き換えられます。

• トークンまたはキー
• シークレットまたはパスワード
• 資格情報または証明書

識別子と電子メールはハッシュ化されます。URL はホストに縮小されます。

行く先

西ヨーロッパ リージョンにある UiPath 所有の Azure Application Insights。接続はCLIによって所有されます。スキルは決してそれを保持しません。UIPATH_AI_CONNECTION_STRING 環境変数を使用してテレメトリを別のインスタンスにルーティングできますが、通常の使用では必要ありません。

retention

リテンション期間は、CLI やスキルではなく、Application Insights ワークスペースの構成によって管理されます。Azure Application Insights は、ワークスペースが特に構成されていない限り、既定で 90 日に設定されます。プラットフォーム チームは、設定された保持期間を使用する前に、その期間を確認できます。

テレメトリをオンまたはオフにする

1 つの環境変数 UIPATH_TELEMETRY_DISABLEDによって両方のソースが制御され、どちらも同じように動作します。

• テレメトリは既定で送信します。変数が設定されていないか、 0 またはその他の値に設定すると、CLI のコマンド テレメトリとスキル テレメトリの両方が送信します。
• [ UIPATH_TELEMETRY_DISABLED ] を [ 1 ] または [ true ] に設定すると、両方が無効化されます。何も送信されず、CLI はローカルのデバッグ ログのみを保持します。

コントロールを維持する

コーディング エージェントはアクションを提案し、標準構成では、実行する前に承認するためのコマンドを表示します。承認する前に、エージェントが生成した内容と、エージェントが実行しようとしている内容を確認することで、組織内の状態が変化するすべてのことについて、人間がループを維持できます。

問題が発生した場合の問題を調査するには、「 トラブルシューティングとよくある質問」をご覧ください。