Skip to content

SCIM configuration#

Relevant configuration properties of the Jans SCIM server are summarized in the table below:

Property Default value Description
maxCount 200 Maximum number of results per page in search endpoints
bulkMaxOperations 30 Maximum number of operations admitted in a single bulk request
bulkMaxPayloadSize 3072000 Maximum payload size in bytes admitted in a single bulk request
userExtensionSchemaURI urn:ietf:params:scim:schemas:extension:gluu:2.0:User URI schema associated to the User Extension
skipDefinedPasswordValidation false Whether the validation rules defined for the password attribute in the server should be bypassed when a user is created/updated
loggingLevel INFO The logging level

Configuration management using CLI#

To retrieve the current server configuration run the command

python3 jans cli --operation-id get-scim-config

To modify some aspect of the retrieved configuration prepare a PATCH request in JSON format. For instance:

PATCH
[
{ 
  "op":"replace",
  "path": "bulkMaxOperations",
  "value": 100
},
{ 
  "op":"replace",
  "path": "loggingLevel",
  "value": "DEBUG"
}
]

These contents should be then passed to the patch-scim-config operation, e.g.

python3 jans cli --operation-id patch-scim-config --data <path-to-JSON-file>

Configuration management using TUI#

To retrieve the current server configuration using TUI proceed as below:

  1. Launch TUI, e.g. by running jans tui, and follow the prompts
  2. Highlight the SCIM tab using your keyboard's left/right arrow key
  3. Highlight the "Get Scim Configuration" button using the tab key
  4. Press enter

You can modify the configuration in place by editing the fields of your interest. To persist the changes, highlight the "Save" button at the bottom and press enter.

SCIM Operations Guide using CLI, TUI and API#

SCIM operations support mutiple options. Please check out this documentation for guidelines of scim operations.

When will changes take effect?#

Any configuration update will take effect one minute after it has been applied whether via CLI or TUI.


Last update: 2024-10-29
Created: 2022-07-21