1 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voic Interoperability – 4.0(5) Voice Connector features Rahul Singh April 4, 2005 EDCS-

222 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector Features VPIM Directory Update Broadcast messaging with Cisco Unity Express (CUE) or Other Unity organization supporting VPIM. Private Secure Messaging

333 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features VPIM Directory Update This is an extension to VPIM. We can create, modify or delete VPIM type remote subscriber based upon a VPIM message. This feature is disabled by default. It should be enabled and configured for each VPIM type delivery location. This feature includes 2 components – Voice Connector to generate directory messages based on the incoming VPIM messages. CsVPIMConnector – Create, modify or delete the VPIM subscribers, based upon the directory message. This doc focuses the details of Voice Connector.

444 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features VPIM Subscriber Creation Options page

555 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features VPIM message and vCard Sample From: "Firstname Lastname" To: "EAdministrator-Unity RahulsChild" … --==AvVoice==3a34db0a f-946c-e6048ddf13c2 Content-Type: text/directory; charset=us-ascii; profile=vCard Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="Admin.vcf" BEGIN:vCard FN:FirstName Lastname N:LastName;FirstName;Mr;Jr;; TEL:type=voice; TEL:type=home; TEL:type=Cell; VERSION: 3.0 END:vCard --==AvVoice==3a34db0a f-946c-e6048ddf13c2 Content-Type: Audio/32KADPCM Content-Transfer-Encoding: base64 Content-Description: VPIM Message Content-Disposition: inline; voice=Originator-Spoken-Name

666 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features VPIM Directory message BEGIN: vCard X-CS-CN: 0 X-CS-DIRECTORY-UPDATE: Message-Header X-CS-MESSAGE-TYPE: Extracted-Directory-Data X-CS-TIME: :59:01 X-CS-GUID: e049f5a-2f98-4cc0-980a-a b6b X-CS-DOMAIN: rahulsex2k.ecsbu-lab-sea.cisco.com X-CS-UNITY-LOC-ID: 532 X-CS-ORIGINATOR: CS-IVC X-CS-VERSION: 1 VERSION: 3.0 END: vCard BEGIN: vCard X-CS-CN: 1 X-CS-DIRECTORY-UPDATE: CS-Update-Subscriber X-CS-MAILBOX-TYPE: subscriber X-CS-LIST-IN-DIRECTORY: 1 N: LastName;FirstName;Mr;Jr;; X-CS-UID: TEL:type=voice; TEL:type=home; TEL:type=Cell; SOUND;TYPE=x-wav;ENCODING=BASE64;VALUE=CID:05404b52-505c-45e4-809e-4cbae7202def X-CS-TIME: :59:01 VERSION: 3.0 END: vCard

777 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector generating Directory Message The Voice connector generates the directory messages based upon the VPIM location settings. Finding Name - If Use Sender’s vCard option is set, then the N: field is searched first. If N: field is not present, then FN: field is used. If None of them are present, then this is an invalid vCard and no Directory message will be created. FROM: fieldFinding Phone number- The voice connector removes the Remote prefix from the phone number specified in the FROM: field, if any configured for the VPIM location and gets the Remote mailbox ID. This field is set as X-CS-UID: in the directory message. It also copies all the occurrences of the TEL: field in the vCard. This field may get used based upon the option selected in - Map VPIM Subscriber extensions to. Continued…

888 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector generating Directory Message Voice Connector searches the Global Catalog for the VPIM message Sender. If a VPIM subscriber exists and the Modify option is enabled, then a Update type directory message is generated. If the VPIM subscriber doesn’t exists and Automatically Create VPIM subscriber option is enabled, then an ADD type directory message is generated. If the message type is NDR. And the VPIM subscriber exists, then a Delete type directory message is created. It Includes the VPIM subscriber Remote Mailbox ID- it is Phone Number – Remote prefix configured for that VPIM location. It also includes the NDR status code. It will be used to determine, if the subscriber delete is enabled for that NDR status code.

