# User Module

## Overview

This doc provides the steps to create and add users on the DIGIT platform post-installation.

## Steps To Create Users

* Run the [kubectl port-forwarding](https://phoenixnap.com/kb/kubectl-port-forward) of the **egov-user** service from the Kubernetes cluster to your local host. This gives you access to egov-user service, bypassing Zuul auth, and you can now interact with the User API directly.

`kubectl port-forward svc/egov-user 8080:8080 -n egov`

You will see below text in the Terminal:

`Forwarding from 127.0.0.1:8080 -> 8080`\
`Forwarding from [::1]:8080 -> 8080`

* Ensure you have installed the Postman utility to run the following scripts. If not, [Install postman](https://www.postman.com/downloads/canary/) on your local machine. Import the [collection](https://www.getpostman.com/collections/b5031f458fc9400c5ade) into Postman. Create an environment variable for “tenantId” and set its value to your tenant.
* The collection creates four types of users and also provides a way to refresh the auth token:
  1. Super User
  2. System User
  3. Citizen
  4. Anonymous User
* Run all the scripts in order.

The refresh auth token script logs into the server and refreshes the token. A sample script is provided for the employee user. Similar scripts can be copied for the citizen/super user etc..for convenience.

#### Sample Json Object

```
{
       "userName": "systemuser",		Can it be changed: Yes
       "name": "systemuser",			Can it be changed: Yes
       "gender": null,			        Can it be changed: Yes
       "mobileNumber": "9999999999",	        Can it be changed: Yes
       "type": "SYSTEM",			Can it be changed: No
       "active": true,				Can it be changed: No
       "password": "eGov@54321",		Can it be changed: Yes
       "roles": [				Can it be changed: No
           {
               "name": "Employee",
               "code": "EMPLOYEE",
               "tenantId": "pg"
           },
           {
               "name": "System user",
               "code": "SYSTEM",
               "tenantId": "pg"
           }
       ],
       "tenantId": "pg"			Can it be changed: No
   }

```


---

# 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.digit.org/platform/guides/data-setup-guide/user-module.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.