Guide to Creating a User List

To ensure the participant list is imported correctly into the Cyber Guru platform, it's important to follow the instructions provided in the referenced article.

The list must include all participants in the training program and be provided in a CSV file with UTF-8 encoding.

A SAMPLE USER LIST IS ATTACHED

Required fields for each user

For each user, you need to include the following fields:

• First Name: the user's first name.

• Last Name: the user's last name.

• Email: the user's email address, used to receive communications from the platform and, if applicable, phishing simulations. The email can also be used as a login credential.

• Language: the user's preferred language for training content, indicated in the ISO 639-1 two-letter lowercase format (e.g., Italian → it).

• Username*: a unique and unchangeable identifier for the user (e.g., employee number or SID). It must be between 3 and 255 characters. For SSO, it must match the value mapped as the username (e.g., objectID).

   

  The username can include:

  • letters
  • numbers
  • allowed special characters:
    • underscore (_)
    • hyphen (-)
    • dot (.)
    • at symbol (@)

  This is a subset of the characters allowed in an email address: for example, an apostrophe (') is valid in an email, but not allowed in the username.

  Important note The username is a non-editable field. Once a user account is created, the username cannot be changed. If you need to correct or change the username, you must delete the existing user account and recreate it. Please double-check the username before creating the user, as any correction will require a full account recreation, which may affect the user's history.

   

• Country: the country where the user is located, expressed in the ISO 3166-1 alpha-2 two-letter uppercase format (e.g., Italy → IT).

• Authmode: for hybrid SSO, specifies the login method: 0 for login with credentials, 1 for SSO login.

• Role: the role assigned to the user within the platform (see "Role in the platform")

For each user, you can include additional information, such as:

• Department

• Age group

• Geographical area

• Organizational function

• Company role

These optional fields can be mapped within the platform as “New Organization”.

For the import to be successful, the column defining a new organization must contain only alphanumeric characters. The only special character allowed is underscore (_)

Role in the platform

For each user, you must specify the role they will have within the platform.

• The field must be labeled as roles to allow automatic mapping.

• If the role is not specified, the user will be imported by default as “studente” (student).

Available roles

• studente: individual profile with access only to their own training path.

• teamleader: can be enabled for team gamification, identifies the team leader responsible for motivating and monitoring progress. Has access to their team's view.

• supervisor: can access reports on course progress for the entire company population, both in aggregate and in detail.

• company admin :reserved for the company contact, who can independently manage the user list, organize simulation campaigns, and configure company-level options

Assigning multiple roles

You can assign multiple roles to the same user. To do this:

• add multiple columns in the CSV file,

• map each column to the role field during import.

Correct role format (case-sensitive)

Roles must be entered in the UTF-8 CSV file exactly as follows:

• studente

• teamleader

• supervisor

⚠️ All other roles (e.g., company admin) cannot be imported via CSV and must be assigned manually. For roles with special privileges, please contact Cyber Guru support.

Teams and team-based gamification

Before sending the user list, we recommend performing the following checks:

• Make sure all email addresses are valid and correctly formatted.
• Check that there are no spaces in the email and username columns.
• Ensure there are no duplicate emails or usernames.
• Verify that all required fields are present for each user.
• Check that the file is saved in UTF-8 CSV format.

By following these guidelines, you can ensure the user list is imported correctly into the platform, making it easier to manage your training program.