999 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Sample directory Message for Delete Subscriber BEGIN: vCard X-CS-CN: 0 X-CS-DIRECTORY-UPDATE: Message-Header X-CS-MESSAGE-TYPE: Extracted-Directory-Data X-CS-TIME: :25:20 X-CS-GUID: bffc4-7bd3-44ce-a d60d7d4f6 X-CS-DOMAIN: rahulsex2k-invalid.ecsbu-lab-sea.cisco.com X-CS-UNITY-LOC-ID: 532 X-CS-ORIGINATOR: CS-IVC X-CS-VERSION: 1 VERSION: 3.0 END: vCard BEGIN: vCard X-CS-CN: 1 X-CS-DIRECTORY-UPDATE: CS-Delet box X-CS-MAILBOX-TYPE: subscriber X-CS-UID: X-CS-SMTP-STATUS-CODE: X-CS-TIME: :25:20 VERSION: 3.0 END: vCard

10 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Broadcast messaging It works among multiple Unity servers in the same Exchange Org as a part of Unity digital networking. Unity creates USbms_ mailbox for broadcast messaging. A broadcast message goes to this mailbox, CsBMsgConnector service monitors this mailbox. It picks up the message from that mailbox and adds records to the BroadcastMessage table in the UnityDb. It also adds records to the BroadcastMessageRecipient table to track, which user has listened to the message. The Broadcast messaging feature is also available for VPIM integration with CUE (Cisco Unity Express) and other Unity Organization supporting VPIM. The broadcast message is transferred via Voice Connector

11 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Broadcast messaging extended to Unity family products via VPIM The system broadcast messaging is extended to CUE, with extension to the VPIM protocol. The Broadcast messaging MIME fields are - X-Cisco-SBM-ID: ad88d8db-5af1-4cc9-b928-cfc0bdc26320 X-Cisco-SBM-CUSTOM1: 457DEC91F176FCFA7503B8D20D620FB1 X-Cisco-SBM-START-TIME: Tue, 16 Sep :36:10 GMT X-Cisco-SBM-END-TIME: Tue, 14 Nov :37:14 GMT Start time and End time is optional, if they are not present (blank is not allowed), then it will be assumed as start immediately and no end date. The first 2 fields are there to identify and authenticate the broadcast message. The Voice connector will send the Broadcast message to all the USBM_ mailboxes. This broadcast message is for the whole Unity organization. If the message is NDRed by Voice connector due to Invalid Broadcast message properties, then it will have the NDR reason code of From Unity TUI, if no end date is provided, it is set to 30 days by default.

12 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Broadcast messaging Mime to MAPI property mapping X-Cisco-SBM-ID AVP_SBM_ID X-Cisco-SBM-CUSTOM1 AVP_SBM_CUSTOM1 X-Cisco-SBM-START-TIME AVP_SBM_START_TIME X-Cisco-SBM-END-TIME AVP_SBM_END_TIME

13 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Private Secure messaging Private Secure messaging feature uses the public keys of all the Unity and Voice connector servers to encrypt the Voice message. The unity servers setup automatically installs certificate for that Unity server. The Voice Connector setup installs certificate for the Voice Connector. The public key for the certificate is copied in the AD. The property is copied to the Computer Object, representing that computer in AD. The public key goes in the ciscoEscsbuLocationObjectId field, ciscoEcsbuObjectType is set to 14. The public keys are replicated via AD and stored locally in the Unity database. All of the private keys are stored on the local server, so that older messages can be decrypted, if the certificates have changed.

14 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Private Secure messaging encryption decryption via Voice Connector The Private secure messages are always encrypted, when it remain in the Unity organization. If we enable Voice Message Inter-operability feature, then the encrypted message cannot be transfer to a foreign VM system. AMIS protocol doesn’t support message sensitivity, so a private secure message to an AMIS location will be always NDRed by voice connector. VPIM and Bridge Location have an option to Decrypt outgoing private secure messages and Encrypt incoming private messages. Continued…

15 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Private Secure Messaging configuration for Bridge type Delivery Location

16 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Private Secure messaging encryption decryption via Voice Connector If the Bridge or VPIM location is configured to Decrypt Outgoing messages, then the Voice connector will decrypt the message voice attachment and send that message. The encrypted voice attachment has a decoy wav file, which contains the message that this an encrypted voice message. If the Bridge or VPIM location is NOT configured to Decrypt Outgoing messages, then the Voice connector will NDR the message. If the Bridge or VPIM location is configured to Encrypt Incoming messages, then the Voice connector will encrypt the message voice attachment(s). Voice connector uses Exchsrvr\VoiceGateway\bin\EncryptMsg.txt file to put the Confidential message text in message body. Voice connector uses Exchsrvr\VoiceGateway\bin\ UnityDecoy.Wav file to put the Confidential message voice in voice attachment.

