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 (
@)
- underscore (
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:
0for login with credentials,1for SSO login.Role: the role assigned to the user within the platform (see "Role in the platform")
Additional User Information (aka "Organization")
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
rolesto 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:
studenteteamleadersupervisor
⚠️ 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
If the customer chooses to enable team-based gamification, it's necessary to clearly define which value will be used to identify teams and make sure this information is included in the CSV file. The team can be defined based on an existing field, such as Department, or created specifically for this purpose, even with a custom name. In any case, the team is mapped as New Organization, but when uploading to the platform, you must clearly indicate the criteria used to define team composition.
Team rankings are calculated by dividing the total points of all members by the total number of team members, so that every team, regardless of size, can compete on equal terms. Users can also change teams during the training program, for example, due to company reorganization; in this case, their progress up to that point is transferred to their new team.
Pre-import checks for the platform
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.