Added SCIM1.1 claim mapping instructions for 7.2.0

[manojasomarathna]

Purpose

Fixes the SCIM1.1 claim mapping instructions in the 7.2.0 documentation, adding clear steps to map external claims to local claims. Resolves #1920.

Related PRs

N/A

Test environment

Tested by manually verifying the documentation structure in local Markdown preview.

Security checks

• Followed secure coding standards in http://wso2.com/technical-reports/wso2-secure-engineering-guidelines
• Ran FindSecurityBugs plugin and verified report
• Confirmed that this PR doesn't commit any keys, passwords, tokens, usernames, or other secrets

Summary by CodeRabbit

• Documentation
  • Added a new guide for configuring extensible SCIM user schemas in the Identity Server.
  • Includes a clear, four-step walkthrough for SCIM 1.1 claim mapping: sign-in, navigating to Add External Claim, entering Dialect URI, External Claim URI and Mapped Local Claim, and saving the mapping.

[coderabbitai]

Warning

Rate limit exceeded

@manojasomarathna has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 2 minutes and 6 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

Adds a new documentation page that provides step-by-step instructions for configuring extensible SCIM user schemas using SCIM 1.1 claim mappings in WSO2 Identity Server.

Changes

Cohort / File(s)	Summary
Documentation en/identity-server/7.2.0/docs/develop/extensible-scim-user-schemas-with-wso2-identity-server.md	New markdown file added with a procedural guide for SCIM 1.1 claim mapping: steps to log in, navigate to Add External Claim, and populate Dialect URI, External Claim URI, and Mapped Local Claim. Provides a four-step example mapping.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 I hopped through docs to lend a paw,
Mapped claims with care and not a flaw,
Dialects, URIs, and local names in tune,
A little rabbit cheer beneath the moon. ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely summarizes the main change: adding SCIM 1.1 claim mapping instructions for version 7.2.0.
Description check	✅ Passed	The description includes all required sections from the template: Purpose with issue reference, Related PRs, Test environment, and Security checks.
Linked Issues check	✅ Passed	The PR fulfills issue #1920 requirements by adding step-by-step SCIM 1.1 claim mapping instructions with example values for Dialect URI, External Claim URI, and Mapped Local Claim.
Out of Scope Changes check	✅ Passed	All changes are in-scope; the PR only adds documentation file addressing SCIM 1.1 claim mapping as specified in issue #1920.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In
`@en/identity-server/7.2.0/docs/develop/extensible-scim-user-schemas-with-wso2-identity-server.md`:
- Around line 1-34: Remove the literal backslashes that escape markdown
characters so the document renders correctly: replace occurrences like "\#",
"\*\*", and "\-" with their unescaped equivalents ("#", "**", "-") throughout
the file (e.g., the headings "Extensible SCIM User Schemas with WSO2 Identity
Server" and "SCIM1.1 Claim Mapping Instructions", bold segments such as "**Main
Menu → Claims → Add → Add External Claim**", and list items like "- **Dialect
URI:** ...") ensuring all markdown headers, bold/italic markers, and list
bullets are unescaped and valid Markdown syntax.

🧹 Nitpick comments (1)

en/identity-server/7.2.0/docs/develop/extensible-scim-user-schemas-with-wso2-identity-server.md (1)

3-4: Reduce excessive blank lines.

The file contains multiple consecutive blank lines between sections and within the procedural steps. Standard markdown practice uses a single blank line to separate sections and no blank lines between list items. This improves readability and follows typical documentation conventions.

♻️ Proposed fix for whitespace

 # Extensible SCIM User Schemas with WSO2 Identity Server
-

-

 ## SCIM1.1 Claim Mapping Instructions
-

-

 To map an external claim to a local claim in WSO2 IS:
-

-

 1. Log into the Identity Server.
-
 2. Navigate to **Main Menu → Claims → Add → Add External Claim**.
-
 3. Fill the form:
-

-

    - **Dialect URI:** urn:scim:schemas:core:1.0
-
    - **External Claim URI:** urn:scim:schemas:extension:wso2:1.0:wso2Extension.department
-
    - **Mapped Local Claim:** http://wso2.org/claims/department
-

-

 4. Save the mapping.
-

-

-

Also applies to: 7-8, 11-12, 19-20, 27-28, 31-34

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Critical: Fix escaped markdown syntax throughout the file.

The markdown syntax is incorrectly escaped with backslashes, which will prevent proper rendering. Headers should use # not \#, bold text should use **text** not \*\*text\*\*, and list items should use - not \-.

🐛 Proposed fix for markdown syntax

-\# Extensible SCIM User Schemas with WSO2 Identity Server
+# Extensible SCIM User Schemas with WSO2 Identity Server



-\## SCIM1.1 Claim Mapping Instructions
+## SCIM1.1 Claim Mapping Instructions



To map an external claim to a local claim in WSO2 IS:



-1\. Log into the Identity Server.
+1. Log into the Identity Server.

-2\. Navigate to \*\*Main Menu → Claims → Add → Add External Claim\*\*.
+2. Navigate to **Main Menu → Claims → Add → Add External Claim**.

-3\. Fill the form:
+3. Fill the form:



-\- \*\*Dialect URI:\*\* urn:scim:schemas:core:1.0
+   - **Dialect URI:** urn:scim:schemas:core:1.0

-\- \*\*External Claim URI:\*\* urn:scim:schemas:extension:wso2:1.0:wso2Extension.department
+   - **External Claim URI:** urn:scim:schemas:extension:wso2:1.0:wso2Extension.department

-\- \*\*Mapped Local Claim:\*\* http://wso2.org/claims/department
+   - **Mapped Local Claim:** http://wso2.org/claims/department



-4\. Save the mapping.
+4. Save the mapping.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	\# Extensible SCIM User Schemas with WSO2 Identity Server
	\## SCIM1.1 Claim Mapping Instructions
	To map an external claim to a local claim in WSO2 IS:
	1\. Log into the Identity Server.
	2\. Navigate to \*\*Main Menu → Claims → Add → Add External Claim\*\*.
	3\. Fill the form:
	\- \*\*Dialect URI:\*\* urn:scim:schemas:core:1.0
	\- \*\*External Claim URI:\*\* urn:scim:schemas:extension:wso2:1.0:wso2Extension.department
	\- \*\*Mapped Local Claim:\*\* http://wso2.org/claims/department
	4\. Save the mapping.
	# Extensible SCIM User Schemas with WSO2 Identity Server
	## SCIM1.1 Claim Mapping Instructions
	To map an external claim to a local claim in WSO2 IS:
	1. Log into the Identity Server.
	2. Navigate to **Main Menu → Claims → Add → Add External Claim**.
	3. Fill the form:
	- **Dialect URI:** urn:scim:schemas:core:1.0
	- **External Claim URI:** urn:scim:schemas:extension:wso2:1.0:wso2Extension.department
	- **Mapped Local Claim:** http://wso2.org/claims/department
	4. Save the mapping.

🤖 Prompt for AI Agents

In
`@en/identity-server/7.2.0/docs/develop/extensible-scim-user-schemas-with-wso2-identity-server.md`
around lines 1 - 34, Remove the literal backslashes that escape markdown
characters so the document renders correctly: replace occurrences like "\#",
"\*\*", and "\-" with their unescaped equivalents ("#", "**", "-") throughout
the file (e.g., the headings "Extensible SCIM User Schemas with WSO2 Identity
Server" and "SCIM1.1 Claim Mapping Instructions", bold segments such as "**Main
Menu → Claims → Add → Add External Claim**", and list items like "- **Dialect
URI:** ...") ensuring all markdown headers, bold/italic markers, and list
bullets are unescaped and valid Markdown syntax.

[manojasomarathna]

Hi team,
Could someone please review this PR when you have time?
Thank you.