17 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Public key for Unity in AD Computer Object

18 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Public key for the Domain Controller computer in AD

19 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice connector encryption, decryption process Voice connector gets the public key of all the Unity and Voice connector servers from the AD and encrypts the message voice attachment(s) using those public keys. So any Unity server or Voice connector can decrypt that message. If the message is coming from Unity to voice connector, then Unity has used the voice connector’s public key to encrypt the message. So voice connector can decrypt the voice attachment.

20 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector Diagnostic logging Voice connector runs on the Exchange server. It logs all the details and errors in the diagnostic file. Example of successfully Encrypting voice attachment- 04/05/05 15:56:32 1B80 FUNCTION (hr=0) "CAvEncrypt::EncryptWavFile(...)": WavCryptoProcess Succeeded (LINE=711 FILE=g:\views\rahuls_u4x\un_doh3\exvoicegateway2000\gwivc\avencrypt.cpp) For Broadcast message it logs the SMTP header part, which would be helpful to determine the properties.

21 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector Settings Voice connector configuration can be set via the property page of the Voice connector in exchange system Administrator. The Voice connector needs restart after any setting changes. There are some registry configurations for voice connector. The base key is - HKEY_LOCAL_MACHINE\SOFTWARE\Active Voice\AvIvc Continued…

22 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector Registry Settings [HKEY_LOCAL_MACHINE\SOFTWARE\Active Voice\AvIvc] "LogLevel"=dword: (values can be 1-5) "LogRecycleDays"=dword: "LogFilePath"="g:\\logfiles\\" "LoadVpimCodec"=dword: "StoreFiles"="G:\\IVCOut\\“ – The Voice connector will store a copy of the outgoing smtp message in this folder. New registry settings added in "MTS_OUTMonitoringEnabled"=dword: "MTS_OUTMonitorIntervalInMS"=dword:000927c0 "MTS_OUTOldMailIntervalInSeconds"=dword:0002bf20 "DeleteArchiveFolderMessages"=dword: "AliasToForwardBadMailsTo"="unaddressedmessages1a4d35c8“

23 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector in Exchange System Administrator

24 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector setting tab in Exchange system Administrator- General Settings

25 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector setting tab in Exchange system Administrator – Address type and cost settings

26 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector setting tab in Exchange system Administrator – Logging settings

27 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector message queue in Exchange System Administrator

28 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Opening ADSIEdit Configuration Container

29 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Voice Connector object in AD

30 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Troubleshooting Check Voice connector diagnostic log For more information change the logging level to Function Use exchange message tracking tool to track the message Check exchange Queue for messages stuck in MTS-OUT queue. Set StoreFiles registry setting to save a copy of outbound message. Check the message content and properties. Disable it by deleting the registry key, when done.

31 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features CsEventSink CsEventSink is used in VPIM integration. It is a hook in the IISAdmin (SMTP Service). It get called for each message going through the SMTP transport. The primary job of this Event Sink is – Direct the incoming VPIM messages to Voice Connector. Continued..

32 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features CsEventSink CsEventSink registry Settings - [HKEY_LOCAL_MACHINE\SOFTWARE\Active Voice\AvTransSink] "LogLevel"=dword: – 0 disabled, 1 Enabled "LogFilePath"="g:\\logFiles\\CSE\\“ – Logfile path "StoreFiles"="G:\\CSEOut\\“ – Hidden setting. It will store the messages to filesystem. Disable it when done troubleshooting. The IISAdmin service should be restarted after any registry change.

33 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features Reference Materials Read the Networking Guide! More information for specific features- 405TOI_VPIMDirectoryUpdate.exe – For VPIM Directory Update 4.0(5) broadcastmessaging.exe – For Broadcast messaging 4.0(5) privatesecuretoi.exe – For Private Secure messaging

34 © 2001, Cisco Systems, Inc. All rights reserved. Voice Connector Features © 2002, Cisco Systems, Inc. All rights reserved. Presentation_ID