This package has been deprecated

Author message:

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

@microsoft/mgt-teams-sso-provider

Microsoft Graph Toolkit Microsoft Teams SSO Provider

The Microsoft Graph Toolkit (mgt) library is a collection of authentication providers and UI components powered by Microsoft Graph.

The @microsoft/mgt-teams-sso-provider package exposes the TeamsSSOProvider class to be used inside your Microsoft Teams tab applications to authenticate users, to call Microsoft Graph, and to power the mgt components.

See docs for full documentation of the TeamsSSOProvider

Usage

The TeamsProvider requires the usage of the Microsoft Teams SDK which is not automatically installed.

1. Install the packages

   npm install @microsoft/teams-js @microsoft/mgt-element @microsoft/mgt-teams-sso-provider

2. Before initializing the provider, create a new page in your application (ex: https://mydomain.com/auth) that will handle the auth redirect. Call the handleAuth function to handle all client side auth or permission consent.

   import * as MicrosoftTeams from "@microsoft/teams-js/dist/MicrosoftTeams";
   import {TeamsSSOProvider} from '@microsoft/mgt-teams-sso-provider';
   
   TeamsProvider.microsoftTeamsLib = MicrosoftTeams;
   TeamsProvider.handleAuth();

3. Initialize the provider in your main code (not on your auth page). The provider can be used in "client side auth" mode or SSO mode. SSO mode is enabled by setting ssoUrl \ sso-url and requires a backend service to handle the on-behalf-of flow.

   import {Providers} from '@microsoft/mgt-element';
   import {TeamsSSOProvider} from '@microsoft/mgt-teams-sso-provider';
   import * as MicrosoftTeams from "@microsoft/teams-js/dist/MicrosoftTeams";
   
   TeamsProvider.microsoftTeamsLib = MicrosoftTeams;
   
   Providers.globalProvider = new TeamsSSOProvider({
     clientId: string;
     authPopupUrl: string; // ex: "https://mydomain.com/auth" or "/auth"
     scopes?: string[];
     msalOptions?: Configuration;
     ssoUrl?: string; // ex: '/api/token',
     autoConsent?: boolean,
     httpMethod: HttpMethod; //ex HttpMethod.POST
   })

4. Alternatively, initialize the provider in html (only client-id and auth-popup-url is required):

   <script type="module" src="../node_modules/@microsoft/mgt-teams-provider/dist/es6/index.js" />
   
   <mgt-teams-sso-provider client-id="<YOUR_CLIENT_ID>"
                       auth-popup-url="/AUTH-PATH"
                       scopes="user.read,people.read..." 
                       authority=""
                       sso-url="/api/token" 
                       http-method="POST">
                       ></mgt-teams-provider>

See provider usage documentation to learn about how to use the providers with the mgt components, to sign in/sign out, get access tokens, call Microsoft Graph, and more.

Sea also

• Microsoft Graph Toolkit docs
• Microsoft Graph Toolkit repository
• Microsoft Graph Toolkit playground