フェデレーション ID 資格情報を管理する

組織管理者は、OAuth 外部アプリケーションのフェデレーション資格情報を登録、表示、更新、および削除できます。

前提条件

• 組織管理者である。
• OAuth 外部アプリケーションがすでに登録されている。OAuth 外部アプリケーションを登録するには、「外部の OAuth アプリケーションを管理する」をご覧ください。

フェデレーション資格情報の登録

フェデレーション資格情報を既存の OAuth 外部アプリケーションに追加するには、フェデレーション資格情報の作成 API を使用します。

注:

各アプリケーションは、最大で 20 個のフェデレーション資格情報をサポートします。

既存の認証情報を表示する

アプリケーションに対して登録されているフェデレーション資格情報を取得するには、フェデレーション資格情報のリストの取得 API を使用します。

フェデレーション資格情報を更新する

フェデレーション資格情報を更新するには、 Update a federated credential API を使用します。

フェデレーション資格情報を削除する

警告:

削除は永続的です。削除されると、その資格情報を使用して新しいアクセス トークンを取得することはできなくなります。削除前に発行済みだったアクセス トークンは、有効期限が切れるまで有効です。

フェデレーション資格情報を削除するには、フェデレーション資格情報の削除 API を使用します。

フェデレーション資格情報を使用してアクセス トークンを取得する

フェデレーション資格情報の登録後、アプリケーションは、設定された ID プロバイダーから JWT を client_assertionとして提示することによって、UiPath アクセス トークンを取得します。

{accessURL} をクラウド プラットフォームのベース URL に置き換えます。

Cloud Platform	アクセス URL
Automation Cloud	https://cloud.uipath.com
Test Cloud (公共部門向け)	https://govcloud.uipath.us
Automation Cloud (専有型)	https://{customURL}.dedicated.uipath.com

curl --location '{accessURL}/identity_/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={CLIENT_ID}' \
--data-urlencode 'client_assertion={JWT_TOKEN}' \
--data-urlencode 'client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer'

パラメーター	説明
grant_type	client_credentialsする必要があります。
client_id	登録済みの OAuth 外部アプリケーションのクライアント ID。
client_assertion	外部 ID プロバイダーによって発行された JWT です。
client_assertion_type	urn:ietf:params:oauth:client-assertion-type:jwt-bearerする必要があります。

成功すると、エンドポイントは UiPath API の呼び出しに使用できる UiPath アクセス トークンを返します。

フェデレーション資格情報をプログラムによって管理するための完全な API リファレンスについては、「外部クライアント - フェデレーション資格情報 API」をご覧ください。