[](https://pleasanter.org/support/) ## 注意事項 1. パラメータ変更時は[パラメータ変更時の確認事項](/ja/manual/parameter-edit)をご確認ください。 ## 前提条件 1. Scim.jsonでは[SCIM機能](/ja/manual/scim)を使ったIDプロバイダ属性とプリザンターの項目とのマッピングルールを自由に設定できますが、一部のマッピングルールは実装上固定されています。以下の「[SCIM属性とプリザンター項目の固定マッピング](#fixed-mapping)」を参照してください。 1. [年間サポートサービス](https://pleasanter.org/support/)の下記プラン契約者限定の機能です。 | エントリー | ベーシック | ベーシックプラス | ビジネス | ビジネスプラス | アンリミテッド | | :---: | :---: | :------: | :--: | :-----: | :-----: | | | | 〇 | 〇 | 〇 | 〇 | ## 設置値 本パラメータファイルの設定値は以下の通りです。 | パラメータ名 | 設定例 | 説明 | | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Enabled | true | 「SCIM」によるユーザ情報及びグループ情報の連携を有効にするかどうかを指定します。<br>本パラメータの設定はプリザンター全体に影響します。<br>テナントごとの連携可否は、テナント管理画面で発行するSCIMトークンで管理してください。 | | SwaggerEnabled | false | SCIM機能の動作確認や、アプリ開発時の確認に使う画面を表示するかどうかを指定します。<br>一般ユーザが日常的に使う画面ではありません。<br>本番環境では、必要がない場合、falseに設定してください。 | | ExtendedAttributes | 下記参照 | SCIMの属性を、ユーザ管理画面またはグループ管理画面に追加した[拡張項目](/ja/manual/extended-column)に保存するための設定です。<br>詳細は以下の「ExtendedAttributes」を参照してください。 | ## 設定例 ```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": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group", "Name": "groupType", "ColumnName": "Groups_ClassA" } ] } } ``` ## ExtendedAttributes ExtendedAttributesは、IDプロバイダ側の「属性」を、プリザンターの[ユーザ管理](/ja/manual/user)画面または「グループ管理」画面に追加した[拡張項目](/ja/manual/extended-column)に紐づけるための設定です。  ### ExtendedAttributes.Users [ユーザ管理](/ja/manual/user)画面に配置した[分類](/ja/manual/table-management-class)項目、[説明](/ja/manual/table-management-column-description)項目に対して、IDプロバイダの属性を紐づけます。 ```json "Users": [ { "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:User", "Name": "jobTitle", "ColumnName": "Users_ClassB" }, { "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:User", "Name": "officeLocation", "ColumnName": "Users_DescriptionA" } ] ``` この例では、以下のように保存されます。 | SCIM属性名 | プリザンター保存先 | | :------------- | :----------------- | | jobTitle（役職） | Users_ClassB | | officeLocation（勤務先所在地） | Users_DescriptionA | Entra ID側の属性マッピングでは、以下のようにスキーマを含めた完全なSCIM属性名を指定してください。 | プリザンター保存先 | Entra ID側で指定するSCIM属性 | | :----------------- | :-------------------------------------------------------------------------- | | Users_ClassB | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle | | Users_DescriptionA | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:officeLocation | ### ExtendedAttributes.Groups 「グループ管理」画面に配置した[分類](/ja/manual/table-management-class)項目、[説明](/ja/manual/table-management-column-description)項目に対して、IDプロバイダの属性を紐づけます。 ```json "Groups": [ { "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group", "Name": "groupType", "ColumnName": "Groups_ClassA" }, { "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group", "Name": "groupNote", "ColumnName": "Groups_DescriptionA" } ] ``` この例では、以下のように保存されます。 | SCIM属性名 | プリザンター保存先 | | :-------- | :------------------ | | groupType | Groups_ClassA | | groupNote | Groups_DescriptionA | Entra ID側の属性マッピングでは、以下のようにスキーマを含めた完全なSCIM属性名を指定します。 | プリザンター保存先 | Entra ID側で指定する完全なSCIM属性名（ターゲット属性） | | :------------------ | :---------------------------------------------------------------------- | | Groups_ClassA | urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group:groupType | | Groups_DescriptionA | urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group:groupNote | ### ExtendedAttributes.Userss、ExtendedAttributes.Groups配下のパラメータ ExtendedAttributes.UsersとExtendedAttributes.Groupsでは、以下のパラメータを設定します。 | 項目 | 内容 | | :--------- | :----------------------------- | | Schema | SCIMの拡張スキーマ | | Name | SCIM側の属性名 | | ColumnName | プリザンター側の保存先カラム名 | #### Schema SCIMの拡張スキーマを設定します。 1. パラメータSchemaの設定を省略するか、またはnullを設定した場合は、以下の既定値が使用されます。 | 拡張項目の種別 | SCIMの拡張スキーマ | | :--------------- | :------------------------------------------------------------ | | ユーザ拡張項目 | urn:pleasanter:params:scim:schemas:extension:custom:2.0:User | | グループ拡張項目 | urn:pleasanter:params:scim:schemas:extension:custom:2.0:Group | 1. IDプロバイダ側の属性マッピングでは、スキーマを含む完全なSCIM属性名を設定する必要があります。 #### Name IDプロバイダ側の「属性マッピング」で使う属性名の末尾文字列を指定します。 ##### IDプロバイダ側のSCIM属性名 ```text urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle ``` ##### Scim.jsonのNameの設定例 ```json "Name": "jobTitle" ``` #### ColumnName プリザンター側で保存先とする[拡張項目](/ja/manual/extended-column)のカラム名を指定します。 1. [ユーザ管理](/ja/manual/user)画面に追加した[拡張項目](/ja/manual/extended-column)に保存する場合は、接頭辞Users_を添えた[拡張項目](/ja/manual/extended-column)のカラム名を指定します。 1. 「グループ管理」画面に追加した[拡張項目](/ja/manual/extended-column)に保存する場合は、接頭辞Groups_を添えた[拡張項目](/ja/manual/extended-column)のカラム名を指定します。 ```json "ColumnName": "Users_ClassB" ``` ### 指定できるプリザンター側の項目 SCIMの拡張属性の保存先として利用できるのは、[拡張項目](/ja/manual/extended-column)として[ユーザ管理](/ja/manual/user)画面または「グループ管理」画面に配置した、[分類](/ja/manual/table-management-class)項目または[説明](/ja/manual/table-management-column-description)項目です。 実際に画面上で表示する場合は、別途CustomDefinitions\Column.jsonで表示名などを設定します。 ### 拡張項目の表示名を設定する場合 プリザンターの画面上で拡張項目を表示したい場合は、CustomDefinitions\Column.jsonを設定してください。 対象フォルダ: ```text Implem.PURIZANNTA- \App_Data\Parameters\CustomDefinitions ``` ファイル名: ```text Column.json ``` 設定例: ```json { "Users_ClassB": { "LabelText": "役職", "GridEnabled": "1", "EditorEnabled": "1" }, "Groups_ClassA": { "LabelText": "グループ種別", "GridEnabled": "1", "EditorEnabled": "1" } } ``` この例では、以下のように表示されます。 | 列名 | 画面上の表示名 | | :------------ | :------------- | | Users_ClassB | 役職 | | Groups_ClassA | グループ種別 | ### Microsoft Entra ID側で指定する属性名 Microsoft Entra IDの属性マッピングでは、プリザンター側のNameだけではなく、スキーマを含めた完全な属性名を指定します。 例として、「Scim.json」に以下を設定した場合: ```json { "Schema": "urn:pleasanter:params:scim:schemas:extension:custom:2.0:User", "Name": "jobTitle", "ColumnName": "Users_ClassB" } ``` Microsoft Entra ID側では、customappsso属性に次の値を指定します。 ```text urn:pleasanter:params:scim:schemas:extension:custom:2.0:User:jobTitle ``` jobTitleだけを指定しても、期待した形で連携されない可能性があります。 Entra ID側では、必ず完全な属性名を指定してください。 ## SCIM属性とプリザンター項目の固定マッピング 以下のマッピングは実装上固定されています。Scim.jsonで変更することはできません。 ### ユーザ | IDプロバイダから送信されるSCIM属性 | プリザンター側の保存先 | 補足 | | --- | --- | --- | | externalId | Users.ScimExternalId | IDプロバイダ側のオブジェクトIDを保存します。ユーザ作成時は必須です。 | | userName | Users.LoginId | ログインIDとして保存します。 | | displayName | Users.Name | 表示名として保存します。 | | name.formatted | Users.Name | displayNameがない場合に使用します。Users.FirstAndLastNameOrderには保存しません。 | | name.givenName | Users.FirstName | 名として保存します。 | | name.familyName | Users.LastName | 姓として保存します。 | | emails[].value | MailAddresses.MailAddress | ユーザに紐づくメールアドレスとして保存します。重複する値は除外します。 | | active | Users.Disabled | active=trueの場合は「無効」をオフに、active=falseの場合は「無効」をオンとして保存します。 | | preferredLanguage | Users.Language | プリザンターが対応している言語コードへ変換して保存します。 | | locale | Users.Language | preferredLanguageがない場合に使用します。 | | timezone | Users.TimeZone | タイムゾーンとして保存します。 | | Enterprise User拡張のdepartment | Users.DeptId | 受信した値をDeptCodeとして組織を検索します。存在しない場合は組織を作成し、そのDeptIdをユーザに設定します。 | | Enterprise User拡張のemployeeNumber | Users.UserCode | 社員番号などをユーザコードとして保存します。 | | Enterprise User拡張のmanager.value | Users.Manager | 上司のSCIM IDからプリザンターのユーザを検索し、そのユーザIDを設定します。 | ユーザの表示名は、次の優先順位で決定します。 1. displayName 2. name.formatted 3. name.givenNameとname.familyNameを連結した値 4. userName ### グループ | IDプロバイダから送信されるSCIM属性 | プリザンター側の保存先 | 補足 | | --- | --- | --- | | externalId | Groups.ScimExternalId | IDプロバイダ側のオブジェクトIDを保存します。グループ作成時は必須です。 | | displayName | Groups.GroupName | グループ名として保存します。 | | members[].value（User） | GroupMembers.UserId | SCIMユーザのIDからプリザンターのユーザを検索し、直接メンバーとして登録します。 | | members[].value（Group） | GroupChildren.ChildId | SCIMグループのIDからプリザンターのグループを検索し、子グループとして登録します。 | ## 対応バージョン | 対応バージョン | 内容 | | -------------- | --------------- | | 1.5.8.0 以降 | Scim.jsonを追加 | ## 関連情報 <div id="ManualList"><ul><li><a href="/ja/manual/parameter-edit">パラメータ設定：パラメータ変更時の確認事項</a><span>2026/08/14 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/table-management-column-description">テーブルの管理：エディタ：項目の詳細設定：説明</a><span>2023/04/25 up</span></li></ul></article> <ul><li><a href="/ja/manual/user">ユーザ管理機能</a><span>2026/03/22 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="" />