コネクション

コネクションについて

コネクションは、単一のユーザーと外部アプリケーション間でのタスクの確立に役立ちます。コネクションは、ユーザーが API プロバイダーで認証されると作成されます。

前提条件

コネクションを使用する前に、次の条件が満たされていることを確認してください。

• Integration Service はテナントに対して有効化され、プロビジョニングされている。
• コネクションを操作するユーザーは、Orchestrator で必要な権限を持っています。コネクションを作成するには、ユーザーは対象のフォルダーでの コネクション - 作成 権限を持っている必要があります。権限の詳細については、『Orchestrator ガイド』の「 アカウントのアクセス権を設定する 」をご覧ください。

Orchestrator のコネクション

重要:

2026 年 3 月より、Orchestrator で新しい Integration Service のコネクションを作成できるようになります。既存の Integration Service のコネクションは、2026 年 7 月まで [Integration Service のコネクション] タブに引き続き表示されます (この日付は延長される可能性があります)。この日以降、Integration Service の既存のコネクションは Orchestrator に移行され、Integration Service の [コネクション] タブは削除されます。この変更は、組織やテナントのリージョンに応じて、まずコミュニティ ユーザーが利用可能になり、その後エンタープライズ ユーザーが段階的に利用可能になる予定です。変更が最初に告知されるタイミングについては、Integration Service のリリースノートをご確認ください。

Orchestrator でコネクションを管理する主なメリット

この変更には、いくつかの重要なメリットがあります。

• コンテキストの切り替えが少ない

  アセット、キュー、トリガー、コネクションをすべて 1 か所で作成できるようになり、別の左側のメニューに移動する必要がありません。クリック回数が減り、ページの読み込みが減り、認知的負荷が軽減されることで、ワークフローがスムーズになります。

• トラブルシューティングが容易

  実行が失敗する場合、すでに Orchestrator でジョブ、キュー、またはログを確認しています。関連するコネクションを同じインターフェイスで表示および管理できるようになり、解決までの時間が短縮されます。

• 一貫したメンタルモデル

  Orchestrator ではすでにリソースが一元化されています。アセットやトリガーと共にコネクションを管理すると、より直感的で一貫性のあるエクスペリエンスが得られます。

共有されたコネクション

共有フォルダー内にコネクションを作成すると、そのフォルダーへのアクセス権を持つすべてのユーザーがそのコネクションをオートメーション ワークフローで使用できるようになります。アクセス権を持つすべてのユーザーがコネクションを編集できます。

個人用ワークスペースでは、個人アカウントを使用して認証を行うコネクションを作成し、サービス アカウントを通じて認証を行うコネクションには共有フォルダーのみを使用することをお勧めします。管理者は、通常のユーザーがチームのフォルダーに Integration Service の共有コネクションを作成できないようにすることができます。詳細については、『Orchestrator ガイド』の「 ユーザー レベルの Integration Service コネクションのガバナンスを適用する 」をご覧ください。

注:

Integration Service のすべてのコネクタは、実行時のコネクションの共有と構成をサポートします。実行時のコネクションの構成について詳しくは、『 Orchestrator ユーザー ガイド』をご覧ください。

コネクションを作成する

Orchestrator の [コネクション] タブでは、コネクションを作成および管理できます。また、UiPath Studio、UiPath Studio Web、または UiPath Assistant のオートメーションから直接コネクションを作成することもできます。

Orchestrator でコネクションを作成するには、次の手順に従います。

1. 製品ランチャーから [Orchestrator] を選択します。
2. フォルダーを選択して [ コネクション ] タブに移動します。
3. [ コネクションを追加] を選択します。
4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
5. 認証の種類を選択し (該当する場合)、必要な資格情報を入力して [接続] を選択します。

詳細については、『Orchestrator ガイド』の「 接続を管理する 」をご覧ください。

注:

コネクションを正常に作成するには、Integration Service の IP アドレス許可リストを構成する必要があります。詳しくは、『Automation Cloud 管理ガイド』の「 ファイアウォールを設定する 」をご覧ください。

認証の種類を選択する

Integration Service の一部のコネクタでは、複数の認証の種類がサポートされています。種類は コネクションの作成時に選択します。利用可能なオプションには以下が含まれます。

• OAuth 2.0 の認可コード
• OAuth 2.0 パスワード
• 独自の OAuth 2.0 アプリ (BYOA) を使用する
• 個人用アクセス トークン (PAT)

注:

利用可能なオプションはコネクタによって異なります。

接続/コネクションを管理する

Orchestrator の [ コネクション ] タブから、すべてのコネクションを 1 か所で管理できます。このページでは、コネクションの健全性の確認、再接続、トリガーの管理、名前やポーリング間隔などのコネクションの詳細の編集、コネクションの削除を行うことができます。

詳細については、『Orchestrator ガイド』の「 接続を管理する 」をご覧ください。

UiPath Assistant から接続する

Integration Service のコネクションは、UiPath Assistant から直接管理できます。詳しくは、「 UiPath Assistant での接続」をご覧ください。

