User and Group metadata provisioning via SCIM

1 min read

Unique AI supports sending user and group metadata along with SCIM. To use this, a custom attribute mapping is required for the respective object.

General

The user or group metadata is a JSON object. In order to send this via SCIM we added an additional attribute which must contain a valid JSON stringed object. To create such a valid string, the use of an expression is needed. Here are some examples of an expression which is creating a valid stringified JSON object.

With dummy values

Target object

json
{
  "foo": "bar",
  "num": 5,
  "bool": true
}

Expression

Join("", "{", Join(",", "\"foo\": \"bar\"", "\"num\": 2", "\"bool\": true"), "}")

Result

'{"foo": "bar","num": 2,"bool": true}'

With a Microsoft Entra Attribute included

Target object

json
{
  "department": "IT",
  "country": "Switzerland"
}

Expression

Join("", "{", Join(",", Join("", "\"department\": \"", [department], "\""), Join("", "\"country\": \"", [country], "\"")), "}")

Result

'{"department": "IT","country": "Switzerland"}'

User

Adding customappsso attribute

  1. Navigate to User Attribute Mapping, check “Show advanced options” and click “Edit attribute list for custoomappsso”

Screenshot 2025-06-05 at 11.54.00.png

  1. Insert urn:ietf:params:scim:schemas:extension:uniqueai:2.0:User:userConfiguration as Name and String as Type and Save

Screenshot 2025-06-05 at 11.50.12.png

Defining customappsso attribute

  1. Back on the User Attribute Mapping click on “Add New Mapping“

Screenshot 2025-06-05 at 11.52.39.png

  1. Select “Expression”, insert “Expression”, select Target attribute urn:ietf:params:scim:schemas:extension:uniqueai:2.0:User:userConfiguration.

Screenshot 2025-06-05 at 11.56.48.png

  1. Click “Ok”, validate the attribute is now on the list and Save the whole Attribute Mapping

Screenshot 2025-06-05 at 11.57.50.png

Group

For the Group follow the instruction for the User. Take the Group Mapping instead the User and use this “customappsso Attribute” name: urn:ietf:params:scim:schemas:extension:uniqueai:2.0:Group:configuration

Last updated