The following sections describe the interface changes for TLS support in JTAPI. CiscoJtapiPeer.getProvider() public javax.telephony.Provider getProvider(java.lang.String providerString) throws javax.telephony.ProviderUnavailableException This modified interface takes a new optional parameter InstanceID. It returns an instance of a Provider object, given a string argument that contains the desired service name. Optional arguments may also be provided in this string, with the following format: < service name > ; arg1

val1; arg2

val2; ... Where < service name > is not optional, and each optional argument = value pair that follows is separated by a semicolon. The keys for these arguments are implementation-specific, except for two standard-defined keys: • login—Provides the login user name to the Provider. • passwd—Provides a password to the Provider. CiscoJtapiPeer in providerString expects a new optional argument: • InstanceID—Provides InstanceID for Application Instance. InstanceID is needed when two or more instances of an application want to connect to a Provider (CTIManager) through a TLS connection from the same client machine. Each instance of an application requires its own unique X.509 certificate to establish a TLS connection. If JTAPI attempts to open more that one connection with the same username/instanceID, CTIManager rejects the TLS connection. If instanceID is not provided, JTAPI randomly picks one of the instances of USER and, in that case, the connection may fail if a connection for the selected Instance already exists. If the argument is null, this method returns some default provider as determined by the JtapiPeer object. The returned provider is in the Provider.OUT_OF_SERVICE state. Post-conditions: this.getProvider().getState()

Provider.OUT_OF_SERVICE Specified by getProvider in interface javax.telephony.JtapiPeer Parameters providerString The name of the desired service plus an optional argument. Returns An instance of the Provider object. Throws javax.telephony.ProviderUnavailableException Indicates that a provider that corresponds to the given string is unavailable. CiscoJtapiProperties JTAPI provides an interface on CiscoJtapiProperties to enable or disable the security option and install the client/server certificates that are required to establish a secure TLS socket connection. Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 200 Features Supported by Cisco Unified JTAPI Transport Layer Security (TLS)