Bell Canada WebSocket

Installation Guide

Version 1.6
July 27, 2020

Confidential – Do Not Disclose

Document Status: Review
Table of Contents

1 DOCUMENT OVERVIEW ...................................................................................................................... 3

1.1 DOCUMENT OBJECTIVE ..................................................................................................................... 3

1.2 REVISION HISTORY ........................................................................................................................... 3
1.3 DOCUMENT CUSTODIAN .................................................................................................................... 3
2 OVERVIEW ............................................................................................................................................ 4

2.1 USER COMMUNITY ............................................................................................................................ 4

3 INSTALLATION PRE-REQUISITES ..................................................................................................... 5

3.1 ADMIN RIGHTS .................................................................................................................................. 5

3.2 MICROSOFT LIBRARIES ...................................................................................................................... 5
3.3 IE WITH ENTERPRISE MODE OFF ........................................................................................................ 6
4 INSTALLATION STEPS ........................................................................................................................ 7

4.1 WEBSOCKET FILE DOWNLOAD: ......................................................................................................... 7

4.2 SILENT INSTALLATION: .................................................................................................................... 10
4.3 UI BASED INSTALLATION: ................................................................................................................ 12
5 INSTALLATION CONFIRMATION ..................................................................................................... 15

6 FAQ...................................................................................................................................................... 17
1 Document Overview

1.1 Document Objective

To provide store admins (e.g. store manager / store IT team) with all the required information to install
Bell Canada WebSocket on store machines (Windows OS desktops/computers/laptops).

1.2 Revision History

Revision Revision Author Summary of Changes

Date

0.1 2020-02-28 Rahul Gargate Draft

1.0 2020-03-03 Rahul Gargate Baselined
1.1 2020-03-17 Rahul Gargate Updated based in review comments after
installation by Fraud team
1.2 2020-03-27 Rahul Gargate Updated section 5 for installation
confirmation.
1.3 2020-05-19 Rahul Gargate Updated section 3 for pre-requisites.
1.4 2020-06-12 Rahul Gargate Updated section steps in Step # 4
1.5 2020-06-12 Rahul Gargate Updated section steps in Step # 4
1.6 2020-07-12 Rahul Gargate Updated sections 3.1, 5.
Added section 6.

1.3 Document Custodian

Current Owner Group Email Phone As of

28-Feb-2020
Danny Rego Senior Manager, [email protected] (514) 420-7517
Loss Prevention
2 Overview
Bell Canada WebSocket Installation is required to remove java dependency from Secure Auth / Retail
Machine Authentication system.

2.1 User Community

Group Name Usage Description Activity Physical Location
Corporate, Use IP based authentication Canada Wide
Dealers & Other No action required
Retail Stores
Corporate, Use Machine based Need to follow steps in Canada Wide
Dealers & Other authentication this document and
Retail Stores install WebSocket.
3 Installation pre-requisites

3.1 Admin rights

Admin Permissions are required to follow all the steps in this document. Please check with your local IT
team for “how to check/seek admin rights” OR follow below steps:
https://support.microsoft.com/en-gb/office/check-if-you-have-local-admin-rights-to-install-office-edc2f78a-
e6b7-4041-917b-8136afb0a654
Follow steps under “How to check if you're an administrator”

3.2 Microsoft libraries

“Microsoft Visual C++ 2015 Redistributable (x64) – 14.0 (Runtime libraries)” must be installed.
Please follow below steps to verify the same:

1. Click on Start / Windows / Magnifying glass button

2. Type Control Panel
3. Click on Control Panel

4. Under Control Panel Menu, click on “Programs and Features”. A list of programs already installed
on the system will be displayed.
 5. Under “Name” column, look for “Microsoft Visual C++ 2015 Redistributable (x64) – 14.0” (or any
higher version of Microsoft Visual C++). If the version (or any higher version of Microsoft Visual
C++) appears, please follow Installation steps.
6. If it is not installed, then click on below link to install it from Microsoft site before proceeding to
next steps. The Microsoft site link for downloading the library is provided below:

Microsoft Visual C++ 2015 Redistributable (x64) – 14.0 (Runtime libraries)

7. Select the appropriate version as per your system.

8. A pop-up will appear for “Run / Save”. Click on “Run” and wait for installation to get finished.

3.3 IE with Enterprise mode off

Under Internet Explorer, enterprise mode must be OFF in order to perform a login to any of the Retail
applications (like OneView, fastACT etc.) using WebSocket.
Open Internet Explorer and under Tool, look for “Enterprise mode”. It must be unchecked like in below
screenshot.
4 Installation steps
4.1 WebSocket file download:
1. Right click on below file and click on Copy

WebSocketAuthIDClientInstaller.msi

2. Click on Start / Windows button and type “File Explorer”.

3. On the left pane, click on Documents.

4. Paste the file under “Documents”

5. Right click on the file “WebSocketAuthIDClientInstaller.msi” and click on properties.
6. Look for “Location” attribute and select the attribute value which would be something like
“C:\Users\<user-name>\Documents”. Make sure the attribute value turns blue once selected.

7. Copy the attribute value by typing “Ctrl + C”

