Join our Newsletter — 33% off our NHI Course

Custom SCIM schemas for authorization context: what teams need

 

(@nhi-mgmt-group)
Member Moderator
Joined: 1 year ago
Posts: 19129
Topic starter  

TL;DR: SCIM can provision and deactivate users cleanly, but it does not natively carry the authorization context enterprises often need, so vendors use custom schema extensions to pass org, team, and role data alongside identity, according to WorkOS. The governance lesson is that provisioning and authorization must be designed together, or access arrives incomplete and inconsistent.

Editorial analysis by NHI Mgmt Group, based on content published by WorkOS: “Custom SCIM schemas: Where identity provisioning meets authorization”.

Key questions

Q: What breaks when SCIM provisions users without authorization context?

A: The account may be created successfully, but the application still cannot determine the correct workspace, team, or role.

Q: When should teams prioritise custom SCIM attributes over group-based access mapping?

A: Use custom attributes when authorization depends on structured fields such as workspace, team, org, or a role that is not reliably represented by group membership alone.

Q: What do teams get wrong when implementing user updates through SCIM?

A: A common mistake is assuming update requests will always contain a complete user profile.

Practitioner guidance

  • Define authorization primitives before building SCIM mappings List the exact access attributes your application uses, such as workspace, team, org, or role, and map only those fields into the SCIM contract.
  • Use a stable custom URN for your extension Publish a namespace under your application and keep it separate from the enterprise extension URN.
  • Specify missing-versus-remove semantics in the spec Document whether a missing attribute clears access, leaves the prior value in place, or falls back to a default, and make that behavior consistent across PATCH and PUT handling.

Bottom line: SCIM solves user sync, but it does not automatically solve authorization context.

Explore further

View Full Forum →  |  NHI Foundation Course →  |  Our Services →  |  Read the full analysis →



   
Quote
(@mr-nhi)
Member Moderator
Joined: 6 months ago
Posts: 18837
 

Provisioning without authorization context creates incomplete identity state: SCIM is often treated as if account creation equals usable access, but that assumption fails when the application needs workspace, team, or role context to make the account meaningful. The identity exists, yet the authorization decision remains unresolved. Practitioners should treat provisioning and authorization as a single design problem, not two separate integrations.

A question worth separating out:

Q: How should IAM teams govern missing attributes in directory sync?

A: They should decide in advance whether a missing field means revoke, retain, or default, and then apply that rule consistently. If the meaning changes by endpoint or by developer interpretation, lifecycle governance becomes unpredictable and customers cannot build reliable IdP mappings around it.

👉 Read our full editorial: Custom SCIM schemas: where provisioning meets authorization



   
ReplyQuote
Share:

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.