Provedor MSALMSAL provider

O provedor MSAL usa MSAL.js para entrar em usuários e adquirir tokens para usar com o Microsoft Graph.The MSAL provider uses MSAL.js to sign in users and acquire tokens to use with Microsoft Graph.

Para saber mais, veja Providers.To learn more, see providers.

IntroduçãoGet started

Você pode inicializar o provedor MSAL em HTML ou JavaScript.You can initialize the MSAL provider in HTML or JavaScript.

Inicializar na página HTMLInitialize in your HTML page

Inicializar o provedor MSAL em HTML é a maneira mais simples de criar um novo provedor.Initializing the MSAL provider in HTML is the simplest way to create a new provider. Use o mgt-msal-provider componente para definir a ID do cliente e outras propriedades.Use the mgt-msal-provider component to set the client-id and other properties. Isso criará uma nova UserAgentApplication instância que será usada para todos os tokens de autenticação e aquisição.This will create a new UserAgentApplication instance that will be used for all authentication and acquiring tokens.

<mgt-msal-provider client-id="<YOUR_CLIENT_ID>"
                   login-type="redirect/popup"
                   scopes="user.read,people.read"
                   redirect-uri="https://my.redirect/uri"
                   authority=""></mgt-msal-provider>
AtributoAttribute DescriçãoDescription
Client-IDclient-id String Client ID (consulte Creating a app/Client ID).String client ID (see Creating an app/client ID). Obrigatório.Required.
tipo de logonlogin-type A enumeração entre redirect e o popup valor padrão é redirect .Enumeration between redirect and popup - default value is redirect. Opcional.Optional.
escoposscopes Cadeias de caracteres separadas por vírgula para escopos para os quais o usuário deve se concordar.Comma separated strings for scopes the user must consent to on sign in. Opcional.Optional.
autoridadesauthority A cadeia de caracteres de autoridade-padrão é a autoridade comum.Authority string - default is the common authority. Para aplicativos de locatário único, use a ID de locatário ou o nome do locatário.For single-tenant apps, use your tenant ID or tenant name. Por exemplo, https://login.microsoftonline.com/[your-tenant-name].onmicrosoft.com ou https://login.microsoftonline.com/[your-tenant-id] .For example, https://login.microsoftonline.com/[your-tenant-name].onmicrosoft.com or https://login.microsoftonline.com/[your-tenant-id]. Opcional.Optional.
Redirect-URIredirect-uri Redirecionar cadeia de caracteres URI-por padrão, o URI de janela atual é usado.Redirect URI string - by default the current window URI is used. Opcional.Optional.
depende dedepends-on Cadeia de caracteres de seletor de elemento de outro componente de provedor de prioridade mais alta.Element selector string of another higher priority provider component. Opcional.Optional.

Inicializar em JavaScriptInitialize in JavaScript

Você pode fornecer mais opções inicializando o provedor no JavaScript.You can provide more options by initializing the provider in JavaScript.

import {Providers, MsalProvider} from '@microsoft/mgt'
import {UserAgentApplication} from "msal";

Providers.globalProvider = new MsalProvider(config: MsalConfig);

onde MsalConfig é:where MsalConfig is:

interface MsalConfig {
  clientId: string;
  scopes?: string[];
  authority?: string;
  redirectUri?: string;
  loginType?: LoginType; // LoginType.Popup or LoginType.Redirect (redirect is default)
  loginHint?: string
  options?: Configuration; // msal js Configuration object
}

Você deve fornecer um clientId (para criar um novo UserAgentApplication ).You must provide a clientId (to create a new UserAgentApplication).

Para saber mais sobre MSAL.js e para opções adicionais que você pode usar ao inicializar a biblioteca do MSAL, consulte a documentação do MSAL.To learn more about MSAL.js and for additional options you can use when initializing the MSAL library, see the MSAL documentation.

Criar uma ID de aplicativo/clienteCreating an app/client ID

Para obter detalhes sobre como registrar um aplicativo e obter uma ID de cliente, consulte o início rápido registrar um aplicativo.For details about how to register an app and get a client ID, see the Register an app quick start.

Observação: MSAL só oferece suporte ao fluxo implícito para OAuth.Note: MSAL only supports the Implicit Flow for OAuth. Certifique-se de habilitar o fluxo implícito em seu aplicativo no portal do Azure (não está habilitado por padrão).Make sure to enable Implicit Flow in your application in the Azure Portal (it is not enabled by default). Em autenticação, encontre a seção concessão implícita e marque as caixas de seleção para tokens de acesso e tokens de ID.Under Authentication, find the Implicit grant section and select the checkboxes for Access tokens and ID tokens. Para usar a autoridade comum, defina Account em qualquer diretório organizacional.To use the common authority, set Account in any organizational directory. Para usar um locatário específico, defina o authority durante a inicialização.To use a specific tenant, set the authority during initialization.