This knowledge base has been replaced with
To ensure continued access to our resources, update your bookmarks or links to

Sangoma CX Multi Factor Authentication Technical Guide (Formerly Sangoma Contact Center)

Edited: 04/17/2023
Access: Everyone
Supports: Business Voice, Business Voice+

( Sangoma Contact Center has been rebranded as Sangoma CX )


Multi-factor Authentication (MFA) is an authentication method that requires the user to provide two or more verification factors to gain access to a resource such as an application or online account.

MFA is a core component of a strong Identity and Access Management (IAM) policy. Rather than just asking for a username and password, MFA requires one or more additional verification factors, which decreases the likelihood of a successful cyber attack.

Sangoma CX version 6.69.25 supports MFA. The implementation relies on Google Authenticator App as the second verification factor. Any user (Administrators, Supervisor, Managers and Agents) can activate MFA to increase the security on their accounts.


  1. Users must have an Android or IOS device with the Google Authenticator App installed and linked to their Sangoma CX user (To link a device see the Activating FMA steps below). This App is available on the following URLs:
    1. Android: Google Authenticator - Apps on Google Play
    1. iOS: Google Authenticator on the App Store


  1. This feature is available in Sangoma CX v.6.69.25.and higher. The version number is displayed on the bottom left corner of the Sangoma CX UI.

Missing image link-1

  1. For Agents, MFA is limited to for use with the Agent Panel UI. If MFA is activated, agents won’t be able to login on Sangoma CX Agent App or Sangoma CX Salesforce Connector
  1. If a user activates MFA on his/her account and does not have the device to provide the MFA token, the user will not be able to login into the platform. Administrators have the ability to disable MFA for a user by unchecking the “MFA Enabled” option under their accounts.

Missing image link-2

How to turn on FMA

Access Your User Profile

  1. Log into the Sangoma CX.
  1. Open the “ My profile” screen.
  1. For Admins, Managers, Supervisors:
    1. Click on your user name in the top right corner of the page.
    1. Select My Profile.

Missing image link-3

  1. For Agents (Agents Panel UI):
    1. Click on your profile picture in the top right corner of the page.
    1. Select My Profile.

Missing image link-4

Activating FMA

Once users are on the “My Profile” screen follow these steps

  1. On the My Profile Screen click on “MFA Setting”.
  1. The “Multi Factor Authentication Screen” will open:
    1. Enter your password in the “Password” field.
    1. Click the “Confirm Your Password” button.
    1. If the user password is valid a QR code will appear.
    1. Open the Google Authenticator App on your device.
    1. Scan the QR code to import the account.
    1. Once the Google Authenticator App has completed importing the account a token will be displayed.
    1. Return to the Sangoma CX profile window.
    1. Enter the token provided by the App in the Token field and click the “Send Token” button.
    1. If the token is valid the user account and the device having the linked account is binded for future logins.

The following images provide a visualization of the process of Activating FMA.

Missing image link-5

Login Using FMA

  1. Using your browser Navigate to the Sangoma CX, URL.
  1. The login screen will appear.
  1. Enter your Username in the “Login” field and click on “Next”.
  1. When prompted enter your “Password” and click on “Next”.
  1. Once validated, a token will be presented in the by Google Authenticator App on the device with the binded user account.
  1. When prompted enter the token provided by Google Authenticator App in the “MFA Token” field and click on “Login”.
  1. If validated the user will have access to the Sangoma CX platform.

The following images provide a visualization of the login process.

Missing image link-6

Disabling FMA for a User

Administrators can disable MFA on any user by unchecking the “MFA Enabled” option in using the user edit screens.

  1. Login to Sangoma CX using your Admin Credentials
  1. Select System from the menu at the top of the page.
  1. Select the Users option.
  1. Click on the Username of the user to be updated.
  1. Uncheck the MFA Enabled option.
  1. Click Save.

Missing image link-7

49 users have voted.

Technical Support

If you have any technical questions or need to get in touch with Tech Support, please email us at to open a ticket.

Customers With Disabilities

Sangoma values its customers with disabilities. If you are in need of assistance with a Sangoma service or feature, please email

Website Suggestion

Do you have a suggestion about our Knowledge Base website, let us know?