Partner accounts can now implement a third-party authentication process to create new users for a Partner Client using our API. This provides a solution to registering users externally from iCompleat and removes the need for multiple login accounts if a customer exists elsewhere in another system.
How you configure the process is totally in your hands, iCompleat makes the authentication process possible by giving you the data you need to execute through an API.
To set this up for a client company, follow the steps below:
- Log in and click Client Management.
-
Find the company that requires third-party configuration.
Hover over Actions.
Click Authentication.
-
Authentication options for the client company appear.
Click Use a third-party application for user registration. - An Authentication Endpoint URL and a Sharded Secret token will display for that company.
This data sample provided can be used in a custom integration for your client management solution to register users from other sources such as a database or web form.
View the example below to see this process in action.
Example
Using the data provided in iCompleat, we’re using Postman API to test this feature.
Simply populate the body data and use the POST method to add the user to the client’s company.
The tenant ID and shared secret should be kept confidential to prevent any data breaches.
Once sent, if the user already exists, this will return a result of “true” and generate a URL which once entered into a browser, will instantly login the user.
If this is a new user, they will be added to the system but will require an administrator to assign them to a company from inside of iCompleat. Once this is done, the new user is fully operational.