カスタム属性の連携設定

概要¶

IDプロバイダ側に固有の情報（たとえば、役職など）を、「SCIM機能」を用いてプリザンターの拡張項目へ保存したい場合は、IDプロバイダの設定にカスタム属性マッピングを追加する必要があります。以下では、Microsoft Entra IDの「jobTitle」（役職）をプリザンターの「拡張項目」「Users_ClassB」へ連携する手順を例に説明します。

前提条件¶

1. 年間サポートサービスの下記プラン契約者限定の機能です。

   エントリー	ベーシック	ベーシックプラス	ビジネス	ビジネスプラス	アンリミテッド
   		〇	〇	〇	〇

2. 「分類」Bを「拡張項目」として追加してください。

操作手順¶

プリザンター側の設定¶

プリザンター側では、Scim.jsonのパラメータ「ExtendedAttributes」に、完全なSCIM属性名とプリザンターでの保存先となる「拡張項目」のカラム名を設定します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
    "Enabled": true,
    "SwaggerEnabled": false,
    "ExtendedAttributes": {
        "Users": [
            {
                "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:User",
                "Name": "jobTitle",
                "ColumnName": "Users_ClassB"
            }
        ],
        "Groups": []
    }
}

「Schema」と「Name」には、IDプロバイダ側で追加する完全なSCIM属性名を、以下のように分割して設定します。

IDプロバイダ側の設定¶

カスタム属性を追加する¶

Microsoft Entra ID側では、customappssoの属性リストにカスタム属性を追加します。

1. 「Microsoft Entra 管理センター」を開いてください。
2. 対象の「エンタープライズ アプリケーション」を開いてください。
3. 画面左側のメニューから「プロビジョニング」を開いてください。
4. 「マッピング」を開いてください。
5. 「Provision Microsoft Entra ID Users」を選択してください。
6. 画面下部の「詳細オプションの表示」をクリックしてオンにしてください。

7. 「customappsso の属性リストを編集します」をクリックしてください。

   

8. 属性リストの編集画面で、次の属性を追加します。

   項目	設定値
   名前	urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle
   型	String
   主キー	いいえ
   必須	いいえ

   

9. 追加後、属性リストを保存してください。

追加したカスタム属性へマッピングする¶

Microsoft Entra IDの属性を、追加したカスタム属性へマッピングします。

1. 「Provision Microsoft Entra ID Users」の属性マッピング画面を開いてください。
2. 「新しいマッピングの追加」を選択してください。

3. 以下のように設定してください。

   項目	設定値
   マッピングの種類	直接
   ソース属性	jobTitle
   ターゲット属性	urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle
   このマッピングを適用する	常時

   

4. 設定が済んだら、保存してください。

5. 属性マッピング画面全体も保存が必要です。

既定のマッピング設定を変更する¶

Microsoft Entra ID側の設定¶

Microsoft Entra IDの既定のマッピングに「jobTitle」などの属性が存在する場合は、新しいマッピングを追加する代わりに、既存の「ターゲット属性」を変更しても構いません。

プリザンターが使用しない「title」へのマッピングを、プリザンター用のカスタム属性へ置き換え¶

jobTitleだけをターゲット属性に指定しても、連携されません。Microsoft Entra ID側では、拡張スキーマを含めた完全なSCIM属性名を指定してください。

プリザンター側の設定¶

変更後のターゲット属性と、プリザンター側のScim.jsonの設定は、下表のように対応させてください。

対応バージョン¶

関連情報¶

• SCIM機能
• プリザンターの初期設定
• IDプロバイダの初期設定
• 拡張項目
• SCIMでユーザ情報が連携されない