# Create User and Assign Role

## Description

This document contains the step-by-step instructions to create a new user and assign a role. A person who has admin access can create a new user and assign a role.

## Prerequisites

A user should have an admin access to create a new user and assign a role.

## Procedure

1. Click the main menu icon ![](https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-1b48611b7e3fc05b72b589735073c90404ac05ef%2Fmain-menu.png?alt=media) and select ***Settings***.
2. The ***Settings*** screen is displayed

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-3f89418e11878b31f0fdb06da1d64b8f33f4e69a%2FCreate%20a%20user.png?alt=media" alt=""><figcaption><p>Choose Settings Screen</p></figcaption></figure>

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-ecdbe640292dee3ddfbbfd55cab71ac78c2522d3%2FSettings%20screen.png?alt=media" alt=""><figcaption><p>Settings Screen</p></figcaption></figure>

3. Click the ***User & Companies*** tab and then select ***Users***.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-5ae2e3086e74fd399540d16bc6a4197c31ea4e3f%2FUsers%20-%20Dashboard.png?alt=media" alt=""><figcaption><p>Users Screen</p></figcaption></figure>

4. The ***Users*** screen is displayed. It is a dashboard which lists the details of all the available Users Name, Login, Language and their Latest authentication.

In ***Users*** screen, the available features and their descriptions are:

<table><thead><tr><th width="130">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Click the <em><strong>Create</strong></em> button to create new user</td></tr><tr><td><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-442600177350879d5a880d1efc167a3f8bce47d9%2Fdownload.png?alt=media" alt="" data-size="original"></td><td>Click the <em><strong>Export All</strong></em> button to download Users details in excel format</td></tr><tr><td>&#x3C;</td><td>Click the <em><strong>Left</strong></em> arrow to go the previous screen</td></tr><tr><td>></td><td>Click the <em><strong>Right</strong></em> arrow to go the next screen</td></tr><tr><td><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-8d864c7861b45bc233e48635e315b026196221a6%2Flist-view.png?alt=media" alt="" data-size="original"></td><td>Click the <em><strong>List</strong></em> icon to view the Users details in list view</td></tr><tr><td><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-fe76a40d2e7d589d2c751c947be3a81bbb8ad431%2Fmain-menu%20(1).png?alt=media" alt="" data-size="original"></td><td>Click the <em><strong>Kanban</strong></em> icon to view the Users details in kanban view</td></tr><tr><td>Filters</td><td><p>Click the <em><strong>Filters</strong></em> link and select the appropriate options.</p><p>The valid values are:</p><ul><li>Internal User</li><li>Inactive User</li><li>Two-factor authentication enabled</li><li>Two-factor authentication disabled</li><li>Add Customer Filter</li></ul><p>The advanced filter option allows you to define conditions and criteria to refine the search results.</p><ul><li>Select the <em><strong>Add Customer filter</strong></em> and then select the appropriate option in the first drop-down to display the specific data based on the option selected.</li><li>Select the criteria in second and third drop-down to refine the search results.</li><li>Click the <em><strong>Apply</strong></em> button to display the data based on the search</li></ul><p><em>Note: To enhance the search, click the <strong>Add a condition</strong> button and follows the steps given in <strong>Add Customer Filter</strong> option</em></p></td></tr><tr><td>Group By</td><td><ul><li>Click the <em><strong>Group By</strong></em> link, select <strong>Add Custom Group</strong> and then select the appropriate options in the drop-down to display the specific data based on the option selected.</li><li>Click the Apply button to display the data based on the search</li></ul></td></tr><tr><td>Favorites</td><td><ul><li><p>Click the <em><strong>Favorites</strong></em> link, select <strong>Save current search</strong> and then check the appropriate options. The valid values are:</p><ul><li>Use by default</li><li>Share with all users</li></ul></li><li>Click the <em><strong>Save</strong></em> button to display the data based on the search</li></ul></td></tr><tr><td>Search</td><td>This field is filled when the available option are selected in Filers, Group By, Favorites</td></tr></tbody></table>

5. Click the ***Create*** button. The **Users/New** screen is displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-03d61c06a6a00c6a9496477ca990ccd04b453424%2Fuser-creation-page.png?alt=media" alt=""><figcaption></figcaption></figure>

In ***Users/New*** screen, the available features and their descriptions are:

<table><thead><tr><th width="166">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter the new user name</td></tr><tr><td>Email Address</td><td>Enter the valid email Id. of the user. The invitation email will be sent to this email address.</td></tr><tr><td><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-b9785c3e12d920c7b5b0ad3a96e895f64013ef58%2Fphoto-camera-icon.png?alt=media" alt="" data-size="original"></td><td><ul><li>Select the icon, click the edit icon and then navigate to the user photo where it is stored</li><li>Export the user photo</li><li>Click the delete icon to delete the user photo</li></ul></td></tr><tr><td>Save</td><td>Click the <strong>Save</strong> button to save the data</td></tr><tr><td>Discard</td><td>Click the <strong>Discard</strong> button to close the Users / New screen</td></tr></tbody></table>

### **Access Right**

