Knowlege base

Description and Architecture

Article ID: 62
Last updated: 20 May, 2022

In companies with a large number of phones, unattended phones could be used to make personal calls. Imagicle Phone Lock is the most effective solution to avoid this kind of abuse. Thanks to Phone Lock, company employees can easily lock their phone line, preventing unauthorized people to use it and avoiding any surprise on the company's phone bill.

Phone Lock allows the users to lock or unlock own phone line, on all phone devices associated to it, by hitting IP Phone's Services button, select Phone Lock XML service and entering a PIN code. When the phone is locked, incoming calls may still be answered (or dropped), while outgoing calls are dropped or re-routed to any number (i.e. a voicemail service). Calls to emergency numbers or other specific numbers/ranges might be still available, depending on applied Global Settings.

The users can verify own locking status from a padlock icon or a text message appearing on phone display.

If a user forgets his/her PIN, the UC Suite administrator can reset it through the web interface.

Locking the phone can optionally clear call registry, including the list of missed, received and placed calls.

Phone Lock supports Cisco Unified Call Manager (CUCM/BE6K/BE7K), Cisco HCS or Webex Calling Dedicated. Webex Calling MultiTenant and Cisco Call Manager Express (CCME) are not supported.

Phone Lock is a server based application which can control the telephony traffic using either:

  • TAPI (Telephony Application Programming Interface)
  • CURRI (Cisco External Call Control Profile)

Note: Starting from Imagicle 2020.Spring.1 release, Phone Lock TAPI engine can selectively lock overlapping extensions, if associated to different partitions and different phone devices.

Product architecture

When Phone Lock detects a call being initiated, it retrieves the user associated to relevant phone line in the UC Suite users' list. Some of the user's properties control the status of the IP phone.

The phone line can be locked by the user for privacy reasons or fraud prevention, either from the phone services interface, from Jabber/Webex client's "Phone Lock" gadget or through the UC Suite web interface. The phone line can also be locked by the administrator.

The phone status is stored in Phone Lock users' list and it can be easily checked and changed through the web interface. When the user accesses the XML service on the IP phone, lock icon is toggled in the list accordingly.

Note: If you are leveraging FAC (Forced Authorization Codes) or CMC (Client Matter Codes) to initiate an outbound call, please do not enable Phone Lock feature. Phone Lock operates at phone device or line level, so other phone devices/lines can still initiate outbound calls using FAC/CMC code of a blocked user.

Available Blocking Methods 

Imagicle Phone Lock allows phone line locking by means of below three methods:

User's Lock

Each user can autonomously lock own phone line/device from the following interfaces:

  • User's web portal
  • Administrator's web portal
  • Jabber/Webex Phone Lock gadget
  • XML Phone service
  • Imagicle One Desktop PC tool (manual or automatic)

Administrator's Lock

Phone Lock administrator can access to a specific Phone Lock web page called "Users". From this page, administrator can lock any phone line/device. Two option available:

  • Standard phone block, by clicking on padlock icon to toggle lock status. This locking method can be reverted by relevant user.
  • Administrative phone block, by checking user's "ADMIN LOCK" flag. This locking method does NOT allow user to revert own lock status. User should contact administrator to unlock own line.

In both cases, phone lock behaviour is the same as user's lock.

Budget's Lock

Third locking method implies having Budget Control module enabled, included in Imagicle call Analytics Enterprise license. If a user, or a group of users associated to same department/cost center, reach the assigned budget, the phone line(s) are locked in administrative mode, so if user wants to keep on calling, he/she needs to contact the administrator or wait for the beginning of next budget period.

Phone Behaviours

By default, Imagicle Phone Lock only acts on outgoing calls, but you can also enable incoming calls block by checking "Block Incoming calls when phone is locked" flag, available in Phone Lock's Global Settings.

Let's consider the following configuration:

Dotted lines represent device - user association, as detected by Imagicle Phone Lock + AXL services.

