Manage users¶
To manage users you have to go to the Administration panel
Group Creation¶
To create groups you have to go to the "Management" subsection under the "User" section. Then look for the "Groups" table and press the button
And fill the fields in the form.
Important notes about the form fields
-
Linked groups: All the resources that have been shared with its linked groups will be automatically inherited by the created group. For instance, if a Group A is created with Group B as a linked group, all the resources shared with Group B will also be shared with Group A.
-
Ephimeral desktops: Will set a limited time of use to a temporary desktop. (For this you also have to configure, being Admin, in Config the "Job Scheduler")
Group Edition¶
A group's parameters can be edited by pressing the icon next to the group we want to update, and then pressing .
A dialog box will pop up with the same parameters as the creation form.
User Creation¶
To create users you have to go to the "Management" subsection under the "User" section.
Individually¶
Look for the "Users" table and press the button
And a dialog box will appear with the following form:
And fill the fields in the form
Important notes about the form fields
Secondary groups: All the resources that have been shared with its secondary groups will be automatically inherited by the created user. In addition, the user will be added to the deployments created in any of its secondary groups.
Bulk Creation¶
Look for the "Users" table and press the button
And a dialog box will appear with the following form:
An example file can be downloaded by clicking the button . A form will appear to fill out:
Avoiding errors
- The category and group fields must exactly match its name
- The recommended encoding is Unicode (UTF-8)
- The csv must be separated by tabulations Tab ↹
- It's highly recommended to use the given sample csv
Once filled out, it can be uploaded on
And if it has been uploaded correctly, a preview table of the users will appear:
To export the users with the generated password into a CSV, press the button
Errors
If the csv has not been uploaded correctly, an error will be shown indicating the reason.
Generate CSV to create existing users¶
To generate a CSV with existing users to create them again, select the users and press the button .
You can then import the CSV file to create the users again. The CSV file will not contain the passwords of the users.
If you want to update the users, you should use the CSV for update button.
User Edition¶
To edit users you have to go to the "Management" subsection under the "User" section.
Individually¶
Users parameters can be edited by pressing the icon next to the user we want to update, and then pressing .
A dialog box will pop up with the same parameters as the creation one.
Important notes about the form fields
The users username, group and category can't be modified.
Bulk Edition¶
Select one or more users and press the button
A dialog box will appear with the following form:
Fields
- Update active/inactive: The user's status on the platform is updated. This user can be active, has access to the platform, or inactive, does not have access to the platform.
- Update secondary group: Secondary groups of multiple users can be updated at the same time. To do this, write the name of the group and select one of these options:
- Overwrite: Overwrites the secondary group that was assigned to it.
- Add: The secondary group written is added to the user.
- Delete: Deletes the secondary group that the user was assigned to.
User update¶
To update users using a .csv file, you must first download the file with the user information. To do this, press the button
A dialog window will appear with the following form where you can upload the file or download an example:
Avoiding mistakes
- The "username", "category" and "group" fields have to match exactly with their name to update the user
- Unicode (UTF-8) encoding is recommended
- The csv file must be separated by tabulations Tab ↹
Important notes regarding fields
- The fields "provider", "category", "uid", and "group" cannot be modified. The rest of the fields will be updated.
- If you leave a box blank, it will not be updated.
- The "Active" column will have to have a value "true" or "false"
- To add more than one secondary group to users, you have to separate the groups in the "secondary_groups" column with "/", example "prova/Test"
If you want to generate a CSV to create the users again, you should use the CSV for create button.
Enable/Disable¶
Users parameters can be edited by pressing the icon next to the user we want to disable/enable, then press .
The users status can be seen in the users table.
Be careful
If the user is disabled while logged in it could provoke session errors.
Change Password¶
Users parameters can be edited by pressing the icon next to the user we want to change its password, then press .
A dialog box will pop up with the following form:
Tip
Users can change its passwords through their profile.
Impersonate User¶
Users parameters can be edited by pressing the icon next to the user we want to impersonate,and press .
Disclaimer
Impersonating a user provides access to all its data and desktops and it comes with inherent risks. Before proceeding, it is important to consider the sensitivity of the information that will be accessed.
Enrollment keys¶
In the "Groups" table search for the group that you want to obtain the code. Press the button to view the group details
The group is displayed with some options. Press the button
A dialog box will appear where you can generate codes by clicking the different checkboxes.
Once the enrollment key code is generated, it can be copied and shared with users.
Be careful
- When signing up, the users will be given the role of the shared enrollment key code. For instance, Teachers, will be given the "Advanced" code and students the "Users" code.
- An unlimited amount of users can sign up using the given enrollment key code. Thus, it's recommended to deactivate them once used.
Create categories¶
Roles with access
Only administrators have access to this feature.
In the "Users" section, look where it says "Categories" and press the button
A dialog box will appear where the form fields can be filled.
There are three options that can be applied when creating a category:
- Automatic recycle bin delete: Recycle Bin functionality will be applied to users. You can select whether you want desktops to be deleted after one hour or immediately. This time can be modified here.
- Frontend dropdown show: En la página de inicio de sesión, aparecerá la categoría creada en el menú desplegable.
Info
If the category is hidden it is still possible to login in that category using the url /login/<category_id>
- Ephemeral desktops: Para poder poner un tiempo limitado de uso a un escritorio temporal. (Para esto también se tiene que configurar en la sección de "Config" el "Job Scheduler")
Access via OAuth¶
Roles with access
Only administrators have access to this feature.
To be able to access through Google from an external account, you have to go to the "Users" section and the "Categories" section, press the icon of the category to which you want to give access.
And a dialog window with a form appears. Fill in the "Allowed email domain for foreign account like Google" field with the email domain.