SCIM機能:カスタム属性の連携設定
[](https://pleasanter.org/support/)
## 概要
IDプロバイダ側に固有の情報(たとえば、役職など)を、[SCIM機能](/ja/manual/scim)を用いてプリザンターの拡張項目へ保存したい場合は、IDプロバイダの設定にカスタム属性マッピングを追加する必要があります。以下では、Microsoft Entra IDの「jobTitle」(役職)をプリザンターの[拡張項目](/ja/manual/extended-column)「Users_ClassB」へ連携する手順を例に説明します。
## 前提条件
1. [年間サポートサービス](https://pleasanter.org/support/)の下記プラン契約者限定の機能です。
| エントリー | ベーシック | ベーシックプラス | ビジネス | ビジネスプラス | アンリミテッド |
| :---: | :---: | :------: | :--: | :-----: | :-----: |
| | | 〇 | 〇 | 〇 | 〇 |
1. [分類](/ja/manual/table-management-class)Bを[拡張項目](/ja/manual/extended-column)として追加してください。
## 操作手順
### プリザンター側の設定
プリザンター側では、[Scim.json](/ja/manual/scim-json)のパラメータ「ExtendedAttributes」に、完全なSCIM属性名とプリザンターでの保存先となる[拡張項目](/ja/manual/extended-column)のカラム名を設定します。
##### Scim.jsonの設定例
```json
{
"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属性名を、以下のように分割して設定します。

|設定項目|値|
|:--|:--|
|Schema|urn:pleasanter:params:scim:schemas:extension:custom:2.0:User|
|Name|jobTitle|
|ColumnName|Users_ClassB|
### IDプロバイダ側の設定
#### カスタム属性を追加する
Microsoft Entra ID側では、customappssoの属性リストにカスタム属性を追加します。
1. 「Microsoft Entra 管理センター」を開いてください。
1. 対象の「エンタープライズ アプリケーション」を開いてください。
1. 画面左側のメニューから「プロビジョニング」を開いてください。
1. 「マッピング」を開いてください。
1. 「Provision Microsoft Entra ID Users」を選択してください。
1. 画面下部の「詳細オプションの表示」をクリックしてオンにしてください。
1. 「customappsso の属性リストを編集します」をクリックしてください。

1. 属性リストの編集画面で、次の属性を追加します。
| 項目 | 設定値 |
| :----- | :---------------------------------------------------------------------- |
| 名前 | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle |
| 型 | String |
| 主キー | いいえ |
| 必須 | いいえ |

1. 追加後、属性リストを保存してください。
### 追加したカスタム属性へマッピングする
Microsoft Entra IDの属性を、追加したカスタム属性へマッピングします。
1. 「Provision Microsoft Entra ID Users」の属性マッピング画面を開いてください。
2. 「新しいマッピングの追加」を選択してください。
3. 以下のように設定してください。
| 項目 | 設定値 |
| :----------------------- | :---------------------------------------------------------------------- |
| マッピングの種類 | 直接 |
| ソース属性 | jobTitle |
| ターゲット属性 | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle |
| このマッピングを適用する | 常時 |

1. 設定が済んだら、保存してください。
1. 属性マッピング画面全体も保存が必要です。
### 既定のマッピング設定を変更する
#### Microsoft Entra ID側の設定
Microsoft Entra IDの既定のマッピングに「jobTitle」などの属性が存在する場合は、新しいマッピングを追加する代わりに、既存の「ターゲット属性」を変更しても構いません。
##### プリザンターが使用しない「title」へのマッピングを、プリザンター用のカスタム属性へ置き換え
| ソース属性 | 変更前のターゲット属性 | 変更後のターゲット属性 |
| :--------- | :--------------------- | :---------------------------------------------------------------------- |
| jobTitle | title | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle |
jobTitleだけをターゲット属性に指定しても、連携されません。Microsoft Entra ID側では、拡張スキーマを含めた完全なSCIM属性名を指定してください。
#### プリザンター側の設定
変更後のターゲット属性と、プリザンター側の[Scim.json](/ja/manual/scim-json)の設定は、下表のように対応させてください。
| 項目 | 値 |
| :-------------------------- | :---------------------------------------------------------------------- |
| 変更後のターゲット属性 | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle |
| Schema | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User |
| Name | jobTitle |
| ColumnName | Users_ClassB |
## 対応バージョン
|対応バージョン|内容|
|---|---|
|1.5.8.0 以降| 機能追加|
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/scim-json">パラメータ設定:Scim.json</a><span>2026/09/08 up</span></li></ul></article>
<ul><li><a href="/ja/manual/scim">SCIM機能</a><span>2026/09/08 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-class">テーブルの管理:項目:分類</a><span>2025/12/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/extended-column">開発者向け機能:拡張機能:拡張項目</a><span>2025/03/06 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />



