Provedor de Electron

O fornecedor de Electron utiliza o nó MSAL para iniciar sessão de utilizadores e adquirir tokens para utilizar com o Microsoft Graph numa aplicação Electron.

Para saber mais sobre os fornecedores de autenticação, veja fornecedores.

Introdução

Instalar os pacotes

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

Tem de inicializar o ElectronProvider no processo de composição (front-end) e o ElectronAuthenticator no processo principal (back-end).

Inicializar o ElectronProvider no processo de composição (renderer.ts)

O ElectronProvider é responsável por comunicar com o ElectronAuthenticator (no processo principal) para pedir tokens de acesso e receber informações sobre o estado registado que são necessários para que os componentes funcionem.

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

Inicializar o ElectronAuthenticator no processo principal (main.ts)

O ElectronAuthenticator é responsável por configurar as variáveis de configuração para a autenticação MSAL, adquirir tokens de acesso e comunicar com a 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);

Nota: Atualmente, o fornecedor não suporta suporte incremental. Como melhor prática, certifique-se de que consente todos os âmbitos necessários para os componentes.

Criar um ID de aplicação/cliente

Adicionar novo registo de aplicação no Microsoft Entra ID para obter um ID de cliente

Para criar uma aplicação no Microsoft Entra ID, adicione um novo registo de aplicação e, em seguida, configure um nome de aplicação e redirecione o URI.

Para criar a aplicação no Microsoft Entra ID:

1. Aceda ao centro de administração do Microsoft Entra.
2. Expanda o menu >Identidade expanda Aplicações> selecione Registros de aplicativo> selecione o botão Novo registo.
3. Introduza o nome da sua aplicação; por exemplo, My Electron-App.
4. Para o tipo de tipos de conta suportados, selecione Contas em qualquer diretório organizacional (Qualquer diretório de Microsoft Entra - Multi-inquilino) e contas Microsoft pessoais (por exemplo, Skype, Xbox).
5. No campo URI de Redirecionamento , na lista pendente, selecione Cliente público/nativo (móvel & ambiente de trabalho) e, no campo URL, introduza msal://redirect.
6. Confirme as alterações ao selecionar o botão Registar .

Próximas etapas

• Veja o tutorial passo a passo para criar uma aplicação de electrões.
• Veja um exemplo de aplicação Electron que mostra como utilizar o fornecedor electron.