Orchestrator ユーザーガイド

デリバリー:

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

カスタムマッピング

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

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

これに関連して、Identity Server の [外部プロバイダー] ページで [SAML2] に以下のパラメーターを設定する必要があります (Identity Server へのアクセス方法については「ホスト ID 管理ハブ」をご覧ください)。

外部ユーザーのマッピング方法 - マッピング方法を定義します。次のオプションが利用可能です。
- 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')