@microsoft/mgt-element
v4.4.0
Published
Microsoft Graph Toolkit base classes
Downloads
77,099
Keywords
Readme
Microsoft Graph Toolkit Base package
The Microsoft Graph Toolkit (mgt) library is a collection of authentication providers and UI components powered by Microsoft Graph.
The @microsoft/mgt-element
package contains all base classes that enable the providers and components to work together. Use this package to set the global provider, or to create your own providers and/or components that work with Microsoft Graph.
See docs for full documentation
Set and use the global provider
The @microsoft/mgt-element
package exposes the Providers
namespace that enables global usage of the authentication providers across your entire app.
This example illustrates how to instantiate a new provider (MsalProvider in this case) and use it across your app:
Install the packages
npm install @microsoft/mgt-element @microsoft/mgt-msal2-provider
Create the provider
import {Providers} from '@microsoft/mgt-element'; // importing via the export path will exclude the custom element for <mgt-msal2-proivder> from the final bundle import {Msal2Provider} from '@microsoft/mgt-msal2-provider/dist/es6/exports'; // initialize the auth provider globally Providers.globalProvider = new Msal2Provider({clientId: 'clientId'});
Use the provider to sign in and call the graph:
import {Providers, ProviderState} from '@microsoft/mgt-element'; const handleLoginClicked = async () => { await Providers.globalProvider.login(); if (Providers.globalProvider.state === ProviderState.SignedIn) { let me = await Provider.globalProvider.graph.client.api('/me').get(); } }
You can learn more about how to use the providers in the documentation.
The providers work well with the @microsoft/mgt-components
package and all components use the provider automatically when they need to call Microsoft Graph.
Create your own provider
In scenarios where you want to use the Providers namespace and/or add Microsoft Graph Toolkit components to an application with pre-existing authentication code, you can create a custom provider that hooks into your authentication mechanism. @microsoft/mgt-element
enables two ways to create new providers:
Create a Simple Provider
If you already have a function that returns accessTokens
, you can use a SimpleProvider to wrap the function:
import {Providers, SimpleProvider} from '@microsoft/mgt-element';
function getAccessToken(scopes: string[]) {
// return a promise with accessToken string
}
function login() {
// login code - optional
// make sure to set the state when signed in
Providers.globalProvider.setState(ProviderState.SignedIn)
}
function logout() {
// logout code - optional
// make sure to set the state when signed out
Providers.globalProvider.setState(ProviderState.SignedOut)
}
Provider.globalProvider = new SimpleProvider(getAccessToken, login, logout);
Extend an IProvider
You can extend the IProvider abstract class to create your own provider. The IProvider is similar to the SimpleProvider in that it requires the developer to implement the getAccessToken()
function.
See the custom provider documentation for more details on both ways to create custom providers.