外部アプリケーションを管理する

Registered external applications can access your UiPath resources for the current tenant over API, using the OAuth 2.0 flow.

注:

このページで説明している作業を実行するには、テナントの管理者である必要があります。

外部アプリケーションを追加する

外部アプリケーションを登録し、そのアプリケーションが OAuth を使用して UiPath リソースにアクセスできるようにするには、以下の手順を実行します。

1. テナントに管理者としてログインします。

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. Along the left, select External Applications. The External Applications page opens, listing all the existing external applications registered for the current tenant:

   

4. 表の上で、右側にある [アプリケーションを追加] をクリックします。

5. [アプリケーション名] フィールドに入力します。

6. [アプリケーションの種類] のオプションを選択します。

   [機密アプリケーション] を選択した場合、最後にアプリケーション シークレットが提供されるので、使用しているアプリケーションでそのシークレットを安全に保存できることを確認してください。シークレットを保存できない場合は [非機密アプリケーション] を選択します。

7. Under Resources, click Add Scopes. The Edit Resource panel opens on the right, where you can select the resources to which the application should have access.

8. [リソース] ドロップダウン リストから、アプリケーションが使用できる UiPath API を選択します。

   注:

   スコープは一度に 1 つのリソースに対してのみ追加できます。複数のリソースへのアクセスを許可するには、このプロセスを繰り返して各リソースにスコープを追加します。

9. [ユーザー スコープ] タブで、必要に応じて、付与する論理 API 権限のチェック ボックスを選択します。

   ユーザー スコープに基づく権限付与とは、外部アプリケーションがそれらのリソースにユーザー コンテキスト内でアクセス可能であり、適切な権限を持つユーザーがログインする必要があることを意味します。

10. 機密アプリケーションの場合は、[アプリケーション スコープ] タブに切り替え、必要に応じて、選択したリソースに対するアプリケーション レベルでの権限も付与できます。

    アプリケーション スコープに基づく権限を持つ外部アプリケーションは、ユーザーの操作なしで、選択したスコープのすべてのアプリケーションのデータにアクセスできます。

    非機密アプリケーションは、アプリケーション スコープにアクセスできません。

11. Click Save. The panel closes and the selected resource and scopes are added to the Resources table in the form.

12. 外部アプリケーションが対応している場合、[リダイレクト URL] フィールドに URL を追加すると、認可応答がその URL に送信され、アプリケーションがその URL を使用して UiPath リソースにアクセスできるようになります。

13. [追加] をクリックして登録を作成します。

    確認メッセージが表示されます。機密アプリケーションの場合、確認メッセージには登録済み外部アプリケーションが認可を要求するときに使用できるアプリケーション シークレットが含まれます。アプリケーション シークレットは、その後はもう表示されることがないので、必ず安全な場所に保存しておいてください。

既存アプリケーションのスコープを変更する

スコープとは、UiPath リソースに関連する外部アプリケーションの権限です。

1. テナントに管理者としてログインします。

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. 左側の [外部アプリケーション] を選択します。

   The External Applications page opens, listing all the existing external applications registered for the current tenant.

4. アプリケーションの行の右にある [編集] をクリックします。

5. アプリケーションがアクセス権を持つスコープを変更します。

   • 既存のスコープを編集したり、リソースを削除したりするには、リソース行の右のアイコンを使用します。
   • 新たなリソースを追加してそのスコープを選択するには、[スコープを追加] をクリックします。

6. [保存] をクリックします。

新しいアプリケーション シークレットを作成する

機密外部アプリケーションに対して生成されたアプリケーション シークレットが不明な場合、復元することはできません。ただし、新たに作成することは可能です。

注:

新しいアプリケーション シークレットを作成したら、外部アプリケーションとの連携を管理する開発者に必ず知らせてください。開発者は認証メカニズムを更新する必要があります。そうしないと、既存の連携が機能しなくなります。

新しいアプリケーション シークレットを生成するには、以下の手順を実行します。

1. テナントに管理者としてログインします。

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. Along the left, select External Applications. The External Applications page opens, listing all the existing external applications registered for the current tenant.

4. アプリケーションの行の右にある をクリックします。

5. [アプリ シークレット] の [新しく生成] をクリックします。

   新しいアプリケーション シークレットが生成され、ボタンの上に表示されます。[キャンセル] をクリックしてページを閉じるまで表示されます。

6. アプリケーション シークレットをコピーして安全な場所に保存してください。

開発者に詳細情報を提供する

外部アプリケーションの登録後は、開発者による外部アプリケーションの設定も必要になります。それにより、外部アプリケーションが正しく認証され、UiPath Identity Server に認可を要求して、許可された UiPath リソースにアクセスできるようになります。

Instructions for the developers maintaining the integration with the external application are available in Accessing UiPath Resources Using External Applications.

開発者がそれらの作業を実行するには、以下の情報を開発者に提供する必要があります。

• アプリケーションの種類とアプリケーション ID。いずれも [外部アプリケーション] ページで確認できます。

• 各種類のスコープに追加されたスコープ。リソースの中には、ユーザーとアプリケーションの両方のスコープに同じ名前を使用しているものがあるため、種類も重要です。

• 機密アプリケーションの場合、外部アプリケーションの登録時に生成されたアプリケーション シークレット。

  注:

  If you don't have the secret anymore, generate a new one, as described above on this page.