Skip to content

Latest commit

 

History

History
20 lines (12 loc) · 1.59 KB

endpoints-and-responses.md

File metadata and controls

20 lines (12 loc) · 1.59 KB

Endpoints and Responses

User Endpoint

The user endpoint consists of three operations:

  1. GET /api/user - Retrieve an Azure Communication Services identity from Microsoft Graph.
  2. POST /api/user - Create an Azure Communication Services identity and then add the roaming identity mapping information to Microsoft Graph.
  3. DELETE /api/user - Delete an identity mapping information from Microsoft Graph including the Azure Communication Services resource related to the Azure Communication Services identity.

Token Endpoint

The token endpoint only consists of two operations:

  1. GET /api/token - Get / refresh an Azure Communication Services token for an Azure Communication Services user.
  2. GET /api/token/teams - Exchange an Azure Active Directory token of a M365 user for an Azure Communication Services token.

ℹ️ Teams users are authenticated via the MSAL library against Azure Active Directory in the client application. Authentication tokens are exchanged for Microsoft 365 Teams token via the Azure Communication Services Identity SDK. Developers are encouraged to implement an exchange of tokens in their backend services as exchange requests are signed by credentials for Azure Communication Services. In backend services, developers can require any additional authentication. Learn more here.

Identity Mapping - Disassembly Diagram