Skip to content

Commit

Permalink
comments addressed
Browse files Browse the repository at this point in the history
  • Loading branch information
KaveeshaPiumini committed Dec 4, 2024
1 parent ca69c44 commit f6909b7
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 22 deletions.
2 changes: 1 addition & 1 deletion en/identity-server/7.0.0/docs/apis/scim2/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ The SCIM2 Rest APIs of {{product_name}} implements the SCIM 2.0 protocol accordi

- [SCIM 2.0 Users API]({{base_path}}/apis/scim2/scim2-users-rest-api/)
- [SCIM 2.0 Groups API]({{base_path}}/apis/scim2/scim2-groups-rest-api/)
- [SCIM 2.0 Build User Creation Payload]({{base_path}}/apis/scim2/build-scim2-user-creation-payload/)
- [SCIM 2.0 Patch operations]({{base_path}}/apis/scim2/scim2-patch-operations/)
- [SCIM 2.0 Bulk API]({{base_path}}/apis/scim2/scim2-bulk-rest-api/)
- [SCIM 2.0 Batch operations]({{base_path}}/apis/scim2/scim2-batch-operations/)
- [SCIM 2.0 Resource types API]({{base_path}}/apis/scim2/scim2-resource-types/)
- [SCIM 2.0 Service provider configuration API]({{base_path}}/apis/scim2/scim2-sp-config-rest-api/)
- [SCIM 2.0 Build User Creation Payload]({{base_path}}/apis/scim2/build-scim2-user-creation-payload/)
4 changes: 2 additions & 2 deletions en/identity-server/7.0.0/mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -321,11 +321,11 @@ plugins:
'guides/authentication/app-native-authentication/configure-advanced-app-native-settings.md': 'guides/authentication/app-native-authentication/index.md'
'apis/scim2-users-rest-apis.md': 'apis/scim2/scim2-users-rest-api.md'
'apis/scim2-groups-rest-apis.md': 'apis/scim2/scim2-groups-rest-api.md'
'apis/build-scim2-user-creation-payload.md': 'apis/scim2/build-scim2-user-creation-payload.md'
'apis/scim2-patch-operations.md': 'apis/scim2/scim2-patch-operations.md'
'apis/scim2-bulk-rest-apis.md': 'apis/scim2/scim2-bulk-rest-api.md'
'apis/scim2-batch-operations.md': 'apis/scim2/scim2-batch-operations.md'
'apis/scim2-sp-config-rest-apis.md': 'apis/scim2/scim2-sp-config-rest-api.md'
'apis/build-scim2-user-creation-payload.md': 'apis/scim2/build-scim2-user-creation-payload.md'
'apis/organization-apis/org-scim2-bulk-mgt.md': 'apis/organization-apis/scim2/scim2-org-bulk.md'
'apis/organization-apis/org-user-mgt.md': 'apis/organization-apis/scim2/scim2-org-user-mgt.md'
'apis/organization-apis/org-group-mgt.md': 'apis/organization-apis/scim2/scim2-org-group-mgt.md'
Expand Down Expand Up @@ -787,12 +787,12 @@ nav:
- SCIM 2.0 API: apis/scim2/index.md
- SCIM 2.0 Users API: apis/scim2/scim2-users-rest-api.md
- SCIM 2.0 Groups API: apis/scim2/scim2-groups-rest-api.md
- SCIM 2.0 Build user creation payload: apis/scim2/build-scim2-user-creation-payload.md
- SCIM 2.0 Patch operations: apis/scim2/scim2-patch-operations.md
- SCIM 2.0 Bulk API: apis/scim2/scim2-bulk-rest-api.md
- SCIM 2.0 Batch operations: apis/scim2/scim2-batch-operations.md
- SCIM 2.0 Resource types API: apis/scim2/scim2-resource-types.md
- SCIM 2.0 Service provider configuration API: apis/scim2/scim2-sp-config-rest-api.md
- SCIM 2.0 Build user creation payload: apis/scim2/build-scim2-user-creation-payload.md
- Account recovery APIs:
- Account recovery v0.9 API: apis/use-the-account-recovery-rest-apis.md
- Account recovery v1 API (deprecated): apis/user-account-recovery-v1-rest-api.md
Expand Down
26 changes: 7 additions & 19 deletions en/includes/apis/scim2/build-scim2-user-creation-payload.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Build SCIM 2.0 User Creation Payloads


