Creating end user logins for OpenSRP client

This page will show the user how to:

Create a user (who can log into OpenSRP client)
Create a team and assign the user you create to that team
Map locations to this user (these will be loaded into the location modal UI in OpenSRP client when the username in question is used to log into OpenSRP).

OpenSRP client authentication is managed through the OpenMRS team management module, which was developed by the IHS team in Pakistan. In order to use the module, you will first need to install it on your local OpenMRS instance (i.e., it is a custom module that does not come pre-installed with OpenMRS). Before installing the team management module, there are two dependent modules that must be installed first:

Once these two modules are installed, you can get the code for the team management module from this repo. This is a maven project so you would need to run ‘mvn clean install’, and get the .omod file on the omod/target directory. Alternatively, contact us at info@smartregister.org to get the installation-ready module.

To confirm that the team management module was successfully installed, click on the Administration tab in your OpenMRS instance, and click on the Manage Modules option, as shown below.

You should see the Team Management Module in the list, as shown below. If you do not see it, then you will need to try to install the module again.

Team management module started.png

Once you confirm that the module is installed, you can create users in OpenMRS and use the Team Management Module to assign users to teams and tag users with locations.

To create a user, you will need to click on Administration, then click on Manage Users as shown below:

Manage users.png

Click on Add User as shown below:

Add user.png

Click on the Next button under Create a new person.

Enter the new user details, including given name, family name, gender, username and password. Remember that the username and password you specify here will be used to log into the OpenSRP client application. Don’t forget these very important details!

In the Roles section, check the following role: Provider.

Once you are done entering these details, click on Save User at the bottom of the page. You can now navigate to the Team Management Module to add this user to your OpenSRP team. Click on the Administration tab in OpenMRS and scroll until you see the module, as shown below:

Team management module.png

Click on Manage Teams, and then click on Add Team as shown below:

Add team.png

Add your OpenSRP team details, then click on Save and then click on Back to teams to return to the list of teams.

Add team details.png

Locate your team in the list and click on Add Member as highlighted below:

Add team members.png

To add the user that you created earlier, check the box next to Choose Existing Person.

Choose existing member.png

Let’s say the user you created earlier is ‘Ndisha’, see below how OpenMRS gets the user details.

chosen member.png

Select the user from the dropdown. Fill in the rest of the details for this user, including a location.

For you to select more than one location, you will need to first select the first location, then hold down your ctrl key as you select the rest of the locations. Click on Add and you should be done.

multiple locations.png

Click on Back to Team List to add more users to this team - following the same process.