OpenG2P offers several modules and tools to digitize processes of social benefit delivery chain. A user who has admin rights provides access rights to an individual based on his/her role to use modules offered by OpenG2P. This allows the individual to know which module they can use based on their roles.

6. Click the ***Access Rights*** tab.
7. The features available in ***Access Rights*** tab are displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-d765d670df0410cfe42dff5d6ccbf74284e16cef%2Fopeng2p-module-access.png?alt=media" alt=""><figcaption></figcaption></figure>

8. In ***Access Rights*** tab, the available features and their descriptions are:

<table><thead><tr><th width="280">Feature</th><th>Description</th></tr></thead><tbody><tr><td><strong>Accounting</strong></td><td><p><strong>Invoicing</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>Billing</li><li>Billing Administrator</li></ul></td></tr><tr><td><strong>Inventory</strong></td><td><p><strong>Inventory</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>User</li><li>Administrator</li></ul></td></tr><tr><td><strong>Website</strong></td><td><p><strong>Website</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>Restricted Editor</li><li>Editor and Designer</li></ul></td></tr><tr><td><strong>Marketing</strong></td><td><p><strong>Events</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>Registration Desk</li><li>User</li><li>Administrator</li></ul></td></tr><tr><td><strong>Administration</strong></td><td><p><strong>Administration</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>Registration Desk</li><li>User</li><li>Administrator</li></ul></td></tr><tr><td><strong>Other</strong></td><td><p><strong>Helpdesk</strong></p><p>Select the appropriate role in the drop-down. The valid values are:</p><ul><li>User: Personal tickets</li><li>User: Team ticktets</li><li>User</li><li>Helpdesk Manager</li></ul><p><strong>Job Queue</strong></p><p>Select the appropriate role in the drop-down. The valid value is:</p><ul><li>Job Queue Manager</li></ul></td></tr><tr><td><strong>OpenG2P Module Access</strong></td><td><p>Check the appropriate role. The valid values are:</p><ul><li>Administrator</li><li>Finance Validator</li><li>Program Cycle Approver</li><li>Program Manager</li><li>Program Validator</li><li>Registrar</li><li>Support Person</li></ul></td></tr><tr><td><strong>OpenG2P Documents Module</strong></td><td><p>Check the appropriate option. The valid values are:</p><ul><li>Document Admin</li><li>Document Write</li><li>Document Read</li></ul></td></tr><tr><td><strong>OpenG2P Rest API</strong></td><td><p>Check the appropriate option. The valid values are:</p><ul><li>REST API GET</li><li>REST API POST</li></ul></td></tr><tr><td><strong>Other</strong></td><td><p>Check the appropriate option. The valid values are:</p><ul><li>View Server Environment Configuration</li></ul></td></tr><tr><td><strong>Save</strong></td><td>Click the <strong>Save</strong> button to save the data</td></tr><tr><td><strong>Discard</strong></td><td>Click the <strong>Discard</strong> button to close the Users / New screen</td></tr></tbody></table>

### **Preference**

The admin user sets the user preference in the preference section.

9. Click the **Preference** tab. The features in **Preference** tab are displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-480e7291648fcb1719a9c67caabf90cff4961d00%2Fpreference%20tab.png?alt=media" alt=""><figcaption><p>Preferences</p></figcaption></figure>

In Preference tab, the features and their descriptions are:

<table><thead><tr><th width="223">Feature</th><th>Description</th></tr></thead><tbody><tr><td><strong>Localization</strong></td><td></td></tr><tr><td>Language</td><td>Select the user preferred language in the drop-down.</td></tr><tr><td>Timezone</td><td>Select the user preferred timezone in the drop-down.</td></tr><tr><td>Notification</td><td><p>Click the appropriate radio button.</p><ul><li>Handle by Emails</li><li>Handle in Odoo</li></ul></td></tr><tr><td>Email Signature</td><td>Enter the User Email Signature</td></tr></tbody></table>

### OAuth

OAuth is the preferred method of authentication to access the OpenG2P documents and modules. The external application gets a token which authorizes access to documents and modules of OpenG2P. All the documents and the modules are secured/protected using Standard OAuth.

10. Click the OAuth tab. The features available in OAuth are displayed.

<figure><img src="https://1895884874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnKdOHLbjDdIln1QDNwSx%2Fuploads%2Fgit-blob-6adafdcf8569e9efcc73a87071f70800b6d7a80b%2FOAuth.png?alt=media" alt=""><figcaption><p>OAuth</p></figcaption></figure>

In OAuth tab, the available features and their descriptions are:

<table><thead><tr><th width="213">Feature</th><th>Description</th></tr></thead><tbody><tr><td>OAuth Provider</td><td><p>Select the appropriate option in the drop-down. The valid values are:</p><ul><li>eSignet MOSIP Collab</li><li>Facebook Graph</li><li>Google OAuth2</li><li>Odoo.com Accounts</li><li>Start typing - Type the OAUth provider, if you have OAuth provider other than the one mentioned above</li></ul></td></tr><tr><td>OAuth User ID</td><td>Enter the OAuth user ID</td></tr><tr><td>OAuth Access token</td><td>Enter the valid Access token</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openg2p.org/1.3/pbms/functionality/administration/role-based-access-control/user-guides/assign-roles-to-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
