We are proud to announce the availability of Connector4Java 1.9. This release merges the scim-schema into the connector. This was necessary, because client and server partly have a different view on the SCIM resources. This leads to an enormous amount of deprecations in this release. This release deprecates the support of OSIAM 2.x. It will be completely removed in version 1.12 or 2.0. Please update to OSIAM 3.0 as soon as possible.
The artifacts have been deployed to Maven central. We recommend consuming them with Maven, Gradle or any other build tool supporting the Maven repositories. You can also download the JAR files using one of the following links:
The following is an overview of the most important changes. See the full changelog at the Connector4Java 1.9 release page on GitHub.
Updating Resources has been Deprecated
OSIAM 3.0 removes the ability to update resources via PATCH. This is because the implementation was not compliant with the final SCIM specification. As users are encouraged to update to OSIAM 3.0, updating resources has been deprecated. It will be completely removed in 1.12 or 2.0. Please update your application to use resource replacing via PUT.
Get Current User
OSIAM 3.0 receives a new
/Me endpoint, that is compliant to the current SCIM spec.
To use the new endpoint a new method,
getMe(), has been introduced.
To be backwards compatible, this method works with OSIAM 2.x and OSIAM 3.x.
getCurrentUserBasic, and the class
BasicUser have been deprecated.
They will be completely removed in 1.12 or 2.0.
Please update your applications to use
getMe instead of the aforementioned methods.
Filtering Resource Attributes
OSIAM 3.0 makes it possible to filter the attributes of the returned resources.
To enable this feature in the connector the methods
getAllGroups() now take the attributes requested as optional final String varargs in their parameter list.
Retrieving a list of all
User resources with only their userName and their creation date can be realized as follows:
List<User> users = osiamConnector.getAllUsers(accessToken, "userName", "meta.created");
Group.Builder API has been extended with some methods to change the list of members:
This makes the API consistent with
Many methods and classes, that are not needed on the client-side have been deprecated. OSIAM ignores them anyway, so client applications probably never used them. Nevertheless, they have only been deprecated, not deleted, to maintain backwards compatibility.
Additional new features in the SCIM API are:
- The user name can now be set via the builder
- The group’s display name can now be set via the builder
- Properties of a user’s name attribute can be easily updated now.