Some examples

  • User U1 is locked:
    • TAPI
      • On D1 and D3 phone sets appear “Phone is locked” message
      • All outbound calls from D1 and D3 devices are dropped
      • Outbound calls from other devices are allowed
    • CURRI
      • On D1 and D3 phone sets appear “Phone is locked” message
      • Outbound calls from line L1 (on both D1 and D3) are dropped
      • Outbound calls from other lines are allowed
  • User U2 is locked:
    • TAPI
      • On D2 phone set appears “Phone is locked” message
      • All outbound calls from D2 device are dropped
      • Outbound calls from other devices are allowed (even those performed from line L2 on D1 phone set)
    • CURRI
      • On D2 phone set appears “Phone is locked” message
      • Outbound calls from line L2 (on both D1 and D2) are dropped
      • Outbound calls from other lines are allowed
  • User U1 is locked, L2 is included in the whitelist, conference call
    • TAPI
      • On D1 and D3 phone sets appear “Phone is locked” message
      • Outbound/inbound calls on line L2 are allowed
      • If L2 starts a conference call by including U1, conference is allowed
      • If U1 starts a conference call by including anybody but L2, conference is dropped
      • If anybody but L2 starts a conference by including U1, conference is dropped

Lock status on the IP Phone

Depending on Cisco IP Phone model/series, different notification methods are available to show a graphical "lock" icon or a text message on phone display.

Status icon + text popup

If IP phone supports XML popup message/graphic push, then the following notification appears:

Text-only popup

If IP phone supports XML popup message push, then the following notification appears:

TAPI-based text notification

If IP phone is monitored via CTI/TAPI, then the following notification might appear:

Lock notification included into Phone line text

This new method, available starting from 2020.Winter.1 release, adds phone line's lock status beside existing phone line label. This is the most compatible method, available to any IP Phone with an embedded display. See below screenshot sample:

Budget Lock Notification

If a user has been locked due to own Budget overrun, all phone devices associated to user's line show “Line DN is locked” message, where DN is the primary extension number.

TAPI-based locking engine

With this configuration you need to install Cisco TSP on the UC Suite Server. Through it, Phone Lock is notified about events related to the monitored IP Phones.

Main advantages of this architecture is an easy configuration on the CuCM. You only have to associate all the phones to an Application User. This method also allows to selectively lock phone devices associated to overlapping extension numbers.

ECC-based (CURRI) locking engine

Cisco Unified Communication Manager (Unified CM) 8.0(1) and later support the External Call Control (ECC) feature. This feature enables an external route server to take some call routing decisions in place of the CallManager.

Whenever a call is performed, if the called number matches an external call control enabled pattern, Cisco unified CallManager issues a routing request towards the external route server. The call routing request contains the calling party and called party information.

Imagicle UC Suite receives the request, applies business logic, and returns a call routing response that informs CUCM about call allowance.

This allows Phone Lock to route or block a call based on the lock status of the device.

Blocking Technology Comparison

The following table summarizes the differences between the blocking technologies available since Imagicle UC Suite Winter 2014:

Feature TAPI ECC-CURRI
Requires PNP modifications No Yes
Requires CTI Phone Control Yes No
High Availability (Active - Standby) No Yes
Load Balancing (Active - Active) No Yes
Block Time (time elapsed before blocking the call) few milliseconds Instantaneous (calls are blocked during routing)
Support Shared Lines Yes No
Support overlapping numbering plans Yes No
  • ECC-Curri is more scalable than TAPI, it has been successfully tested with more than 100 requests per second
  • ECC-Curri might need Numbering Plan configuration changes
  • ECC-Curri blocks call before routing, there is no ringback neither missed call notifications for the called
  • ECC-Curri doesn't need any additional module to install on UC Suite
  • ECC-Curri supports Load Balancing out of the box

  • TAPI blocks the call after call has been already routed. The caller could hear a short ringback and the called party could get a missed call
  • TAPI needs a CTI-enabled Users that monitors all the involved phones
  • TAPI doesn't support Load Balancing
  • TAPI needs Cisco CallManager CTI manager service running
  • TAPI supports shared lines and overlapping numbering plans

Locking logics Summary table

Extension mobility support

Phone Lock supports extension mobility. In this case, it blocks the line entered in the First Extension Number field of the user associated to the CUCM End User.

Compatible devices

While using ECC-based locking engine, ANY phone device can be locked, including analog sets. If TAPI-based engine is chosen, it works with CTI-monitorable phone devices only. Visual notification of locking status is obviously available to IP Phones with a display only.

Article ID: 62
Last updated: 20 May, 2022
Revision: 11
Views: 1831
Print Export to PDF Subscribe Share
This article was:  
Prev   Next
Administration Guide     Configuration Task List