SCIM schema discovery

Last modified 04 May 2026 13:29 +02:00

The SCIM 2.0 framework automatically discovers schemas from the server using the SCIM protocol’s schema endpoint.

This document is part of the SCIM 2.0 connector tutorial. See Introduction to SCIMREST framework for other topics.

Automatic schema discovery

When a SCIM connector is configured, the framework:

  1. Connects to the SCIM server

  2. Retrieves available resource types via the /ResourceType endpoint

  3. Fetches schema definitions via the /Schema endpoint

  4. Maps SCIM resources to ConnId object classes

The discovered schema includes:

  • All SCIM resources (e.g., User, Group)

  • All attributes with their types, mutability, and returned ByDefault status

  • Schema extensions

SCIM to ConnId object class mapping

The mapping is based on the SCIM resource name. You can override this in the schema.

The ConnID attributes UID and NAME are mapped to id for custom resources, unless otherwise customized by scripts.

Schema customization

After discovery, you can customize the schema:

  • Rename object classes

  • Add ConnId attribute mappings (UID, NAME)

  • Define SCIM path mappings for complex attributes

  • Add schema extensions

See SCIM Schema customization for details.

Was this page helpful?
YES NO
Thanks for your feedback