Skip to content

Manage users

To manage users you have to go to the Administration panel

Press the button

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

Then 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.

Press the button

And a dialog window with a form appears. Fill in the "Allowed email domain for foreign account like Google" field with the email domain.


Last update: August 22, 2024