SCIM 2.0 Open Source Implementation
Branch | Circle CI Status | Code Coverage |
---|---|---|
master |
This is an open source implementation of the SCIM (System for Cross-domain Identity Management) protocol that is defined by RFC7643 and RFC7644.
A simple description of SCIM can be found here http://www.simplecloud.info/
Why and when you should use this library
The SCIM specification is well suited for designing resource management servers where the resources need to be regularly updated by other remote applications.
For example:
If you create an application that uses a database configuration that might be updated by different clients or even by just a single remote application this library is what you are looking for. It uses a standard protocol that should also be understood by other libraries in other languages that implement the SCIM standard.
This lib supports the full feature set of both client and server side of the SCIM specification.
Documentation
for a documentation take a look into the github wiki https://github.com/Captain-P-Goldfish/SCIM/wiki
You will find a pretty detailed explanation on how to use the server implementation here: https://github.com/Captain-P-Goldfish/SCIM-SDK/wiki/How-to-use-the-server-implementation
And a pretty detailed explanation on how to use the client can be found here: https://github.com/Captain-P-Goldfish/SCIM-SDK/wiki/How-to-use-the-client-implementation
Note: You do not need to fork this project in order to make adjustments to the User
-schema or the User
-class implementation. Find a more detailed explanation in the wiki: best practices
This project requires JDK 8 or higher
<dependency>
<groupId>de.captaingoldfish</groupId>
<artifactId>scim-sdk-server</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>de.captaingoldfish</groupId>
<artifactId>scim-sdk-client</artifactId>
<version>${project.version}</version>
</dependency>
Note: If the project does not compile within your IDE install the "lombok" plugin for your IDE and restart it.
Release Notes
To see the current release-notes take a look into the release section: https://github.com/Captain-P-Goldfish/SCIM-SDK/releases
Server implementation
This API is highly generic and allows the definition of your own schema representations for resources. You will even be able to override the default User or Group core schemata if you want to. This might be useful if you do not want to support attributes like "ims", "phoneNumbers" etc. All you need to do is simply to write two json documents.
- a schema definition that describes the resource you want to supply
- a resource type definition that describes the endpoint and the additional schema extensions that may be used within the schema definition
The following features are supported
- create
- read
- list
- filtering (@see additional features)
- sorting (@see additional features)
- update
- patch (@see patching resources)
- delete
- bulk
- resolving of bulkId references (@see bulkId reference resolving)
- resource versioning (@see resource versioning)
- attributes-parameter
- excludedAttributes-parameter
for any registered resource
Additional supported features
- authentication for specific endpoints (@see authentication)
- authorization for specific endpoints (@see authorization)
- attribute validation (@see attribute validation)
- custom resource validation [similiar to bean validation in JEE] (@see resource validation)
- automatic POJO creation from SCIM schema resources. (@see schema pojo creator)
Client implementation
The client implementation supports the following SCIM requests
- create
- read
- list
- update
- delete
- bulk
- patch
there is also direct native support for easy use of basic authentication and X509 client authentication. All other authentication types must be implemented manually.
Automatic-Module-Names for Jigsaw:
de.captaingoldfish.scim.sdk.common
de.captaingoldfish.scim.sdk.server
de.captaingoldfish.scim.sdk.client