Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide
Using the APIs for remote setup and booking
Cisco TMSBA Programming Reference Guide
Page 12 of 53
Usage requirements
This section describes the licensing, permission, and authentication requirements for using the APIs.
Licensing
One of the following licenses must be available to make full use of Cisco TelePresence Management Suite
Extension Booking API:
Extension Booking API:
n
One Cisco TMS Application Integration License for each server using the API.
n
One Cisco TelePresence Management Suite Extension Booking API license per 25 registered systems.
The following API functions require one of the above licenses:
n
GetRecordingAliases
n
GetTransactionsSince
n
SaveConference
n
SaveConferenceRecInstance
n
SaveConferences
The remaining API features do not require special licensing for use. Contact your Cisco reseller/partner for
more licensing information.
more licensing information.
Booking rights
Importing from Cisco TMS and booking meetings through the API requires authentication with Cisco TMS.
All users who will book meetings using the API must be members of a group whose permissions include
Booking. Users who book on behalf of others also require Book on behalf of permissions.
All users who will book meetings using the API must be members of a group whose permissions include
Booking. Users who book on behalf of others also require Book on behalf of permissions.
Permissions in Cisco TMS are set on a group level. To modify the permissions set for a group:
1. Go to
Administrative Tools > User Administration > Groups
.
2. Hover over the desired group, click the drop-down button and select Set permissions.
3. In the Booking section, under Misc, check Booking and, if appropriate, Book on behalf of.
4. Click Save.
NTLM authentication
On a default Cisco TMS installation, any API requires the use of Windows Challenge Response or NTLM
authentication.
authentication.
Not all environments support this authentication mechanism (non-Windows based environments), and you
therefore may need to allow for Basic Authentication:
therefore may need to allow for Basic Authentication: