It is recommended to setup at least one additional user as an administrator. This is your backup administrator in case you forget the administrator password and cannot recover it or your administrator account is accidentally locked.
Default Roles and Channels
Depending on the method used to add a user, the default role assigned to the new user and the default channels joined depends on what is configured under Administration – Accounts.
To view and make changes:
- Login using an administrator account.
- Navigate to Administration – Accounts page.
- Expand the Registration section.
Field | Description |
---|---|
Default Registration Roles | Default value is guest. This is the default role when a user is added via Self-Registration. |
Default Guest Account Rooms | This is the list of default channels for guest accounts. To remove all channels and leave it blank, enter a space character. |
Default Invitation Roles | Default value is user. This is the default role when a user is added By Invitation. |
Invited users join default channels | Default value is True. This is to allow invited users to automatically join the defined default channels. |
Adding Users
InfinityOne accounts are required for each user connecting via the mobile app or web browser interface. In fact, a user can access InfinityOne from any of these interfaces with the same user account. An account must be created for each user regardless of which way they plan to access the InfinityOne server.
There are four methods to add users:
- Self-Registration
- By Invitation
- Add User
- Bulk Upload
Method 1 – Self Registration
Send the InfinityOne URL to all users. (For example: https://ucx.infinityone.app:21326)
- The URL will take users to the login page.
- Users can click on the Register a new account link on the login page to register themselves.
This feature can be disabled under Administration – Accounts – Registration, and selecting Disabled from the Registration Form dropdown.
You can control the privileges associated with Self Registration users and the channels that they have access to through the Default Registration Roles and the Default Guest Account Rooms fields.
See section describing Default Roles and Channels.
Method 2 – By Invitation
Navigate to Administration – Users page, click on the Invite button on the top right.
This will open a panel where you can enter a list of email addresses (separated by a space).
- The system will send out an invitation to each email with a link to register.
- The link will take them to the registration page.
- After registration is complete, the user will receive a confirmation email that must be confirmed by clicking the confirmation link.
You may disable the confirmation email in the Administration Accounts –Registration settings by toggling the Require account confirmation field to OFF.
Remind users to check their spam and junk folders; very often these confirmation emails are filtered by the email servers.
Method 3 – Add User
Navigate to Administration – Users page, click on the +New button on the top right.
This will open up a panel for adding the user.
This third method allows you to set the confirmed status and send a welcome email. However, the administrator will need to enter a password (or generate a random password) and communicate the password to the user separately. The advantage of this approach is that you do not have to worry about people finding the invitation and confirmation emails in their spam folder.
Field | Description |
---|---|
Name | User’s full name. |
Username | User’s username (case-insensitive and must be unique). Username may contain letters, numbers, periods, dashes and underscores, where period cannot be the first or last character. Although not recommended to have a single character as the username, but if using only a single character it must be a letter. |
User’s email (must be unique). | |
Language | Choose from the drop-down list. |
Phone Numbers | Configure the user’s phone number (extension). |
Password | User’s password. |
Password confirmation | User’s password again. |
Role | Select user’s role from the drop-down list. You can select more than one role. |
Enable Softphone | Toggle ON to enable the softphone. |
Join default channels | Toggle ON to automatically subscribe the user to all configured default channels. |
Confirmed? | Toggle ON to require user to confirm their account. |
Send welcome email | Toggle ON to send the user a welcome email with a link to the InfinityOne application. |
RESET button | Reset all the fields to default. |
SAVE button | Save the changes. |
Method 4 – Bulk Upload
If you have a large number of user accounts to create, you may also add users through a Bulk Upload of user information compiled in a CSV (Comma Separated Values) based file.
Preparing the CSV file
To use the bulk import capability for InfinityOne Account users, you must create a CSV file with the same type of user information as you would using Method 3 – Add User method as described above. The possible data fields to use in the CSV file are as follows:
Header Field | Description | Default Value |
---|---|---|
name | User’s full name, in the format of “First Last” or “Last, First“ | Required in CSV |
username | No fixed format if included specifically for a user in the CSV file. If omitted, you must specify if you want to create user names based on the first portion of the email address (before the @ character) or to use First.Last format based on the name field. | Based on email |
User’s email (must be unique). | Required in CSV | |
extension | User extension (Optional entry) | None |
label | The descriptive label associated with the users extension. Choice of Work, Home, Mobile. A blank entry will use the chosen default setting. | Work |
password | User’s password. Can be unique to each user if included for that user in the CSV file. If any password entries are blank, the bulk upload use the portion left of the “@” in email address, or a default password can be identified that will be assigned to all users with a blank password field. | Defaults to user portion to left of “@” in email |
roles | Role(s) to be assigned to that user. Multiple roles can be assigned if they are contained within quotes (eg. “role 1, role2” or “role1 role2”) | user |
enable softphone | If you wish for a user to have their softphone enabled automatically, enter true. If you specifically want a user’s softphone to not be enabled, enter false. A blank entry will use the default setting. | true |
join default channels | To subscribe each user to all configured default channels, enter true. If not, enter false. A blank entry will use the default setting. | true |
confirm account | If you want some users to automatically be confirmed, enter true. To force a use to confirm their account, enter false. | true |
send welcome email | To force the sending of a welcome email to a user, enter true. If you want some users to not receive welcome emails, enter false | false |
The structure of the CSV file is as follows:
- First Line: The first line can be a header line using the Header Fields to help organize the data as you create it. If you are using a header line, the field names can be in any order.
- Subsequent Lines: A single line is required for each user. At a minimum the line must contain a name and a unique email for each user, and the remaining settings can be automatically generated based on a combination of those two fields and the chosen default settings.
- Each user’s name must be in the format of “First Last” or “Last, First”
- You may enter as many user-data lines as required.
Sample CSV Files
The following are some examples of CSV files:
Name, Email, Extension, Enable softphone
“Test, One”, [email protected], 200, true
“Two Test”, [email protected], 201,
“Test, Three”, [email protected], 202,
Defaults:
Username: “name”
Password: “temp”
Results in the following 3 user accounts:
The usernames are of the form First.Last since the default setting was “name”.
The password for each of the three accounts is temp since it was listed as the default.
Name, Email, Password, Extension, Roles, Enable softphone, Send welcome email
“Test, One”, infinityoneadmin.gmail.com, C0mpl3xPa55W0rd,200, admin, true, false
“Two Test”, [email protected], , guest,false,true
“Test, Three”, [email protected], PleaseChange!, user, 201,false,true
Defaults: none
Results in the following 3 user accounts: The usernames are based on the user part of the email address since there was no default setting. The password for username: infinityoneguest is infinityoneguest since it was not explicitly specified in the CSV file.
Name, Email, Password, Extension, Roles, Enable softphone, Send welcome email, Join default Channels, Confirmed, Label, Username
“Test, One”, [email protected], C0mpl3xPa55W0rd, 200, “admin”, true, false, true, true, Work, SecondAdmin
“Two Test”, [email protected], ,202, “guest”, false, true, false,,Home,
“Test, Three”, [email protected], PleaseChange!, 201, “user”, false, true,,,
Defaults: none
Results in the following 3 user accounts:
The usernames are based on the user part of the email address since there was no default setting. The password for username: infinityoneguest is infinityoneguest since it was not explicitly specified in the CSV file. The username for “One Test” is SecondAdmin because it was explicitly defined.
Uploading the CSV file
Once you have created your CSV file and identified any desired modifications to the default settings following the description provided here, please contact E-MetroTel support for assistance in the upload.
Editing User Information
The Bulk Upload only allows new user accounts to be added in addition to the existing accounts already defined. Once a user account has been created, you cannot change the settings for that user via the bulk upload. This applies to accounts that have been created by any of the mechanisms described in this document, including accounts created by Bulk Uploads.
To edit a user account, navigate to the InfinityOne Administration – Users page, select the user account you wish to modify, and then click Edit.
Removing Users
There are two methods to remove users. Users can either be deactivated or deleted. Care should be taken before deciding whether to deactivate or delete a user.
Deactivate a user
- Prevents that user from any new activity associated with that user account such as logging in, getting room updates, viewing wallboards, or receiving email updates for new activity or mentions.
- Preserves all material posted by that user. This allows important information contributed by that user to remain in each of the channels that the user participated in.
- This is typically the preferred method of removing an employee account, particularly if that user was a knowledge worker and contributed to important company discussions and decisions.
- A deactivated user account can be activated if desired.
Delete a user
This will immediately remove all records associated with that user account, including any messages posted by that user and is permanent.
Deleting a user cannot be undone. Please read this section carefully before deciding whether to delete or deactivate a user account.
Deactivate or Delete a User Account
- Login using an administrator account.
- Navigate to Administration – Users page and select the user account.
- Click on the 3 dots
icon and select Deactivate or Delete from the drop-down list.
- You will be prompted to confirm, click Yes.
Re-Activating a User Account
- Login using an administrator account.
- Navigate to Administration – Users page and select the user account.
- Click on the 3 dots
icon and select Activate from the drop-down list.
- You will be prompted to confirm, click Yes.
Unlocking Users
InfinityOne tracks the number of consecutive attempts to log in to an account using an invalid password and will lock the account to prevent brute force attacks. Remind users that they should reset their password using the built-in Forgot your password? mechanism prior to the fifth attempt.
The only way to unlock the account is using an administration account. For this reason, E-MetroTel strongly recommends creating a minimum of 2 administrator accounts so that if one administrator account is locked out because of too many failed attempts, the other one can unlock it.
Account Lockout
After 5 consecutive invalid password entries have been entered by a user during the login procedure, the users’ account will automatically be locked and will require an administrator to unlock it.
- The account will be locked for all new attempts to log in regardless of the user interface (browser or mobile).
- Users already logged in on another interface will be able to continue working and can even change the password, but cannot unlock the account access without the support of an administrator.
- If they log out of their account from that interface, they will not be able to re-login until the account has been unlocked.
Unlocking the account
- Login using an administrator account.
- Navigate to Administration – Users page and select the user account.
- Click on the 3 dots
icon and select Unlock from the drop-down list.
- You will be prompted to confirm, click Yes.
At this point, the user will be able to log in using their existing credential.