InfinityOne - Adding Users

Before You Begin

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:

  1. Login using an administrator account.
  2. Navigate to Administration -> Account page.
  3. Click to  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 desktop application, mobile app, or web browser interface. In fact, a user can access InfinityOne from any of these interfaces with the same user account. For telephony applications, E-MetroTel strongly encourages using either the InfinityOne desktop application or the InfinityOne mobile app. An account must be created for each user regardless of which way they plan to access the InfinityOne server.

There are three methods to add users:

  1. Self-Registration
  2. By Invitation
  3. Add User
  4. 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.
IOneRegForm_0.png

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

Login using the administrator account.
Under Administration -> Users, you will find a Invite Users  icon on the top right corner of the screen.
Clicking the icon will take you to a page 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.

iOneInstallerAddUsers2 (2).png

You may disable the confirmation email in the Administration -> Accounts -> Registration settings and changing the Require account confirmation field to False.
IOneRegConfirm_1.png

Remind users to check their spam and junk folders; very often these confirmation emails are filtered by the email servers.

Method 3: Add User

Login using the administrator account.
Under Administration -> Users, you will find an Add User  icon on the top right corner of the screen.
Clicking the icon will open up a form for adding the user.
iOneInstallerAddUsers3b.png

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.

Email User's email (must be unique).
Allowed Extensions User's authorized extensions (if they have more than one).
Phone Numbers Provision a User's phone number (extension).
Password User's password.
RANDOM button Create a random password.
Password confirmation User's password again.
Role

User's default role.

Enable Softphone Enable the softphone.
Join default channels Automatically subscribe the user to all configured default channels.
Confirmed? Check so the user does not need to confirm their account if desired.
Send welcome email Send the user a welcome email with a link to the InfinityOne application.
CANCEL button Discard the edits in the form and close the panel.
SAVE button Save the changes.
It is recommended to setup one additional user as an administrator. This is your backup administrator in case you forget the administrator password and cannot recover it.

Bulk Upload (coming soon)

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 CVS file with the same type of user information as you would using the 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
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 WorkHomeMobile. 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
Role

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
Confirmed? If you want some users to automatically be confirmed, enter true. To force a use to confirm their account, enter false.  
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:

  1. 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.
  2. 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.
  3. Each user's name must be in the format of "First Last" or "Last, First"
  4. You may enter as many user-data lines as required.

Sample CSV Files

The following are some examples of CSV files:

Example 1.

CSV file:
Name, Email, Extension, Enable softphone
"Test, One", [email protected], 200, true
"Two Test", [email protected], 201,
"Test, Three", [email protected], 202,

Modified Defaults:
Username: "name"
Password: "temp"


Results in the following 3 user accounts:
iOneBulkCSVUploadEx1.png
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.


Example 2.

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

Modified Defaults:
none


Results in the following 3 user accounts:
iOneBulkCSVUploadEx2.png

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.
 

Example 3

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,,,

Modified Defaults:
none


Results in the following 3 user accounts:
iOneBulkCSVUploadEx3.png

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

Page Tags: 
admin guide
webRTC
infinity
One
iphone