[ ブラウザーで設定 ] を選択して、Studio Web で [ コネクション ] ページを開きます。詳しくは、『Studio Web ガイド』の「 コネクションを管理する 」をご覧ください。

注:

Automation Cloud (公共部門向け) のユーザーは、UiPath Assistant でコネクションを表示できますが、管理することはできません。代わりに、Orchestrator の [ パッケージ要件 ] タブを使用して Integration Service のコネクションを設定および管理できます。

独自の OAuth 2.0 アプリ (BYOA) を使用する

UiPath Integration Service では、UiPath が登録した既定のパブリック OAuth アプリではなく、独自の OAuth 2.0 アプリケーションを使用して企業に接続できる、独自の OAuth 2.0 アプリ (BYOA) モデルを提供しています。

UiPath では、大半のコネクタ (Microsoft、Google、Salesforce、Atlassian Jira など) のベンダー開発者ポータルで OAuth 2.0 アプリを登録および保守しています。ほとんどの場合、これらのアプリには定義済みのスコープが付属しており、UiPath によって完全に管理されます。

ただし、一部の組織では、厳格な IT、セキュリティ、またはコンプライアンス ポリシーが設定されているため、外部アプリの登録を使用できない場合があります。このような場合、 BYOA により、ユーザーは 独自のクライアント ID とクライアント シークレット を使用して Integration Service のコネクションを認証および認可できます。

BYOA を使用する場合の一般的なシナリオ

BYOA は、次の場合に使用します。

• アプリケーションは、 認証の種類として OAuth2.0 認可コード付与をサポートしています。その他の OAuth2.0 の種類は、BYOA では使用できません。
• 企業では、 すべてのサードパーティ連携で内部管理の OAuth アプリを使用する必要があります。
• UiPath の既定の登録済みアプリに含まれない 範囲を追加または変更 する必要があります。
• 組織の セキュリティ ポリシーまたはコンプライアンス ポリシーで、共有アプリの使用が禁止されている。
• シークレットのローテーションなど、 OAuth アプリのライフサイクルを制御したい場合。

注:

UiPath のパブリック OAuth アプリは固定スコープを使用し、顧客の要求ごとに変更することはできません。追加のスコープが必要な場合は、BYOA が最適なオプションです。

BYOA の仕組み

Integration Service でコネクションを作成する際、認証の種類として [ 独自の Oauth2 アプリ (BYOA ) を使用する] を選択できます。

これにより、以下を入力できます。

