Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

4-32

CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise

Release 8.5(1)

Chapter 4 Building Your Application

Logging In and Logging Out an Agent

The following table lists the settings to use to control how duplicate log in attempts are to be handled:

Table 4-2

:CTI OS Server Registry Settings (To control duplicate log in)

To create keys to control duplicate log in attempts:

Step 1

Open the registry and navigate to: HKEY_LOCAL_MACHINE\Software\Cisco Systems,
Inc.\CTIOS\[CTI Instance
Name]\CTIOS1\EnterpriseDesktopSettings\AllDesktops\Login\ConnectionProfiles\Name\[Profile
Name].

Step 2

Right click in the registry window and select New->DWord Value. The new value appears in the
window.

Step 3

Change the value name to custom_WarnIfAgentLoggedIn.

Step 4

Double-click the value to open the Edit DWORD Value dialog box.

Step 5

Enter 1 in the Value data field to set the value to true, or 0 to set it to false.

Step 6

Repeat steps 2 through 5 for the value custom_RejectIfAgentLoggedIn.

How to Prevent Another Agent Log In with Incorrect Credentials

In order to prevent another agent log in with incorrect credentials, use the SendIdentifyClientRequest
method to identify and detect the log in request.

Set the Method Argument to Nil. To invoke this method, use the session object.

The following examples demonstrate the method in:

C++: int SendIdentifyClientRequest()

.NET: CilError SendIdentifyClientRequest()

Java: int SendIdentifyClientRequest()

Goal

custom_WarnIfA
gentLoggedIn

custom_RejectIfAge
ntLoggedIn

To warn the agent of the
duplicate log in attempt,
but to allow the agent to
proceed

To allow the agent to
proceed with the duplicate
log in attempt with no
warning

To not allow the agent to
proceed with a duplicate
log in attempt

0 or 1