コネクション

コネクションについて

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

前提条件

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

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

コネクションを作成する

1. Automation Suite にアクセスします。
2. 左側のメニューで [ Integration Service] を選択します。Integration Service のウィンドウには、[ コネクタ]、[ コネクション]、[ トリガー] の 3 つのタブがあります。既定では、[ コネクタ] タブが選択されています。オンプレミス環境にインストールされているコネクタのみが表示されます。

1. [マイ フォルダー] セクションでは、個人用ワークスペースと共有フォルダーのどちらで作業するかを選択できます。共有フォルダーを選択した場合、作成したコネクションは、このフォルダーへのアクセス権を持つすべてのユーザーが使用できます。

2. 目的の コネクタ を選択して、新しいコネクションを作成するか、既存のコネクションを更新します。
3. [ Connect to <connector name>] を選択します。選択したコネクタに応じて、コネクションに必要な特定の資格情報が要求されます。

共有されたコネクション

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

注:

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

コネクションを変更する

1. 左側のレールで [ Integration Service] を選択します。[Integration Service] ウィンドウには、[コネクタ]、[コネクション]、[トリガー] の 3 つのタブがあります。
2. 変更するコネクションが含まれるフォルダーを選択します。
   注:

   コネクションを作成するフォルダーは、手順 4 の後に選択することもできます。

3. [コネクション] タブを開くと、作成したコネクションのリストが表示されます。
4. 変更するコネクションに対応する [ 詳細 ] ボタンを選択します。以下の操作を実行できます。
   • コネクションを削除
   • コネクションを既定として設定 (このオプションは、同じアプリケーションに複数のコネクションを確立している場合にのみ利用可能)
   • コネクションを確認してステータスを検証

コネクションの名前を変更する

コネクションの名前を変更するには、以下の手順に従う必要があります。

1. [コネクション] タブを開きます。
2. 左側のメニューで [Integration Service] を選択します。[Integration Service] ウィンドウには、 コネクタ、 コネクション 、 トリガー用の個別のタブと、フォルダーを表示する左側のナビゲーション ウィンドウがあります。
3. 変更するコネクションが含まれるフォルダーを選択します。
   注:

   フォルダーは手順 4 の後に選択できます。

4. [コネクション] タブを開くと、作成したコネクションのリストが表示されます。
5. 変更するコネクションの名前の上にマウス カーソルを置きます。[編集] ボタンが表示されます。
   注:

   または、リストからコネクションを選択して詳細を表示することもできます。[編集] ボタンはコネクション名の右側にあります。

6. [ 編集 ] ボタンを選択すると、コネクションの新しい名前を選択できます。

認証の種類を選択する

Integration Service の一部のコネクタは、複数の認証方法をサポートしています。接続を開始する前に、優先する方法を選択できます。

1. Integration Service の [ コネクタ ] のリストから、サポートされているコネクタを選択します。
2. <connector name>[ 接続先 を選択して、接続の設定ページに移動します。
3. [ コネクションが保存されるフォルダー ] ドロップダウンを使用して、適切なフォルダー ( 例: [マイ ワークスペース]) を選択します。
4. [ 認証の種類 ] ドロップダウンを使用して、利用可能なオプションを以下のように選択します。
   • OAuth 2.0 の認可コード
   • OAuth 2.0 パスワード
   • 独自の OAuth 2.0 アプリ (BYOA) を使用する
   • 個人用アクセス トークン (PAT)
   注:

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

5. 選択した認証の種類に必要な資格情報を入力し、[ 接続 ] を選択して接続を確立します。

独自の 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 のコネクションを認証および認可できます。

注:

オンプレミス環境で Integration Service を使用する際に、クライアント ID とシークレットを使用して認証する必要がある場合は、[ 独自の OAuth 2.0 アプリ (BYOA ) を使用する] オプションと同様に、独自の OAuth 2.0 アプリケーションを作成する必要があります。

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

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

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

注:

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

BYOA の仕組み

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

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

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

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

BYOA 接続を設定する

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

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

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

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

1. Integration Service の [ コネクタ ] のリストから目的のコネクタを選択し、[ 接続 ] をクリックしてコネクションの作成ページを開きます。

2. 複数の認証の種類を利用できる場合は、認証の種類として [ 独自の OAuth 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 を更新します。
スコープが不十分 であるか 、アクセスが拒否されました	ベンダー アプリに必須スコープがありません。	必要なスコープを追加して再認可します。
トークンの有効期限が頻繁に切れる	有効期間の短いトークンで設定されたベンダー アプリ。	アプリで更新トークンを有効化するか、トークンの有効性を延長します。

注:

組織で BYOA を使用している場合は、Automation Ops の Integration Service のガバナンス ポリシーを使用して、これらの資格情報の既定値を設定できます。 詳細については、「 Integration Service ポリシーの設定」をご覧ください。

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

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