MiVoice Office Application Suite - Technical Manual
6900 Handset Teleworker
Engineering Guidelines > 6900 Handset Engineering Guidelines > 6900 Handset Teleworker

69xx phones are supported as Teleworkers on the MiVoice Border Gateway (MBG) using a SIP User. The following section outlines the configuration required to deploy a teleworker on MBG.

 

(All the above are 'one off' configuration items unless the infrastructure changes)

MiVoice Border Gateway Requirements

To use MiVoice Office Application Suite with a MiVoice Border Gateway (MBG) for remote connections, the MBG must be running v10 or higher and be configured in Gateway mode.

 

Stage 1 - Configure MBG IP details in MiVoice Office Application Suite

For the MCS to be able to support teleworker SIP extensions (either Phone Manager Desktop Softphones or 69xx phones), it needs to know two pieces of information:

  1. The internal IP Address of the MBG
  2. The external IP Address of the MBG

The internal IP address of the MBG needs to be known for two reasons. The first is so that the MCS can identify which 69xx phones it receives requests from are actually Teleworkers. The second is so that it knows how to communicate with the MBG's API for SIP User deployment.

The external IP address of the MBG needs to be known so that it can be passed to Phone Manager Desktop and 69xx phones when they are registering their SIP connections.

Configure the MCS with the MBG's Internal IP Address:

Configure the MCS with the MBG's External IP Address for each Node:

Configure the MCS with the MBG's External IP Address for Remote Client Connections:

 

Once the MCS has the information above, it will be able to identify teleworker 69xx phones and will be able to pass them the information required to connect to the MBG.

The External IP Address entered into the remote section of the Client Locations will also be used by Phone Manager when connecting to the MCS Server.

 

 

Stage 2 - Configure Port Forwarding on MBG

69xx Phone Port Forwarding on MBG

69xx phones use the following TCP port to communicate to the MCS server:

Port Target Description
TCP 8202 MiVO App Suite Server Used to communicate to the MCS server to provide configuration, user data etc.

The other ports associated with 6900 phones (LDAP, TFTP, Multicast, Syslog) should not be opened up through the MBG.  

Configuration of the SIP devices associated with the 6900 is done automatically by the MiVoice Office Application Suite. Please refer to the Automatic Teleworker Provisioning section for more information.
 Configuring MBG Port Forwarding for 69xx Phones

 Complete the following configuration on the MBG:

SNAT must be enabled on all the port forwarding rules added.

 

Stage 3 - Configure MBG ICP connection for PBX

Add one or more Nodes as ICPs on the MBG:

Ensure the 'Hostname or IP Address' setting used for the ICP matches the IP Address configured for the Node on the MCS server.

 

Stage 4 - Configure API integration for automatic provisioning

Automatic Teleworker Provisioning

To simplify the deployment of SIP teleworker phones, the MCS can use an API on the MBG to automatically provision SIP Users for SIP extension. This provides the following benefits:

For automated provisioning to work end-to-end between the MiVO 250, MiVO App Suite and MBG, the MiVO 250 must be running at least 6.3 SP1 and any CT Gateway must be running at least 5.0.64.

 

Enabling the Rest API for Automatic Teleworker Deployment

For the MCS to be able to communicate with the MBG and deploy teleworker SIP Users, it requires some connection information as well as a valid API token from the MBG. This section documents how to configure the MBG to accept API requests and the steps involved in setting up the token exchange. To complete this process, access to the MBG website and the MCS configuration website are required.

Once the Rest API has been enabled on MCS and it has a valid token, the MCS server will take any SIP extension that has been configured with remote authorization credentials and provision it onto the MBG. Any existing credentials configured for SIP Users on the MBG will be overwritten with those configured on the MCS.
Step 1: Create a new web service consumer on the MBG:
Step 2: Complete the token request from MCS to MBG:

If the verifier is correctly entered, the MCS should be able to successfully request an API token from the MBG. This token will allow the MCS to provision SIP Users on the MBG for a period of 12 months. To avoid having to repeat the above process every 12 months, the token's expiry date can be extended on the MBG by pressing the 'Renew' button against the token in the 'Final tokens' section of the web services page.

The internal IP address configured in the Nodes section of the MCS website must match the IP Address configured on the corresponding ICP on the MBG website. If they do not match, the MCS will not be able to find the correct ICP when deploying a teleworker phone.

For information on how to provision SIP Users manually, please refer to the Manual Teleworker Provisioning section of the MiVoice Office Application Suite Technical Manual.

Each Teleworker connection on the MBG requires a Teleworker license.

Stage 5 - Configure each device for remote access

Automatic Teleworker Device Deployment

 Once the Rest API has been configured, MCS will automatically provision teleworker SIP extensions on the MBG.

The MCS will provision any SIP extension that has had the 'Use remote authorization credentials' setting configured against it:

Provisioning a SIP Teleworker Extension

To instigate the MCS provisioning of a SIP extension on the MBG, navigate to the 'Configuration -> Site Settings -> Phone Systems -> [Your PBX Name]' page. Edit the required SIP extension and then check the 'Use remote authorization credentials' check box. The MCS will pre-populate the remote authorization name and password with random values. Pressing save will update the credentials stored for the extension and will start the teleworker provisioning process.

 

Un-Provisioning a SIP Teleworker Extension

To un-provision a SIP extension from the MBG, follow the provisioning process but uncheck the 'Use remote authorization credentials' check box. Once save is clicked it will instigate the MCS removing the SIP User from the MBG.

This will only work for SIP extensions that were previously provisioned by the MCS. If a SIP User was manually added to the MBG it may need to be manually removed. If a SIP extension has been provisioned on the MBG by the MCS, the MBG's ID for the SIP user will be displayed on the SIP Authorization form of the extension in MCS.
When using a MiVoice Border Gateway, the internal authorization name must match the extension number of the phone otherwise authentication with the telephone system will fail.
Any SIP extension provisioned using this method will automatically have a random remote authentication username and password assigned if they do not have them set already.
In addition to configuring SIP Users for teleworker extensions, they must also be configured for any SIP Hot Desk extensions that will be logging into a teleworker phone.

Stage 6 - Manually add the Configuration Server address for each remote phone

Remote Phone Configuration for SIP Firmware

The following steps outline how to manually configure the Configuration Server connection details for each teleworker 69xx phone.

Each phone must be updated to SIP firmware before this configuration can be completed. It is recommended to upgrade from MiNET to SIP firmware on the local network and then manually configure the phone before sending it to the teleworker location.

After a reboot, the phone will connect to the MCS server and download firmware other configuration information.

It is possible that there will be more than one reboot at this stage as the firmware update is completed

The handset should now be registered with the MCS server.

The Phone will have Line 1 and Line 2 showing as the Top Sofkeys.

Unlike for local deployment as 'Setup' button will not be available and the SIP extension needs to be configured in the MCS server.

The 'Phones' page within the configuration section of the MCS website can be used to view whether the handset has been identified. The MCS uses the handsets MAC Address to uniquely identify it.