コネクション

コネクションについて

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

コネクションを作成する

1. 左側のレールで [ Integration Service] を選択します。Integration Service のウィンドウには、[ コネクタ]、[ コネクション]、[ トリガー] の 3 つのタブがあります。既定では、[ コネクタ] タブが選択されています。
2. [マイ フォルダー] セクションでは、個人用ワークスペースと共有フォルダーのどちらで作業するかを選択できます。共有フォルダーを選択した場合、作成したコネクションは、このフォルダーへのアクセス権を持つすべてのユーザーが使用できます。
3. 目的の コネクタ を選択して、新しいコネクションを作成するか、既存のコネクションを更新します。
4. [<Connector name> に接続] を選択します。選択したコネクタに応じて、コネクションに必要な特定の資格情報が要求されます。
5. コネクションが存在するフォルダーまたはサブフォルダーを選択します。個人用ワークスペース、または共有フォルダーで作業できます。作成したコネクションは、そのフォルダーにアクセスできるすべてのユーザーが使用できます。

注:

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

共有されたコネクション

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

注:

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 のコネクションは、UiPath Assistant から直接管理できます。詳しくは、「 UiPath Assistant での接続」をご覧ください。

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

注:

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

認証の種類を選択する

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) を使用する

認証エクスペリエンスでは、OAuth 2.0 認可コードをサポートするコネクタに対して [ Bring your own OAuth 2.0 app (BYOA) (独自の OAuth 2.0 アプリ (BYOA)) オプションを使用できます。これにより、コネクションを作成する前に、認証時にプライベート アプリケーションを選択できます。

[独自の OAuth 2.0 アプリ (BYOA) を使用する] メソッドを使用してコネクションを作成するには、次の資格情報が必要です。

• クライアント ID
• クライアント シークレット

注:

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

サードパーティを使用してプライベート OAuth アプリケーションを作成する場合は、特定のサードパーティのドキュメントに従って設定してください。アプリケーションのリダイレクト URI (またはコールバック URL) を https://cloud.uipath.com/provisioning_/callbackに設定してください。

お使いの OAuth 2.0 アプリケーションへのコネクションを作成するには、次の手順を実行します。

1. Integration Service に移動します。[ コネクタ] のリストから、サポートされているコネクタを選択します。
2. [ 接続先 ] ボタンを選択します。
3. これで、コネクションのページにリダイレクトされます。
4. [独自の OAuth 2.0 アプリ (BYOA) を使用する] を選択します
5. [クライアント ID]、[クライアント シークレット] を入力し、[ 接続] を選択します。

注:

OAuth 2.0 アプリのコネクションでは、認証トークンは暗号化されて保存されますが、クライアント データへのアクセスには使用されません。

ソリューション内の接続

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

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

注:

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

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

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

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

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

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

注:

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

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

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

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

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

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

注:

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

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

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