Teilen über

Electron-Anbieter

  • Artikel

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 Standard Prozess (Back-End) initialisieren.

Initialisieren von ElectronProvider im Rendererprozess (renderer.ts)

Der ElectronProvider ist für die Kommunikation mit ElectronAuthenticator (im Standard-Prozess) verantwortlich, um Zugriffstoken anzufordern und Informationen über den angemeldeten Zustand zu erhalten, 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 Standard-Prozess (Standard.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 Standard Prozess, 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);
Attribut Beschreibung
clientId Zeichenfolgenclient-ID (siehe Erstellen einer App-/Client-ID). Erforderlich.
Bereiche Durch Trennzeichen getrennte Zeichenfolgen für Bereiche, in die der Benutzer bei der Anmeldung zustimmen muss. Empfohlen.
Behörde Autoritätszeichenfolge: Der Standardwert ist die allgemeine Autorität. Verwenden Sie für Einzelmandanten-Apps Ihre Mandanten-ID oder Ihren Mandantennamen. Zum Beispiel https://login.microsoftonline.com/[your-tenant-contoso.com oder https://login.microsoftonline.com/[your-tenant-id]. Optional.
Mainwindow Instanz der Standard BrowserWindow, die eine Authentifizierung erfordert.
cachePlugin Cache-Plug-In, das Sie für die persistente Speicherung von Token verwenden möchten. Weitere Informationen finden Sie unter Microsoft-Authentifizierungserweiterungen für Node. Optional.
base-url Der Microsoft Graph-Endpunkt, der für Microsoft Graph-Aufrufe verwendet werden soll. Dies kann jede der unterstützten nationalen Cloudbereitstellungen sein. Der Standardwert ist https://graph.microsoft.com.

Hinweis: 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