Knowlege base

Secure Call Recording

Article ID: 506
Last updated: 14 May, 2020

Effective Summer 2017, Imagicle Call Recording can record Encrypted calls, i.e. calls which are placed with Secure SIP (SIP/TLS) for the signalling and SRTP for the audio stream. Please note this requires with CuCM versions 11.0 or newer.

Before trying to record Secure calls, make sure Imagicle Call Recording is fully configured to record Non-Secure calls with clear RTP.

Mixed mode must be enabled on your Unified CallManager, and you must be able to effectively place and receive secure calls to and from the agents' phones.

Secure calls recording supports forking (Cisco Built-in-Bridge technology), Dial-in (direct call) and Network based (gateway) recording.
However, please consider that calls established in SRTP will be recorded by the phone (leveraging its built in bridge) althought the "Gateway Preferred" option is selected as recording preferred method on CUCM (see this Cisco article). 

CuCM Configuration for Secure Call Recording

To be able to record secure calls, you need to:

  1. Configure Enterprise Parameters for SRTP.
  2. Load the Imagicle Call Recording certificate on CuCM, categorized as CallManager-trust
  3. Create a SIP Trunk Security Profile which references the Imagicle Certificate
  4. Create a SIP trunk which points to the Imagicle Application Suite machine, port 5071, and uses the SIP Trunk Security Profile

Warning: if a firewall is set between the CallManager nodes and the Application Suite servers, the TCP port 5071 must be allowed on both sides.

Configure Enterprise Parameters for SRTP

The longest cipher key length supported by Imagicle Call Recording for SRTP voice encryption is 128 bit. Therefore, the SRTP cipher set configured on CUCM shall allow such key length.

On CUCM admin portal: 

  • Select System -> Enterprise Parameters
  • Move to the "Security  Parameters" section and ensure the parameter SRTP Ciphers allows AES-128 bit cipher algorithm (hence choose "All Supported Ciphers").

Download the Imagicle Call Recording Certificate from IAS

Up to 2020.Winter.2 release

When Imagicle Call Recording service starts, it creates a security certificate which is valid for the IAS server on which it was generated. It must be downloaded from the web interface, and loaded onto CuCM.

To get the Imagicle Call Recording certificate:

  • Login to the IAS web interface as Administrator
  • Click on Recording, then Global Settings
  • Expand the "Secure Recording" section
  • Click on the Download button to download the Imagicle Call Recording certificate and save it to your PC. The file extension is .pem.

From 2020.Spring.1 release and above

Please follow the procedure highlighted here.

Upload Imagicle Call Recording Certificate on CUCM

  • Log on CuCM as Administrator
  • Select OS Administration
  • From the menu, choose Security, Certificate Management
  • Press the "Upload Certificate / Certificate chain" button
  • As certificate purpose, choose "Callmanager-trust"
  • Enter a description, then select the Call Recording Certificate from your PC and upload it
  • Press "Close" to go back to the certificate list.

  • Press "Find" to list the certificates. Locate the Imagicle certificate you just uploaded.
  • Take note of the certificate Common Name for later use. By default, the certificate Common Name will match the computer name of the machine on which it was generated.

Warning: Changing the Computer Name will invalidate the certificate. If you change the IAS server computer name, you need to regenerate the Call Recording certificate.

Warning: The digital certificate will last 5 years from the day it was generated, which is the day the product was installed. If required, the certificate can be re-generated for additional 5 years, by following this procedure.

Creating a SIP Trunk Security Profile with Encryption

From the Cisco Unified CM Administration menu, select System, Security, Sip Trunk Security Profile.

Add a new item with the following properties:

  • Incoming Transport Type: TLS
  • Outgoing Transport Type: TLS
  • Incoming port: 5071
  • Accept Out of Dialog Refer: enabled
  • Accept Unsolicited Notification: enabled
  • X.509 Subject Name: enter the Imagicle Call Recording Certificate Common Name you noted before.

Please mind the certificate name. Do not enter the certificate description. Do not enter the full Subject Name. Enter the Common Name.

If you are unsure, select System, Security, Certificate, and press the Find button. Locate the Imagicle certificate. The Common Name is displayed in the Subject Name column, just after CN=

NOTE: If you need to manage multiple Call Recording nodes, you must specify in the X.509 Subject Name of the SIP Trunk security profile the list of the involved certificates CN (one for each Imagicle server), separated by comma. 
For instance:  WIN-TN8S35M6791,WIN-TN3V45K2V27 

Creating a SIP Trunk for Secure Recording

A Secure Sip Trunk is a standard SIP trunk with the following properties:

  • A descriptive name, such as CallRecording_SIP_Trunk_Encrypted
  • SRTP Allowed enabled
  • Run On All Active Unified CM Nodes enabled

  • Destination Address: the IP Address of the Imagicle Application Suite server
  • Destination Port: 5071
  • SIP Trunk Security Profile: reference the one you just created

Route Pattern to the SIP Trunk

The route pattern must:Create a new Route Pattern pointing to the the Imagicle Call Recording Sip Trunk for secure calls. Make sure you did not select the Call Recording Sip Trunk for standard calls.

The pattern should match the Pilot number in the Recording profile you are going to create.

Call Recording Profile for Encrypted Calls

Create a new Call Recording Profile for encrypted calls. Assign a Pilot number of your choice, and a suitable CSS. The CSS must allow the phones to reach the Route pattern you just created.

IP Phone Configuration

The IP Phone configuration to record secure calls is similar to the non-secure call recording. Just select the Call Recording Profile for Encrypted Calls. Please refer to non-secure calls configuration page of this guide.

Remember to enable IP phones for call recording even if you chose the "Gateway preferred" option in the line settings you need to record (the voice gateway cannot fork SRTP streams).

Troubleshooting Secure Calls

Before testing any other recording technology, try to record a Dial-In call.

  • Choose two phones supporting Encrypted calls, say 101 and 102. Place a call from 101 to 102 and check  that a lock appears on the display, meaning that the conversation is encrypted
  • On Imagicle Application Suite, create a user with Primary Extension 101 and the permission to use Call Recording, which is the default
  • Place a call from 101 to a number matching the Secure Call Recording Route pattern

You should hear a beep, or, in case of permission mismatch, a message informing that the calling number is not entitled for voice recording.

If the call does not seem to reach the Call Recording application, most probably there is a problem with the certificate. Ensure you referenced the correct certificate Common Name.

How to detect a certificate problem

If you suspect a certificate problem, you can check the detailed error in the Call Recording voip stack log file.

To enable detailed voip logging:

  • Edit the this file: <installation dir>\StonevoiceAS\Apps\Recorder\Settings\Recorder.Opal.config.xml
  • Add the following line:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <preference key="logging.level" value="4" />
 </configuration>
  • Restart Imagicle Call Recording service

Once the logs are enabled:

  • Try to record a new call, for example dialing the Call Recording pilot number
  • Using your favorite editor, open the log file: <installation dir>\Var\Log\Recorder.Service\Recorder.Opal_<current date>.log
  • Look for a line similar to: Accept: error in state=SSLv3 read client key exchange A

This means that the TLS certificate exchange failed. Please review the above steps.

Article ID: 506
Last updated: 14 May, 2020
Revision: 23
Views: 1261
Print Export to PDF Subscribe Share
This article was:  
Prev   Next
Call Recording Reports     Product Integration API