接続のトラブルシューティング

このページでは、コネクションの使用時に発生する可能性のある問題を修正する方法について説明します。

Client Request Failed: Failed to receive access token

説明

このエラーは、ユーザーが入力した資格情報または詳細が無効であることが原因で発生します。

解決策

入力/指定した資格情報がすべて有効であることを確認してください。

コネクションの作成に失敗しました。ブラウザー タブを閉じてもう一度お試しください

説明

このエラーは、スコープまたはアプリのアクセス許可が無効であることが原因で発生します。

解決策

すべてのスコープ/アクセス許可が正しく指定されているかどうか確認します。

コネクションは現在非アクティブ状態です。[コネクションを修正] をクリックしてください。

説明

OAuth トークンの有効期限切れや更新の問題により、コネクションが期限切れになる可能性があります。

解決策

[ コネクションを修正 ] を選択して、コネクション作成フローをやり直します。コネクションを修正するには、インターフェイスの右側にあるコネクションに対応する [ その他 ] ボタンを選択し、[ コネクションを修正] を選択します。

エラー コード: 400 メッセージ: Cannot delete connection with one or more triggers assigned

説明

コネクションを削除しようとすると、「エラー コード: 400 メッセージ: 1 つ以上のトリガーが割り当てられているコネクションを削除できません。」というメッセージが表示されることがあります。

解決策

インスタンスに対してトリガーを有効化している場合は、そのインスタンスを削除できません。インスタンスを削除する前にトリガーを削除します。

ユーザーは、接続フォルダーに対する Connections.View 権限がありません。

説明

Integration Service 内ではコネクションは成功しているように見えますが (ステータス: 接続済み)、無人ジョブの実行時にエラー メッセージ「The user does not have Connections.View permissions on the connection folder. (ユーザーにコネクションがありません。コネクション フォルダーの権限を確認してください。)」が表示されて失敗します。

解決策

ロボットは、プロセスで使用されているコネクションへのアクセスが必要です。

ロボットが Integration Service のコネクタを使用してジョブを実行するには、以下が必要です。

• コネクションと、ジョブを実行するロボットは、同じ Orchestrator フォルダーに存在する必要があります。
• ロボットには、コネクションの項目に対するフォルダー の表示 権限を持つロールが割り当てられている必要があります。詳細については、『 Orchestrator ガイド』をご覧ください。

ネットワークの制限

外部アプリケーションへのコネクションを作成できない場合があります。これは多くの場合、 ネットワークまたはファイアウォールの制限が原因で発生します。Integration Service の IP が許可リストに登録されていないために、対象のアプリケーションが Automation Cloud からの要求をブロックします。

接続を確認し、これらの問題を解決するには、次の手順に従います。

1. 以下の点をご確認ください。

   • Integration Service がアクセスする必要がある アプリケーション エンドポイント (URL または IP) がある。
   • 企業のファイアウォールまたはネットワーク設定にアクセスして、必要に応じて IP 範囲を許可リストに登録できます。

2. エンドポイントのアクセシビリティを確認します。

   シンプルなネットワーク ユーティリティを使用して、アプリケーション エンドポイントにインターネットから到達できるかどうかを確認します。

   curl を使う:

   curl -v https://<your-application-endpoint>

   要求が失敗した場合、エンドポイントは パブリックにアクセスできないか、IP がブロックされます。

3. Integration Service の IP を許可リストに追加します。

   公式ドキュメントの UiPath Automation Cloud の IP 範囲のリスト を参照し、 Integration Service の IP 範囲 をアプリケーションまたはファイアウォールの許可リストに追加します。

4. 接続の作成をリトライします。

   エンドポイントのアクセシビリティを確認し、IP を許可リストに登録した後、Integration Service で再度コネクションの作成を試みます。

SSO 認証されたユーザー

SSO (Okta、Azure AD、Microsoft SSO など) を使用して UiPath Automation Cloud にログインすると、 同じ SSO プロバイダーを使用する外部アプリケーションへの接続の作成で問題が発生する場合があります。

この問題は、Integration Service が既存の SSO セッションを自動的に使用するために発生し、これによりアプリケーションがログイン手順をスキップしたり、間違ったアカウントを使用してコネクションを作成したりする可能性があります。

シナリオ例

次の例は、 SSO セッションの伝達 が Integration Service でのコネクションの作成にどのように干渉するかを示しています。

1. UiPath SSO ログイン - Alejandra は、企業の Okta アカウント [e-mail]を使用して UiPath Automation Cloud にログインします。
2. 対象のアプリケーションの SSO - Alice は、企業の管理者が設定した Okta SSO も使用する Workday REST へのコネクションを作成したいと考えています。
3. コネクションの作成 - コネクションの設定時
   • ブラウザーは、既存のOktaセッショントークンを自動的に送信します。
   • Workday は、SSO ユーザーがログインを再び求めることなく [e-mail] していると見なします。
4. 問題 - Alice が 別の Workday アカウントを使用して接続しようとした場合、接続が失敗したり、ワークフローが間違った権限で実行される可能性があります。

推奨される回避策

プライベート (シークレット) ブラウザー セッションを使用する

コネクション作成ページを プライベート/シークレット ウィンドウで開きます。これにより、ブラウザーが UiPath SSO セッションを再利用できなくなります。

その後、Workday では、コネクションを作成する必要があるたびに、明示的なログイン資格情報の入力を求められます。

コネクションを作成する前に、目的のアカウントに切り替えてください

1. SSO 経由で UiPath Automation Cloud にログインします。

   Integration Service には通常どおりアクセスします。

2. Workday に別途ログインします。

   アプリケーションが現在の SSO セッションを使用して自動的にログインした場合、既定のアカウントが表示されることがあります。

3. Workday からログアウトし、コネクション作成に使用する目的のアカウントでログインします。

   これにより、アプリケーションが正しいユーザー セッションを持つようになります。

4. Integration Service に戻り、コネクションを作成します。

   Integration Service によって接続フローがトリガーされるようになります。

   目的のアカウント セッションが認可に使用され、誤った権限や同意プロンプトのスキップが防止されます。