Skip to main content
Skip table of contents

Solution Prerequisites

Time Synchronization

An important consideration is time synchronization between related components. Communication between EF Server, Microsoft CRM Server, agent machines, and Cisco Finesse carry timestamps. If the system dates and time are not synchronized the system can produce unpredictable results. Therefore, please make every effort to adhere to the following time synchronization guidelines:

EF Connector, Microsoft CRM Server, agent machines, and Cisco Finesse should have their Time Zone and time configured properly according to the geographic region and synchronized. To configure the time zone, please see the instructions from the hardware or software manufacturer of the NTP server. Client applications and EF Connector should be synchronized to the second. This synchronization should be maintained continuously and validated on a regular basis. For security reasons, Network Time Protocol (NTP) V 4.1+ is recommended.

Access Prerequisites

For remote installation and configurations, the implementation team would require remote access privileges.

  • VPN connection/WebEx/TeamViewer is required to connect to the customer’s environment.

  • Remote access via RDP or similar is required to do installation and configuration of EF Server.

  • Administrative access to server machines is required to install EF Connector.

  • Admin access to Dynamics CRM is required to deploy CRM side configurations.

Product Prerequisites

Hardware Requirements

  • In the case of Single Server Deployment, you will require one server with the following specs:

  • In the case of Redundant deployment, two servers with the same specs are required. 

Item

Recommended

Notes

CPU

4 vCPU

Memory

8 GB

Disk Space

100 GB 

The minimum disk space requirement is 50 GB. The recommendation is to account for transactional storage and logs.

NICs

1

Only one interface card is required per virtual machine

Software Requirements

The following software must be installed on the server. These are required both for Single or Redundant deployment

Item

Recommended

Notes

Operating System

Windows 2012 R2 Standard Edition (x64)

Tested with this Operating System

Java

1.8

Tomcat

8.5

Internet Information Services (IIS) Manager

Latest version

INFO

The above Hardware / Software is only required if:

  1. you are running this connector with Cisco SSO ( this is applicable for both MS CRM Online / Offline)

  2. The connector is running with MS CRM Online via CIF 

Certificates for HTTPS

  • Certificates from a valid signing authority or Domain signed certificate are required for HTTPS protocol support

Ports Accessibility 

The following ports should remain open on the Firewall. The local security policy and any antivirus should also allow open communication on the following ports:

Type

Source Host

Source Port

Destination Host

Destination Port

HTTP/HTTPS

<Client Machine>

any

Cisco Finesse

8445,8443

HTTPS (Bosh)

<Client Machine>

any

Cisco Finesse

5222, 5223, 7071, 7443

HTTP/HPTTS

<Client Machine>

any

EF Server or Cloud-base Server
(e.g. https://CTIConnector.com/)

This  would only be required when we  deploy the application via CIF Framework

443, 445

NTP

<Client Machine>

any

NTP Server

123

DNS

<Client Machine>

any

DNS Server

53

  • <Client Application> is the agent machine where Agent is using EF Connector in the Browser

  • MS CRM should be accessible over the Agent Machine 

EF SSO Server Deployment Pre-requisites

Hardware Requirements

The hardware requirements will be same as mentioned here.

Software Requirements

Item

Recommended

Notes

Operating System

  • Windows (Windows 10) / Windows server 2012 R2 Standard Edition x64 (for windows based deployment)

  • Linux (Cent OS 7) (for Linux based deployment)

Supported and tested on these operating systems

Docker Community Edition

20.10.17 or above

Required for docker based deployment only

Docker Compose

1.29.2 or above

Required for docker based deployment only

Git Client 

1.8.3.1 or above

Required for docker based deployment only

Linux Utilities

  • wget

  • curl

Required for docker based deployment only

Port Utilization Requirements

The default port used by the service is port <1125> whereas it can be changed when deploying the docker image. Following ports should remain open on the Firewall. The local security policy and any antivirus should also allow open communication on the following ports:

Type

Source Host

Source Port

Destination Host

Destination Port

HTTPS

<Server Application>

any/ (default 1125)

<IDS Server>

8553

HTTPS

<ASDF Server>

HTTPS

<Client Application>

<Server Application>

any/ (default 1125)

Server Application = This is the backend application we will deploy for the SSO Utility. 

Client Application = Agent browser on which Agent will access the AccessToken.

IDS Server = Machine IP where Identity Service Management is deployed which is integrated with the finesse.

ASDF Server = Active Directory Federation Services through all SSO agents are authenticated

Supervisor agent requirement

Each of the Supervisor agents must be assigned at least one team.

Finesse Admin User

Finesse Admin User credentials are required 

Browser Requirements

  • Google Chrome Latest version

  • Firefox Latest Version

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.