{"id":6065,"date":"2021-03-08T14:24:58","date_gmt":"2021-03-08T22:24:58","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=6065"},"modified":"2021-11-17T12:39:27","modified_gmt":"2021-11-17T20:39:27","slug":"microsoft-graph-toolkit-adds-a-new-electron-provider-plus-enhanced-capabilities","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-graph-toolkit-adds-a-new-electron-provider-plus-enhanced-capabilities\/","title":{"rendered":"Microsoft Graph Toolkit\u00a0adds a new Electron Provider plus enhanced capabilities"},"content":{"rendered":"

Today, we\u00a0released\u00a0<\/span>version 2.1 of the Microsoft Graph Toolkit<\/span><\/a>. This release includes\u00a0a new authentication provider for Electron applications,\u00a0as well as improvements and bug fixes for the existing components and providers.<\/span>\u00a0<\/span><\/p>\n

As a recap, the\u202f<\/span>Microsoft Graph Toolkit\u202f<\/span><\/a>\u202fis a collection of components and providers that makes your integration with Microsoft Graph as easy as writing two lines of code. To learn more, read the\u00a0documentation<\/a>,\u00a0try the\u00a0getting started tutorial<\/a>, or clone and run this\u00a0sample<\/a> to see it in action.<\/span><\/p>\n

Updating your application<\/h3>\n

To update your application to use the newest version of Microsoft Graph Toolkit,\u00a0go\u00a0to your project directory and run:<\/span>\u00a0<\/span><\/p>\n

npm\u00a0i\u00a0@microsoft\/mgt@latest<\/pre>\n
If you\u2019re using the Toolkit via\u202fmgt-loader, your application will be automatically updated to the newest version.<\/span>\u00a0<\/span><\/p>\n
What\u2019s New?<\/h3>\n
Electron\u00a0provider<\/h4>\n
The Microsoft Graph Toolkit authentication providers enable you to easily implement authentication with the Microsoft Identity Platform for your application.<\/span>\u00a0<\/span><\/p>\n
The new Electron provider\u00a0uses\u00a0msal-node to sign in\u00a0users\u00a0and acquire access tokens to request data from Microsoft Graph inside of an Electron application.\u00a0It\u00a0is available on all platforms where Electron applications can run.<\/span>\u00a0<\/span><\/p>\n
To use it, add it to your Electron app with:<\/span>\u00a0<\/span><\/p>\n
npm\u00a0install @microsoft\/mgt-element @microsoft\/mgt-electron-provider<\/pre>\n
Create\u00a0the\u00a0ElectronProvider\u00a0in your renderer process:<\/span>\u00a0<\/span><\/p>\n
import {Providers} from '@microsoft\/mgt-element';\u00a0\n\nimport {ElectronProvider} from '@microsoft\/mgt-electron-provider\/dist\/Provider';\u00a0\n\nProviders.globalProvider\u00a0= new\u00a0ElectronProvider();<\/pre>\n
And\u00a0initialize the\u00a0ElectronAuthenticator\u00a0in your main process:<\/span>\u00a0<\/span><\/p>\n
import {\u00a0ElectronAuthenticator\u00a0} from '@microsoft\/mgt-electron-provider\/dist\/Authenticator';\u00a0\u00a0\n\nElectronAuthenticator.initialize({\u00a0\n\n\u00a0\u00a0\u00a0\u00a0clientId: '<your_client_id>',\u00a0\n\n\u00a0\u00a0\u00a0\u00a0mainWindow:\u00a0mainWindow\u00a0\n\n\u00a0\u00a0};\u00a0\n\n);<\/pre>\n
You can now call Microsoft Graph<\/a> and use any Microsoft Graph Toolkit components\u00a0as you normally would.<\/span>\u00a0<\/span><\/p>\n
To learn more, read the documentation, try the\u00a0<\/span>getting started tutorial,<\/span>\u00a0or clone and run\u00a0this\u00a0<\/span>sample<\/span><\/a>\u00a0to see it in action.<\/span>\u00a0<\/span><\/p>\n
Other\u00a0improvements<\/h3>\n
This release also includes\u00a0several\u00a0improvements and bug fixes to the existing components and providers, including:<\/span>\u00a0<\/span><\/p>\n