Orchestrator ユーザーガイド

デリバリー:

最終更新日時 2025年4月9日

カスタムマッピング

ADFS、Google、および Okta は、いずれもメールアドレスを SAML 属性として使用します。このセクションでは、ユーザー名または外部プロバイダーのキーに基づくカスタム SAML マッピングについて説明します。

重要: カスタムマッピング属性を設定すると、システム全体に影響を与えることになります。この設定は、既存の ID プロバイダーのすべてに適用されます。その結果、新しいマッピングが設定されている間は、他のプロバイダー (Azure、Windows) は一切機能しなくなります。

The following parameters need to be configured in this regard in Identity Server's SAML2 settings within the External Providers page (refer to Host Identity Management hub to learn how to access Identity Server):

外部ユーザーのマッピング方法 - マッピング方法を定義します。次のオプションが利用可能です。
- By user email - メールアドレスが属性として設定されます。これは既定値です。
- By username - ユーザー名を属性として設定します。
- By external provider key - 外部のプロバイダーキーを属性として設定します。
外部ユーザー ID の要求名 - マッピングの ID として使用する要求を定義します。これは、ユーザー名を属性として設定する場合にのみ必要です。

Okta を使用したカスタムマッピング

次に、OKTA を使用した各マッピング方法の設定例を示します。

注: Identity Server 内の何らかの設定を変更して保存した後は、IIS サーバーを再起動してください。

ユーザーのメールアドレスによって

これは既定のマッピング方法です。ユーザーの識別は、メールアドレス要求を使用して行われます。

ユーザーのメールアドレスを使用するには、ホスト管理ポータルで SAML を次のように設定します ([ユーザー] > [認証設定] > [外部プロバイダー] > [SAML 2.0])。

[有効] チェックボックスをオンにします。
[外部ユーザーのマッピング方法] パラメーターを By user email に設定します。

ユーザー名によって

これによって、管理者はユーザー識別のための独自の要求を定義できます。

この例では、Okta でカスタムの要求を定義し、user.employeeNumber を ID として使用します。
関連する属性を定義します。
Orchestrator のユーザーアカウントが Okta で定義したユーザー名と同じであることを確認します。

ユーザー名を使用するには、ホスト管理ポータル ([ユーザー] > [認証設定] > [外部プロバイダー] > [SAML 2.0]) で SAML を次のように設定します。

[有効] チェックボックスをオンにします。
[外部ユーザーのマッピング方法] パラメーターを By username に設定します。
[外部ユーザー ID の要求名] パラメーターを作成済みの要求に設定します。この例では、auid-claim です。

外部プロバイダーキーによって

このオプションは、ユーザーが既に Orchestrator と Okta で定義されている場合に推奨されます。

Identity Server のユーザーデータベースにアクセスできる管理者は、次の SQL コマンドを実行する必要があります。

 INSERT INTO [identity].[AspNetUserLogins] (UserId,LoginProvider,ProviderKey)
VALUES (<userid>,'http://www.okta.com/exkh4xo7uoXgjukfS0h7','documentation@uipath.com')INSERT INTO [identity].[AspNetUserLogins] (UserId,LoginProvider,ProviderKey)
VALUES (<userid>,'http://www.okta.com/exkh4xo7uoXgjukfS0h7','documentation@uipath.com')