<logging>

The <logging> element defines parameters used to encrypt call logs and recordings for the application.

Parameter

Type

Description

encryption_key

String

The public RSA encryption key, expressed in hexadecimal.

If specified, call logs end in the *.enc extension to indicate encryption, even if no encrypted items actually appear in them.

encryption_key_tag

String

An optional free-form-string tag. Can be used to look up the private encryption key in a company’s database.

internal_encryption

String

Recognizer uses the public key to encrypt a symmetric key which is used in turn to encrypt the sensitive data. Currently supported values are AES-192 (the default) or AES-256.

wcr_encrypt

Boolean

Whether to encrypt whole call recordings for calls to the application (1), or leave them unencrypted (0). In order to activate this feature, an encryption_key must be specified. The wcr_encrypt value takes precedence over the setting of the server.rtp.wcr.encrypt service property in the Management Station.

Encrypted whole call recordings end in the *.enc extension.

Log encryption is supported as an option for the secure_context feature. For a discussion of this topic, see Logging security and Setting up encryption.

The Voice Platform installation includes example public and private keys (example_key.pub and example_key.prv) in the %NSSSVRSDK%/certs/ directory. You can use these keys to test encryption. However, since these keys are installed with Voice Platform and thus generally available, they are not secure for use in a production environment. For information on generating your own keys for production, see Setting up encryption.

wcr_output_type

Integer

Specifies if the call is saved in one file or split into several files. Valid values are:

  • 0 (one file per mid, default): A mid contains audio in both directions, for example, party A to Voice Platform and Voice Platform to party A. The filename is: NUAN-MM-SS-Host-Session_ID-WCR-rtpmidnum.wav
  • 1 (one file per call): The filename is: NUAN-MM-SS-Host-Session_ID-WCR.wav
  • 2 (one file per audio stream): An audio stream contains audio in one direction, for example, party A to Voice Platform or Voice Platform to party A.
    • Files containing output from either party (A or C) are identified by “received” in the filename. For example: NUAN-MM-SS-Host-Session_ID-WCR-rtpmidnum_received.wav.
    • Files containing output from Voice Platform are identified by “transmitted” in the filename. For example: NUAN-MM-SS-Host-Session_ID-WCR-rtpmidnum_transmitted.wav.

Setting wcr_output_type takes precedence over the setting of the server.rtp.wcr.outputtype service property in the Management Station.

wcr_suppress_dtmf

Integer

Suppresses the insertion of DTMF audio tones in the whole call recording. Valid values are:

  • 0 (default): Allow insertion
  • 1: Disable or suppress insertion

Setting wcr_suppress_dtmf takes precedence over the setting of the server.rtp.wcr.suppressdtmf service property in the Management Station.