This page (revision-1) was last changed on 29-Nov-2024 16:16 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note

Page References

Incoming links Outgoing links

Version management

Difference between version and

At line 1 added 70 lines
!!! Overview
[{$pagename}] is a [SCIM Resource Operation] to Create an [SCIM Resource]!! [{$pagename}] [Example]
To create a resource, send an [HTTP POST] request to the resource's respective end point. In the example below we see the creation of a User.
As can be seen in this and later examples the URL contains a version number so that different versions of the [SCIM] API can co-exist. Available versions can be dynamically discovered via the ServiceProviderConfig end point.
%%prettify
{{{
POST /v2/Users HTTP/1.1
Accept: application/json
Authorization: Bearer h480djs93hd8
Host: example.com
Content-Length: ...
Content-Type: application/json
{
"schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],
"externalId":"bjensen",
"userName":"bjensen",
"name":{
"familyName":"Jensen",
"givenName":"Barbara"
}
}
}}} /%!! Create Response
A response contains the created Resource and [HTTP Status Code] [HTTP 201] to indicate that the Resource has been created successfully.
The [SCIM Service Provider] has added additional data than was posted to make a complete [SCIM User] resource:
* The [HTTP Header Field] "Location"
* The [HTTP Header Field] [Etag]
* [SCIM id]
* [SCIM meta]
** [SCIM meta.ResourceType]
** [SCIM meta.created]
** [SCIM meta.lastModified]
** [SCIM meta.location]
** [SCIM meta.version] (__IF__ supported)
The [HTTP Header Field] "Location" and [SCIM meta.location] indicates where the [SCIM Resource] can be fetched in subsequent requests.
The The [HTTP Header Field] [etag] and [SCIM meta.lastModified] may be used ot determine if the entry was modifies since the last interaction of the [SCIM Client]
%%prettify
{{{
HTTP/1.1 201 Created
Content-Type: application/scim+json
Location: https://example.com/v2/Users/2819c223-7f76-453a-919d-413861904646
ETag: W/"e180ee84f0671b1"
{
"schemas":["urn:ietf:params:scim:schemas:core:2.0:User"],
"id":"2819c223-7f76-453a-919d-413861904646",
"externalId":"bjensen",
"meta":{
"resourceType":"User",
"created":"2011-08-01T21:32:44.882Z",
"lastModified":"2011-08-01T21:32:44.882Z",
"location":"https://example.com/v2/Users/2819c223-7f76-453a-919d-413861904646",
"version":"W\/\"e180ee84f0671b1\""
},
"name":{
"familyName":"Jensen",
"givenName":"Barbara"
},
"userName":"bjensen"
}
}}} /%
!! More Information
There might be more information for this subject on one of the following:
[{ReferringPagesPlugin before='*' after='\n' }]