AuthenticationFX Overview

Overview

AuthenticationFX is a Windows Service from UnifiedFX that can be used to simplify and off-load authenticated requests to a Cisco IP Phone web server, for example phone screen shots or remote key-presses.

Authorisation of requests to a Cisco IP Phone's web server is based on the configured Authentication URL, more details on the default CUCM authentication mechanism can be found here: Cisco IP Phone Web Server Authentication

There are occasions when it is preferred to use an alternative to the default CUCM authentication feature, some examples are:

• Simplified configuration eliminating the need for device association for all phones in a cluster
• Off-loading authentication request from CUCM
• Complex multi-cluster environments
• Extension Mobility Cross Cluster (EMCC)

AuthenticationFX  Installation

AuthenticationFX is available on request by emailing sales@unifiedfx.com.

To install the AuthenticationFX Windows Service, open a command prompt and execute the following:

"%ProgramFiles(x86)%\UnifiedFX\PhoneView\AuthenticaitonFX.exe" install

sc start AutomationFX

Note: To uninstall the service use the following:

"%ProgramFiles(x86)%\UnifiedFX\PhoneView\AuthenticaitonFX.exe" uninstall

Once the AuthenticationFX service is installed and running it hosts a web application on port 8080, if that port is not available or it is preferred to use a different TCP Port number it can be changed by creating/updating the following registry entry:

[HKCU]\Software\UnifiedFX\AuthentiationFX\PortNumber (String Value)

Note: The AuthenticationFX service will require a re-start to use the updated Port Number

CUCM Configuration

In order to use the AuthenticationFX service with CUCM it is necessary to update the "URL Authentication" & "Secured Authentication URL" within Enterprise Parameters with the following URL:

http://[AuthenticationFX_IP_Address]:8080/ccmcip/authenticate.jsp

Note: If the port number (via the registry entry above) was changed then update the above URL to use that port number instead.

AuthenticationFX Configuration

To configure AuthenticationFX open the following URL in a web browser on the same machine AuthenticationFX is running on:

http://localhost:8080/

Note: If the port number (via the registry entry above) was changed then update the above URL to use that port number instead.

Within the Admin web interface enter and apply the following:

• UserID
• Password
• Cisco UCM IP Adress

Note: The UserID/Password credentials entered will automatically authenticate for all IP Phones eliminating the need to associate devices with CUCM. Therefore when configuring PhoneView the 'Phone Control' user should be configured with the same user credentials above. This will ensure that all authenticated requests to IP Phones from PhoneView will be authenticated immediately without the need to associate

 By default all authentication requests that do not match the UserID/Password entered within AuthenticationFX will be forwarded to the CUCM system IP Address. In some situations there may be an other authentication system, either custom or from another 3rd Party. If this is the case then you can enter a Custom URL  within the AuthenticationFX Admin web page.