Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@microsoft/mgt-element

Package Overview
Dependencies
Maintainers
2
Versions
828
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@microsoft/mgt-element

Microsoft Graph Toolkit base classes

  • 4.1.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
15K
decreased by-12.58%
Maintainers
2
Weekly downloads
 
Created
Source

Microsoft Graph Toolkit Base package

npm

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:

  1. Install the packages

    npm install @microsoft/mgt-element @microsoft/mgt-msal2-provider
    
  2. 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'});
    
  3. 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.

Sea also

FAQs

Package last updated on 26 Feb 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc