[Download]| [ Documentation Home] | [Release Note]
In this sample, we demonstrate how to use the remote user management feature to perform user management functionalities from a remote client application. This sample is located in [IdentityServer_Home/Samples/remote-user-mgt]
Often you may find the requirement of adding, deleting and updating users, roles and user profiles that are managed in the user store of Identity Server, through a custom client application of yours rather than performing that functionality through the management console of Identity Server.
Remote User Management feature that is installed into Identity Server by default, facilitates the above requirement and the following section briefly describes this feature and how to use it.
There are two web services APIs that expose the user management functionality in WSO2 carbon.
From server side, this feature provides set of web services as Admin Services exposing user management functionality. For the client side, it provides an api wrapping the generated client stubs for those web services, to be used in your client code. Since this client API that we provide is for java clients, you can use the wsdls of web services and generate stubs and write custom clients in your preferred language.
Following are the steps for using the remote user management in your client code:
You can access those wsdls from carbon server itself (i.e:https://localhost:9443/services/AuthenticationAdmin?wsdl), by setting "HideAdminServiceWSDLs" property to false in [IdentityServer_Home]/repository/conf/carbon.xml file.
You will get a clear understanding about performing above steps if you go through the source code of this sample.
To build the samples you need the Apache Ant build tool.
cd CARBON_HOME\samples\remote-user-mgt
ant
This will build and run the sample. You willl see a
BUILD SUCCESSFUL
This sample performs the following user management operations in the following order:
Now you can login to the management console of Identity Server through a web browser and go to 'Configure'->'Users and Roles'->'Users' or 'Roles' and observe the users and roles created by the remote sample client above.