This guide explains how to build SCIM 2.0 payloads in compliance with the SCIM 2.0 specification.
This guide explains how to build SCIM 2.0 user creation payloads in compliance with the SCIM 2.0 specification.


## Step 1 : Identifying SCIM 2.0 Claims for User Attributes
## Step 1 : Identifying SCIM 2.0 Attributes for User Attributes


To build a SCIM 2.0 payload, the first step is identifying the SCIM schema mapping for your user attribute:
Expand All @@ -15,7 +15,7 @@ Navigate to **User Attributes & Stores** → **Attributes** → **SCIM 2.0** in
- **Core Schema**
- **User Schema**
- **Enterprise Schema**
- **Custom Schema** {% if product_name == "WSO2 Identity Server" %} (if you have mapped any custom user attribute to a SCIM claim). {% endif %}
- **Custom Schema** {% if product_name == "WSO2 Identity Server" %} (if you have mapped any custom user attribute to a SCIM attribute in the custom schema). {% endif %}


> For further details refer [Manage SCIM 2.0 attribute mappings]({{base_path}}/guides/users/attributes/manage-scim2-attribute-mappings)
Expand All @@ -24,7 +24,7 @@ Navigate to **User Attributes & Stores** → **Attributes** → **SCIM 2.0** in
### Rules for Schema Usage in SCIM 2.0 Payloads


- If your user attribute is mapped to **Core Schema** or **User Schema**, the schema name does not need to be qualified in the SCIM payload.
- If your user attribute is mapped to **Core Schema** or **User Schema**, the schema URI does not need to be qualified in the SCIM payload.
- If your user attribute is mapped to **Enterprise Schema** or **Custom Schema**, each SCIM attribute under these schemas must be placed under the schema’s namespace.


Expand All @@ -39,11 +39,10 @@ Navigate to **User Attributes & Stores** → **Attributes** → **SCIM 2.0** in
}
}


```


## Step 2 : Attribute Types in SCIM 2.0 Payloads
## Step 2 : Identify the Attribute Types and their SCIM 2.0 Payload Format


Each SCIM attribute falls into one of the following attribute types, which determine the format of the attribute in the payload.
Expand Down Expand Up @@ -80,7 +79,7 @@ Each SCIM attribute falls into one of the following attribute types, which deter
Extended attribute example:
```json
{
"urn:scim:wso2:schema:userDevices": {
"urn:scim:wso2:schema:user": {
"devices": ["d1", "d2"]
}
}
Expand Down Expand Up @@ -121,7 +120,7 @@ Each SCIM attribute falls into one of the following attribute types, which deter

## Step 3: Determining the Type of SCIM 2.0 Attributes

The patterns described below are used for SCIM attributes to map local user attributes. SCIM claim mappings should follow these patterns for different types of SCIM attributes.
The patterns described below are used for SCIM attributes to map local user attributes. SCIM attribute mappings should follow these patterns for different types of SCIM attributes.

Based on the pattern:

Expand Down Expand Up @@ -177,7 +176,6 @@ Based on the pattern:
},
"emails": [
{
"type": "home",
"value": "[email protected]",
"primary": true
},
Expand All @@ -186,16 +184,6 @@ Based on the pattern:
"value": "[email protected]"
}
],
"addresses": [
{
"type": "home",
"value": "123 Main St, City, Country"
},
{
"type": "work",
"value": "456 Office Rd, City, Country"
}
],
"phoneNumbers": [
{
"type": "mobile",
Expand Down

0 comments on commit f6909b7

Please sign in to comment.