• クライアント ID と クライアント シークレット - ベンダーの開発者ポータルでアプリ登録から取得した資格情報です。
• スコープ - コネクタに必要な権限です。
• リダイレクト URI - 編集不可のコールバック URL です (Automation Cloud の場合はhttps://cloud.uipath.com/provisioning_/callback )。これは、Integration Service が OAuth フローを完了するために使用するコールバック URL です。

Integration Service は、ユーザーの資格情報を使用して OAuth フローを実行し、結果として生成されるアクセス トークンと更新トークンを安全に格納します。

BYOA 接続を設定する

手順 1: ベンダー ポータルに OAuth アプリを登録する

ベンダーの開発者ポータルで OAuth 2.0 アプリを作成します (Salesforce、Microsoft、Jira、Google など)。登録時:

• リダイレクト/コールバック URI を https://cloud.uipath.com/provisioning_/callbackに設定します。
• 必要なスコープを追加します (必須のスコープについては、コネクタ固有のドキュメントをご覧ください)。
• コネクタで必要な 付与の種類 (認可コードの付与) をベンダーがサポートしていることを確認します。

手順 2: Integration Service でコネクションを作成する

1. [Integration Service > [コネクタ] に移動し、目的のコネクタを選択して [接続] をクリックします。

2. 認証の種類として [独自の OAuth2 2.0 アプリ (BYOA) を使用する] を選択します。

3. 登録済みのアプリから次の詳細を入力します。

   • クライアント ID
   • クライアント シークレット
   • 範囲 (既存のものから選択するか、手動で入力します)
   注:

   多くのベンダー (Atlassian、Jira、Coupa など) は、アプリにも同じスコープが存在することを想定しています。

4. 画面の指示に従って、ベンダーのログイン ページでユーザー名とパスワードを入力し、OAuth の同意フローを完了します。

5. 認証されると、接続は安全に保存され、使用できるようになります。

6. Integration Service は、アクセス トークンの定期的な更新を処理します。

手順 3: 必須のスコープを確認する

各コネクタには、そのアクティビティとトリガーに必要な必須のスコープがあります。

BYOA アプリにこれらのスコープが含まれていない場合、コネクションの作成は失敗するか、特定のアクションが期待どおりに動作しない可能性があります。

必須のスコープのリストを確認するには、コネクタのドキュメントをご覧ください。

ベスト プラクティス

• UiPath Integration Service 専用のエンタープライズ アプリの登録を使用します。無関係な連携のアプリ ID を再利用することは避けてください。
• 最小特権アクセスに必要なスコープのみを含めます。
• クライアント シークレットは定期的にローテーションし 、Integration Service ではコネクションを編集して更新します。
• アプリの所有権を文書化 し、管理者が変更した場合の継続性を確保します。
• リダイレクト URI が Integration Service に表示される値と完全に一致することを確認します。URI の不一致により、OAuth エラーが発生します。

セキュリティとメンテナンス

• BYOA の資格情報は暗号化され、UiPath Integration Service に安全に保存され、プレーン テキストで公開されることはありません。
• UiPath がカスタム アプリの資格情報やスコープを管理または監視することはありません。
• シークレットのローテーション、アプリの登録解除、スコープのメンテナンスは、お客様の責任です。

一般的な問題

次の表に、BYOA 接続の使用時に発生する一般的な問題と、その考えられる原因と解決策を示します。

問題	考えられる原因	解決方法
無効なクライアントまたはシークレット	クライアント ID またはシークレットが間違っています。	ベンダー アプリの登録から資格情報を確認します。
リダイレクト URI の不一致	ベンダー アプリのリダイレクト URI が UiPath の値と一致しません。	ベンダー アプリの登録でリダイレクト URI を更新します。
スコープが不十分 であるか 、アクセスが拒否されました	ベンダー アプリに必須スコープがありません。	必要なスコープを追加して再認可します。
トークンの有効期限が頻繁に切れる	有効期間の短いトークンで設定されたベンダー アプリ。	アプリで更新トークンを有効化するか、トークンの有効性を延長します。

ソリューション内の接続

コネクションとイベント トリガーは、ソリューション パッケージの一部として管理できます。ソリューション パッケージの詳細としくみ、それらを作成、管理、デプロイする方法については、 ソリューション管理の概要 に関するこちらのページをご覧ください。

ソリューション パッケージを作成すると、コネクションとそれに関連するイベント トリガーを [ コンポーネント ] パネルで利用できます。編集できるプロパティは、[ コネクション名]、[ コネクションの説明]、[ 認証の種類] です。イベント トリガーの場合は、 Orchestrator の場合と同じ設定手順を実行できます。

注:

これらのフィールドは、編集のためにロックされていない限り、デプロイ時に編集することもできます。

ソリューションが作成されパブリッシュされると、[コンポーネント] パネルでコネクションを利用できるようになります。これで、ソリューション パッケージの作成時に選択したすべてのコネクションをデプロイできます。

ソリューション管理では、イベント トリガーが接続されていない限り、プロセスのコネクションは表示されません。この問題はソリューションのデプロイに影響する場合があり、適切に動作させるには手動での接続設定が必要です。

Integration Service に作成されていない特定のフォルダーにソリューション パッケージをデプロイすることもできます。この場合、フォルダーは自動的に作成されます。

コネクションの認証の種類

管理者は、既存のコネクションを使用するか、新しいコネクションを作成するか、エンドユーザーにコネクションを選択させるかをデプロイ時に決定します。

注:

ソリューションは、コネクションとそれに関連するエンティティ リレーション (コネクションが属するワークフローやプロセスなど) を移動しますが、認証の資格情報は移行しません。

デプロイ時に、管理者は認証の種類を次のように設定できます。

• ユーザーが構成可能: 既存のコネクションからコネクションを作成または使用することはできません。ユーザーは、実行時にソリューションがデプロイされた後にコネクションを設定します。詳しくは、『Orchestrator ガイド』の「 接続を設定する 」をご覧ください。

• Authenticate after deployment is done: 新しいコネクションが作成され、デプロイ後に認証が必要になります。認証手順が完了するまで、コネクションはアクティブ化されません。

  • 認証が完了する前に、ユーザー名は System と表示されます。認証に成功すると、ユーザ名が更新され、オーセンティケ―タ―の資格情報が表示されます。

コンポーネントをリンクするオプションもあります。[ 既存のものにリンク] を選択すると、ソリューション パッケージをデプロイするユーザーがアクセスできるすべてのコネクションがポップアップ ウィンドウに表示されます。任意の既存のコネクションをソリューション パッケージの一部として選択できます。

注:

ソリューション パッケージに含まれるコネクタに既存のコネクションを選択し、デプロイ時に新しいフォルダーも選択した場合は、そのフォルダーは Integration Service 内に作成され、コネクションは含まれません。このフォルダーは、設定が変更された場合、または新しいコネクションが追加された場合に使用します。

[ 既存のものにリンク ] オプションは、[ デプロイの設定 ] または [デプロイの設定を編集] メソッドから設定を編集する場合には使用できません。デプロイ後にコンポーネントをリンクしたり、 認証の種類 を編集したりするには、ソリューション パッケージ をアップグレードする 必要があります。これには、ソリューションを編集し、新しいバージョンを再度デプロイする必要があります。

別のコネクションを使用するようにワークフローをアップグレードしても、ソリューションを使用してフォルダー内に作成されたコネクションは削除されません。これにより、これらのコネクションを利用するプロセスやオートメーションが、アップグレードの影響を受けないことが保証されます。

接続に関する問題のトラブルシューティング

コネクションの使用時に発生する可能性がある一般的な問題の解決方法については、「 コネクションのトラブルシューティング」をご覧ください。