Electron-Anbieter

Der Electron-Anbieter verwendet MSAL-node , um Benutzer anzumelden und Token für die Verwendung mit Microsoft Graph in einer Electron-Anwendung abzurufen.

Weitere Informationen zu Authentifizierungsanbietern finden Sie unter Anbieter.

Erste Schritte

Installieren der Pakete

npm install @microsoft/mgt-element @microsoft/mgt-electron-provider

Sie müssen ElectronProvider im Rendererprozess (Front-End) und ElectronAuthenticator im Hauptprozess (Back-End) initialisieren.

Initialisieren von ElectronProvider im Rendererprozess (renderer.ts)

Der ElectronProvider ist für die Kommunikation mit ElectronAuthenticator (im Hauptprozess) verantwortlich, um Zugriffstoken anzufordern und Informationen zum protokollierten Zustand zu empfangen, die für die Funktionsweise der Komponenten erforderlich sind.

import {Providers} from '@microsoft/mgt-element';
import {ElectronProvider} from '@microsoft/mgt-electron-provider/dist/Provider';
import '@microsoft/mgt-components';

const baseURL: GraphEndpoint = 'https://graph.microsoft.us'; // change the base URL

// initialize the auth provider globally
Providers.globalProvider = new ElectronProvider(baseUrl=baseURL);

Initialisieren von ElectronAuthenticator im Hauptprozess (main.ts)

ElectronAuthenticator ist für die Einrichtung der Konfigurationsvariablen für die MSAL-Authentifizierung, das Abrufen von Zugriffstoken und die Kommunikation mit ElectronProvider verantwortlich. Initialisieren Sie electronAuthenticator im Hauptprozess, und richten Sie die Konfigurationsvariablen ein, z. B. client-id.

import { ElectronAuthenticator, MsalElectronConfig } from '@microsoft/mgt-electron-provider/dist/Authenticator';

let config: MsalElectronConfig = {
  clientId: '<your_client_id>',
  authority: '<your_authority_url>', //optional
  mainWindow: mainWindow,
  scopes: ['user.read'], // We recommend pre-consenting all the required scopes on the Microsoft Entra admin center
  baseURL: 'https://graph.microsoft.us' // change this if you want to use a different M365 endpoint
};

ElectronAuthenticator.initialize(config);

Anmerkung: Derzeit unterstützt der Anbieter keine inkrementelle Unterstützung. Als bewährte Methode sollten Sie allen Bereichen zustimmen, die für die Komponenten erforderlich sind.

Erstellen einer App-/Client-ID

Hinzufügen einer neuen Anwendungsregistrierung in Microsoft Entra ID zum Abrufen einer Client-ID

Um eine Anwendung in Microsoft Entra ID zu erstellen, fügen Sie eine neue Anwendungsregistrierung hinzu, und konfigurieren Sie dann einen App-Namen und einen Umleitungs-URI.

So erstellen Sie die App in Microsoft Entra ID

1. Wechseln Sie zum Microsoft Entra Admin Center.
2. Erweitern Sie das Menü >Identität, erweitern Sie Anwendungen>App-Registrierungen> wählen Sie die Schaltfläche Neue Registrierung aus.
3. Geben Sie den Namen für Ihre App ein. Beispiel: My Electron-App.
4. Wählen Sie für den Typ der unterstützten KontotypenKonten in einem beliebigen Organisationsverzeichnis (Beliebiges Microsoft Entra Verzeichnis – mehrinstanzenfähig) und persönliche Microsoft-Konten (z. B. Skype, Xbox) aus.
5. Wählen Sie im Feld Umleitungs-URI in der Dropdownliste Die Option Öffentlicher Client/nativ (mobiler & Desktop) aus, und geben Sie im Feld URL ein msal://redirect.
6. Bestätigen Sie Änderungen, indem Sie auf die Schaltfläche Registrieren klicken.

Nächste Schritte

• Sehen Sie sich das Schritt-für-Schritt-Tutorial zum Erstellen einer Elektronen-App an.
• Sehen Sie sich eine Electron-Beispielanwendung an, die zeigt, wie der Electron-Anbieter verwendet wird.