Provedor de Electron

Cuidado

O Microsoft Graph Toolkit foi preterido. O período de aposentadoria começa em 1º de setembro de 2025, com aposentadoria total planejada para 28 de agosto de 2026. Os desenvolvedores devem migrar para o uso dos SDKs do Microsoft Graph ou outras ferramentas do Microsoft Graph com suporte para criar experiências na Web. Para obter mais informações, consulte o anúncio de substituição.

O provedor Electron usa o nó MSAL para conectar usuários e adquirir tokens para usar com o Microsoft Graph em um aplicativo Electron.

Para saber mais sobre provedores de autenticação, consulte provedores.

Introdução

Instalar os pacotes

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

Você precisa inicializar ElectronProvider no processo de renderização (front-end) e ElectronAuthenticator no processo principal (back-end).

Inicializando ElectronProvider no processo de renderização (renderer.ts)

O ElectronProvider é responsável por se comunicar com o ElectronAuthenticator (no processo principal) para solicitar tokens de acesso e receber informações sobre o estado conectado que são necessárias para o funcionamento dos componentes.

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);

Inicializando ElectronAuthenticator no processo principal (main.ts)

O ElectronAuthenticator é responsável por definir as variáveis de configuração para autenticação MSAL, adquirir tokens de acesso e se comunicar com ElectronProvider. Inicialize o ElectronAuthenticator no processo principal e configure as variáveis de configuração, como 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);
Atributo Descrição
clientId ID do cliente de cadeia de caracteres (consulte Criação de um aplicativo/ID do cliente). Obrigatório.
escopos Cadeias de caracteres separadas por vírgula para escopos que o usuário deve consentir ao entrar. Recomendado.
autoridade Cadeia de caracteres de autoridade - o padrão é a autoridade comum. Para aplicativos de locatário único, use sua ID de locatário ou nome de locatário. Por exemplo: https://login.microsoftonline.com/[your-tenant-contoso.com ou https://login.microsoftonline.com/[your-tenant-id]. Opcional.
mainWindow Instância do BrowserWindow principal que requer autenticação.
cachePlugin Plug-in de cache que você gostaria de usar para armazenamento persistente de tokens. Consulte Extensões de autenticação da Microsoft para o Node. Opcional.
URL base O ponto de extremidade do Microsoft Graph a ser usado para chamadas do Microsoft Graph. Pode ser qualquer uma das implantações de nuvem nacional com suporte. O valor padrão é https://graph.microsoft.com.

Observação: Atualmente, o provedor não dá suporte a suporte incremental. Como prática recomendada, certifique-se de concordar com todos os escopos que os componentes exigem.

Criar um aplicativo/ID do cliente

Adicione um novo registro de aplicativo no Microsoft Entra ID para obter uma ID do cliente

Para criar um aplicativo no Microsoft Entra ID, adicione um novo registro de aplicativo e, em seguida, configure um nome de aplicativo e URI de redirecionamento.

Para criar o aplicativo no Microsoft Entra ID:

  1. Vá para o centro de administração do Microsoft Entra.
  2. Expanda o menu >Identidade, expanda Aplicativos>, selecione Registros de aplicativo>, selecione o botão Novo registro.
  3. Insira o nome do seu aplicativo; Por exemplo, My Electron-App.
  4. Para os tipos de conta com suporte, selecione Contas em qualquer diretório organizacional (qualquer diretório do Microsoft Entra - Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).
  5. No campo URI de redirecionamento , no menu suspenso, selecione Cliente público/nativo (celular & desktop) e, no campo URL, insira msal://redirect.
  6. Confirme as alterações selecionando o botão Registrar .

Próximas etapas

  • Last updated on