[Note: You may choose to save the copied attribute value in Notepad if required. This value will be required in
Step # 11 below.
To save it in notepad, click on Start / Windows button and type “Notepad” and paste the value in Notepad by
typing “Ctrl + V”]
8. Click on Start / Windows button and type “Command prompt”
9. Right click on the command prompt and click on “Run as administrator”.
10. Type “C:” and press Enter
11. Type “cd <space>” and then “Ctrl + V”
Please see below screenshot for reference:
[This is the same attribute value which was copied in step # 7]
12. Hit Enter

13. Follow steps in Section 4.2 (Silent installation or command line installation) OR Section 4.3 (UI
Based installation) based on your convenience.
4.2 Silent Installation:
Note: Below steps are in continuation to step#7 from section 4.1

1. Update below command to replace the [path] with the same path copied in Step# 7 in section 4.1

msiexec /i [path]\WebSocketAuthIDClientInstaller.msi /quiet /qn /norestart /log

[path]\install.log WEBSOCKET_SERVER_HOST=aa_wss.ca.com
LOCATION_SERVER_ECHO=*.bell.ca,*.virginmobile.ca,*.luckymobile.ca,*.bellmobilit
y.ca,*.bellmobilite.ca LOG_LEVEL=INFO
LOCATION_ORIGIN=*.bell.ca,*.virginmobile.ca,*.luckymobile.ca,*.bellmobility.ca,
*.bellmobilite.ca WEBSOCKET_SERVER_PORT=49500 ENABLE_SSL=true
2. Copy the command (after updating [path] ) and paste it on Command Prompt.
Please see below screenshot for reference

3. You will receive a command prompt pop-up which will be auto-closed once installation is
successful. To confirm please go to [path] again.
4. Please open the file install.log and look for below text at the end:
“Windows Installer installed the product. Product Name: CA WebSocket AuthID Client. Product Version:
1.0.0. Product Language: 1033. Manufacturer: CA. Installation success or error status: 0.”
At this point, WebSocket installation is completed successfully. Please follow steps
in “Section 5 – Installation confirmation” to verify.

If you do not see the text as mentioned in stpe#4, continue below in step# 5.
5. If the command does not run successfully, below pop-up will be displayed.

6. Possible issues:
 Re-verify if the path is correctly mentioned in the command
 Re-verify if the command is correctly copied and pasted
 Re-verify if the file is correctly copied on [path] (or any other path mentioned)
7. If the error continues, follow steps in “Section 4.3 – UI based installation”
4.3 UI based Installation:
Note: Below steps are in continuation to step#7 from section 4.1

1. On Command prompt, (under [path] ), type WebSocketAuthIDClientInstaller.msi and click on

Enter

2. When the window below appears, Click Next

3. Configure the information as shown in the below screenshot and click Next. Provide the
highlighted values.
Host Name/IP : aa_wss.ca.com
Port : 49500
Enable SSL (true/false) : true

Click Next

4. On the next screen, configure as shown below. Provide the highlighted values.
Location : <leave blank>
Client Origin : *.bell.ca, *.virginmobile.ca, *.luckymobile.ca, *.bellmobility.ca,
*.bellmobilite.ca
Log Level : INFO <Enter DEBUG if asked by Fraud team to investigate>
Click Next

Note: Log Level can be INFO or DEBUG

 5. Click next to confirm installation

6. Web Socket Auth ID client is successfully installed. Click close.

7. Close the command prompt.

At this point, WebSocket installation is completed successfully. Please follow steps

in “Section 5 – Installation confirmation” to verify.
5 Installation confirmation
1. Click on Windows button
2. Type Services
3. Click on “View local services”

4. Look for “CA WebSocket AuthID Client”. The status should be “Running”.

5. If the status is “Running”, WebSocket installation is complete. Please login to any Bell (Bell/Virgin
mobile/Lucky mobile) Retail activation application (like OneView, fastACT etc.) on Internet
Explorer 11. Please note that first time login after WebSocket installation must be done on
Internet Explorer 11. You may close this document after login is successful.
6. If you do not see the status as “Running”, please click on “Start the service”
7. IF you do not see “CA WebSocket AuthID Client” service, please follow steps in the document
again, see section 6 – FAQ.
8. If this does not resolve the issue, contact Bell Fraud management team.
9. Note:
Below directory will be created on your machines after successful installation.
This directory is necessary for secured login and must not be removed.
If you remove below directory / format the machine, you will need to follow the steps in this
document again starting from section 1. And then you will need to register the machine again by
contacting Fraud team.
C:\CA\WebSockets (screenshot on next page)
6 FAQ
1. Why “Run as administrator” is required in step# 4.1.9 or any other steps in this document?
“Run as administrator” is required to make sure the WebSocket service runs as administrator
and not a particular user. If the service runs under a particular user, other users on the machine
may not be able to login to Bell Retail systems.
2. If an existing Dealer/Retailer is setting up a new machine OR a new Dealer/Retailer is setting up
a machine for the first time, is it required to contact Bell Fraud management team?
Yes, in case of a new machine set-up (irrespective of new or existing Dealer/Retailer), you will
still need to contact Bell fraud management team and register the machine with machine-id and
one-time activation code received from Bell fraud management team.
3. I am getting an error as below (“Repair CA WebSocket AuthID Client” / “Remove CA WebSocket
AuthID Client”). What does this mean?

This means WebSocket AuthID installer is already installed on your system. Please follow steps
in Section “5 - Installation confirmation” to confirm if WebSocket is installed. If WebSocket is
installed, that means no further action is necessary and you can try login to any Bell
(Bell/Virgin/Lucky mobile) Retail application login.
If WebSocket is not installed, please check if the pre-requisites mentioned in section 3 and follow
the steps in the document again.
If this does not resolve the issue, contact Bell Fraud management team.
4. I see that WebSocket installation is successful as per section 5 – Installation confirmation but I
am not able to login.
- Check if you are using correct credentials
- If you have a new machine, your machine needs to be registered with bell Fraud
management team.
- If you have existing machine (already registered with Bell Fraud management team), login to
Internet Explorer 11. First time login may ask permission to run Java, please click on “Allow”.
Subsequent logins will happen using WebSocket AuthID.