Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search Sign up Reseting focus

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

Trusted_Application_API_GeneralReference.md

Latest commit

History

91 lines (53 loc) · 7.33 KB

Trusted_Application_API_GeneralReference.md

File metadata and controls

91 lines (53 loc) · 7.33 KB Enabling communication services for the cloud

Discusses enabling communications services for the cloud via the Trusted Application API for Skype for Business Online Cloud.

Enabling communications services for the cloud

The Trusted Application API is in Developer Preview and not licensed for production usage. As part of Microsoft’s intelligent communications vision, we’re building extensible communications capabilities into Teams. For more Teams Developer information, see https://aka.ms/TeamsDeveloper.

The Trusted Application API is our vision of an extensible Skype for Business Online Cloud that meets your demand for powerful, back-end features. The API aims to provide developer opportunities similar to Skype for Business Server's Unified Communications Managed API (UCMA). in the cloud. The API enables a cloud-first approach and additional powerful features that aren't available to on-premises Skype for Business Server customers through UCMA.

Built on the Skype for Business Online Platform, the Trusted Application API lets a developer build immersive, smart, and interactive communication experiences and trusted services.

Evolution from on-premise server API to online service API

The Trusted Application API marks an evolution of the on-premises Unified Communications Managed API (UCMA) middle tier platform to a normalized and service-oriented architecture. Fundamentally, the core Platform Service that exposes the Trusted Application API shares the same compute and storage resources across multiple applications, tenants, and domains. It helps reduce operational costs and makes scaling easier as demand grows. At the same time, it guarantees to its service consumers and end users that communication resources and tenant/domain-specific application data are properly isolated to mitigate any security risks that would stem from untrusted tenants and applications.

Authentication and security

The Skype for Business Online Platform Service exposes Trusted Application RESTful APIs that require both:

For security and billing reasons, granting an application the permissions to access such APIs is a prerogative of Tenant Administrators rather than end-users. Once a Tenant Admin gives consent to use an Application (which may have implications on usage and billing) they may manage it to the extent of permissions that are usually bound to the domain (or a subset) they administer.

The Trusted Application API allows you to write SFB Online applications that act as a service endpoint and do not require a user context or identity. The most common scenarios are applications that schedule or manage on-demand meetings like a contact center type application, that can create on demand meetings to handle customer calls and add customer service representatives to the meeting, voice based call answering and routing bots.

Trusted Application architecture

The following diagram shows how the Trusted Application API is positioned as a middle tier Software as a Service component in Skype for Business Online. A 3rd party Service App can add value to an enterprise Skype for Business solution by providing a simple RESTful interface between a mobile client and the Trusted Application endpoint. For example, a Service App helper method can handle authentication token fetching and discovery services for a mobile client. It can call Trusted Application APIs to create new meetings and then return meeting join Urls to mobile clients that will join the meetings.

Architecture

Example solutions

Attendant console, Customer engagement / Contact Center, Recording, Compliance, Bots, Meeting Management, Click-to-chat, Click-to-call, and Value Add solutions

Other such applications include but are not limited to:

For illustration purposes, the Trusted Application API may also be used for the following high-privilege scenarios:

In this section

Additional Background for Developers

Prior knowledge and understanding of the following APIs from the Skype Developer Platform greatly simplifies understanding of the Trusted Application API.