Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide
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
Booking API:
Booking API:
n
One Cisco TMS Application Integration License for each server using the API.
n
One Cisco TelePresence Management Suite 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.
There are two possible models for user authentication.
Service user books on behalf of users
The simplest approach is configuring one service user in Cisco TMS for your client, and granting this user
Book on behalf of permissions as described below.
Book on behalf of permissions as described below.
This model is only appropriate if all users with access to the client can be granted the same permissions in
Cisco TMS, as booking on behalf of someone will create a new Cisco TMS user in the default group if the
user does not already exist.
Cisco TMS, as booking on behalf of someone will create a new Cisco TMS user in the default group if the
user does not already exist.
All users book for themselves
If you need to set up different booking rights per user, or block some users from booking altogether, each user
must authenticate with Cisco TMS individually through the API.
must authenticate with Cisco TMS individually through the API.
Setting up 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.
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:
Cisco TMSBA Programming Reference Guide
Page 13 of 68
Using the APIs for remote setup and booking