UCX Suite, SSO and Users' Synch integrations

By selecting the “Integrations” button on Admin Home Page’s left-most panel or by clicking on “Integrate UCX Suite” menu option, you can access to the Integrations page, which currently includes the following three options:

• UCX Suites: Allows to connect an on-prem Imagicle UCX Suite or UCX Cloud Suite to the UCX Platform portal, to provide a direct access to UCX Suite web portal.

• Single Sign-on (SSO): Allows to enable Webex SSO and a generic SAML-based or OpenID-based SSO authentication for the users associated to the UCX Platform and UCX Suites.

• User Synchronization: To provision UCX Platform users against MS Entra ID source.

First time you access this page, above integrations are likely empty, except in the case your infrastructure includes an Imagicle UCX Cloud Suite: in that case, relevant UCX Suite entry should be already added by Imagicle Cloud team.

UCX Suites Integration

Please click on + Create to add an UCX Suite. The following window pops-up:

Just enter a name of your choice to identify the Imagicle UCX Suite instance and then add a https URL including instance FQDN, which allows to reach the instance from any workstation and subsequently properly perform SSO authentication.

You can also add multiple URLs, to handle a redundant cluster or public/private addressing, but only the one flagged with yellow star is accessible to customer.

By clicking on Create , a new window pops-up, displaying the Client ID and the Client Secret to be associated to the Imagicle UCX Suite instance:

Above parameters should be added in UCX Suite’s System Parameters. In this way, the Imagicle instance is connected to the Imagicle UCX Platform and it can leverage own Cloud applications like Voice Analytics, Virtual Receptionist, Voice Virtual Agents and Cognito-based Single Sign-on.

Single Sign-on Integration

Please click on + Create to add a SSO method. The following window pops-up:

Within above window, first of all you are invited to choose the preferred SSO integration among:

• Open ID Connect: Standard SSO protocol widely used by several Identity Providers.

• Webex: native Cisco Webex Calling SSO protocol to login to its Control Hub.

• SAML: Another standard SSO protocol widely used by several Identity Providers.

SSO integration(s) added in this UCX Platform are applied to all UCX Suite(s) integrated within the same Platform.

Open ID Connect

Once “Open Id Connect” is selected from pull-down menu, you are invited to perform the configuration of your Identity Provider by leveraging the Redirect URI proposed in the window:

Once the IdP configuration has been applied, the procedure returns Client ID, Client Secret and an Issuer URL. Just enter all of them in above window and hit Create to enable SSO for UCX Platform and UCX Suite users.

Webex SSO

Thanks to Imagicle native Webex Calling integration, enabling Webex SSO is very easy. By selecting “Webex” from pull-down menu, the following window appears:

Just toggle the switch to the right, to get SSO authorized. Then hit Create to enable Webex SSO for UCX Platform and UCX Suite users.

SAML

Once “SAML” is selected from pull-down menu, you are invited to perform the configuration of your Identity Provider by leveraging the Redirect URI and Entity ID proposed in the window:

Once the IdP configuration has been applied, the procedure returns a metadata XML file to be uploaded in above window. Once done, just hit Create to enable SSO for UCX Platform and UCX Suites users.

Users Synchronization Integration

Please click on + Create to add a provisioning source. The following window pops-up:

Select Entra ID data source from pull-down menu and toggle the authorization switch.

You can optionally configure data source filters to import selected users only. Filters are highly recommended for organizations with large directories.

Available fields to be filtered:

• email - User’s email address

• department - User’s department

• officeLocation - User’s office location

• location - User’s city/location

• phoneNumber - User’s primary work phone number

Basic Filter Syntax

For further information about the LDAP filters syntax, please refer to this article.

Once done, hit Create button to validate Data source filters.

If the filter includes invalid data, an error message "Invalid LDAP filters" is displayed. Please correct filter data and try again.

You are redirected to Microsoft’s authentication page. Please enter your Microsoft Entra ID credentials to sign in:

A new pop-up window asks you to Review the permissions requested by the Imagicle application and eventually Grant consent for the application to access your directory:

Ensure you have sufficient privileges to consent on behalf of your organization.

After the successful authentication, the integration window is greyed out and it hangs for few seconds while the system processes your authentication and creates the actual integration. Create button turns to a “loading” animated icon, as below sample:

If the integration process fails, the following window is displayed:

Please review entered data and try again until successful.

Final Integrations web page layout

Once UCX Suite, Single Sign-on and Users Synchronization integrations have been accomplished, the Integrations web page should have a layout like below sample:

Depending on your environment, this page might includes multiple UCX Suite integrations and multiple SSO integrations. Users Synch integration is unique, so you can’t add (Create) a new one.

If multiple SSO integrations are in place, please bear in mind that each time a UCX Platform or UCX Suite login is performed, user is prompted to choose proper SSO Identity Provider before entering credentials.

By clicking on each UCX, SSO or User Synch integration, you can display relevant data and remove it by hitting the button. See below Entra ID sample:

Webex Integration Restrictions

If you have an active Webex Users' Synchronization Integration configured by Imagicle Support team, you can’t add new User Synchronization Integration and you can’t modify/delete it through this interface. Please contact Imagicle Support to amend the configuration.

UCX Suite Pin Icon

Each UCX Suite entry includes a pin icon, by default unselected. If you click on pin icon, then relevant UCX Suite entry will appear into UCX Platform Home web page, allowing other users to access UCX Suite web portal.