McDewey

Multi-vendor documentation library · semantic search · MCP endpoint at /mcp

Page 267

↗ View in doc context
page
267
source
cucm/v15/jtapi-dev-guide/jtapi-dev-guide.md
chunk_id
cucm::v15::jtapi-dev-guide::jtapi-dev-guide::260

If the user credentials are not valid, this method throws a PrivilegeViolationException. If the TFTP server or CAPF server address is not correct, this method throws an InvalidArgumentException. Every instance of an application requires a unique client certificate. If a multiple instanceID is configured in the Cisco Unified Communications Manager database, applications can call this interface multiple times to install a client certificate for every instance. Pre-conditions—When calling this interface, an application should have network connectivity with the Cisco Unified Communications Manager CAPF and TFTP servers. Post-conditions—This process installs client and server certificates on the JTAPI application machine. Parameters: user—Name of the CTI application user that is configured in the Cisco Unified Communications Manager database instanceID—Application instance ID that is configured in the Cisco Unified Communications Manager database. Everyinstance of an application requires a unique ID. authCode—Authorization string that is configured in the Cisco Unified Communications Manager database. You can use the authCode only once for getting certificates. ccmTFTPAddress—IP-Address of the Cisco Unified Communications Manager TFTP server. ccmTFTPPort—IP-Address port number on which the Cisco Unified Communications Manager TFTP server is running. The Cisco Unified Communications Manager TFTP server usually runs on port 69. Ifnull, the default value is 69. ccmCAPFAddress—IP address of the Cisco Unified Communications Manager CAPF server. ccmCAPFPort—Port number on which the Cisco Unified Communications Manager CAPF server is running, as defined in the Cisco Unified Communications Manager Service parameters. If the value is null, the default value is 3804. certificatePath—Directory path where the certificate needs to be installed Throws: InvalidArgumentException—This exception gets thrown for an invalid TFTP server or CAPF server address. PrivilegeViolationException—This exception gets thrown for an invalid user, instanceID, or authCode. IsCertificateUpdated public boolean IsCertificateUpdated (java.lang.String user, java.lang.String instanceID) This interface provides information about whether client and server certificates are updated for a given user/instanceID. Parameters: user—UserName as defined in the Cisco Unified Communications Manager Administration. instanceID—InstanceID for the specified UserName. Returns—True if certificates are already updated; false if certificates are not updated. updateServerCertificate public void updateServerCertificate(java.lang.String ccmTFTPAddress, java.lang.String ccmTFTPPort, java.lang.String ccmCAPFAddress, Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 203 Features Supported by Cisco Unified JTAPI Transport Layer Security (TLS)