Basic Users Functionalities

[Mohido]

User Documentation:

• [GET] /users/get/self : Get the current logged in user's details. It also contain the role (It is same as the /users/get/profile). However, /get/profile is no longer available.
• [GET] /users/get/all : Get all users in the system. Valid users must exist in both, keycloak and cleanDB. Only admins, and demonstrators are authorized to get the users.
• [POST] /users/create : Given users in the request body which contains username, firstname, lastname, roles, uid, it creates the given users in the databases. It returns a dictionary (Map) of username => password to the client. Only admins are valid to call this function.
• [PUT] /users/update/role :Given a username and a list of roles in the request body, it assigns the given roles to the specific username. Only admins are able to call this function.

Developer Documentation: Added multiple utilities in the keycloak_utils.

• protector: Authorization middleware. Given a list of roles, it checks if the logged in user has one of these roles.
• updateUserRole : Given a username and a list of roles, it assigns these roles to the user with the given username.
• getAllRolesData: As the name implies, it returns all the roles data in the realm. Roles data are the 'idin keycloak andname` of the role.
• createUsers: Given a list of KCUserData, it creates these users in keycloak. It assign random passwords to them. It returns a map of username => password.
• getAllUsersData : Get all the users in keycloak. It also can be filtered by roles if roles are given in the parameter.
• getSelfData : Get thy data as KCUserData
• getUserData: Get any given user data by its username.
• createClientAccessToken: Creates an access token for the client. The client has the ability to alter the keycloak settings in our realm.

[Mohido]

@the4t4 if possible, can you change the /student/ in your other PR to the users/ router? and if possible as well, can you add the users/create endpoint. There is a TODO that concerns creating the users in the clean DB. So, it will be great if you can handle that. (Copy the /student/add that you have) into that endpoint. (#55)