Initializati aplicatiile client MSAL.js – platforma de identitate Microsoft

• 17.07.2020
• 3 minute de citit

• • m

  • A

  • A

  • m

  • p

In acest articol

Acest articol descrie initializarea Bibliotecii de autentificare Microsoft pentru JavaScript (MSAL.js) cu o instanta a unei aplicatii user-agent.

Aplicatia utilizator-agent este o forma de aplicatie client publica in care codul clientului este executat intr-un utilizator-agent, cum ar fi un browser web. Astfel de clienti nu stocheaza secrete, deoarece contextul browserului este accesibil in mod deschis.

Pentru a afla mai multe despre tipurile de aplicatii client si despre optiunile de configurare a aplicatiei, consultati Aplicatiile publice si confidentiale pentru clienti din MSAL.

Conditii prealabile

Inainte de initializarea unei aplicatii, trebuie mai intai sa o inregistrati la portalul Azure, stabilind o relatie de incredere intre aplicatia dvs. si platforma de identitate Microsoft.

Dupa inregistrarea aplicatiei, veti avea nevoie de unele sau de toate valorile urmatoare care pot fi gasite in portalul Azure.

Valoare Necesara Descriere ID aplicatie (client) Necesar Un GUID care identifica in mod unic aplicatia dvs. in cadrul platformei de identitate Microsoft. Autoritate optionala URL-ul furnizorului de identitate ( instanta ) si publicul de conectare pentru aplicatia dvs. Instanta si publicul de conectare, atunci cand sunt concatenate, alcatuiesc autoritatea . ID director (chirias) Optional Specificati acest lucru daca creati o aplicatie linie de afaceri exclusiv pentru organizatia dvs., denumita adesea o aplicatie cu un singur chirias . Redirect URI Optional Daca creati o aplicatie web, redirectUri specifica unde furnizorul de identitate (platforma de identitate Microsoft) ar trebui sa returneze jetoanele de securitate pe care le-a emis.

Initializati aplicatiile MSAL.js 2.x

Initializati contextul de autentificare MSAL instantand o PublicClientApplication cu un obiect de configurare. Proprietatea minima de configurare necesara este ID-ul clientului aplicatiei dvs., afisat ca ID aplicatie (client) pe pagina Prezentare generala a inregistrarii aplicatiei din portalul Azure.

Iata un exemplu de obiect de configurare si instantierea unei aplicatii PublicClient:

const msalConfig = {auth: {clientId: “11111111-1111-1111-111111111111”, autoritate: “https://login.microsoftonline.com/common”, knownAuthorities: [], redirectUri: “https: // localhost: 3001 “, postLogoutRedirectUri:” https: // localhost: 3001 / logout “, navigateToLoginRequestUrl: true}, cache: {cacheLocation:” sessionStorage “, storeAuthStateInCookie: false}, system: {loggerOptions: {loggerCallback: (level: LogLevel, message: sir, continePii: boolean): void => {if (continePii) {return; } switch (level) {case LogLevel.Error: console.error (mesaj); intoarcere; case LogLevel.Info: console.info (mesaj); intoarcere; case LogLevel.Verbose: console.debug (mesaj); intoarcere; caz LogLevel.Warning: console.warn (mesaj); intoarcere; }}, piiLoggingEnabled: false}, windowHashTimeout: 60000, iframeHashTimeout: 6000, loadFrameTimeout: 0}}; // Creati o instanta a PublicClientApplication const msalInstance = new PublicClientApplication (msalConfig); // Gestionati fluxurile de redirectionare msalInstance.handleRedirectPromise (). Then ((tokenResponse) => {// Gestionati raspunsul la redirectionare}). Catch ((error) => {// Gestionati eroarea de redirectionare});

handleRedirectPromise

Invocati handleRedirectPromise atunci cand aplicatia dvs. utilizeaza fluxurile de redirectionare. Cand utilizati fluxurile de redirectionare, handleRedirectPromise ar trebui sa fie rulat la fiecare incarcare a paginii.

Exista trei rezultate posibile ale promisiunii:

• .then este invocat si tokenResponse este adevarat: aplicatia se intoarce dintr-o operatiune de redirectionare care a avut succes.
• .then este invocat si tokenResponse este fals (nul): Aplicatia nu se intoarce dintr-o operatiune de redirectionare.
• .catch este invocat: aplicatia se intoarce dintr-o operatiune de redirectionare si a aparut o eroare.

Initializati aplicatiile MSAL.js 1.x

Initializati contextul de autentificare MSAL 1.x prin instantierea unei UserAgentApplication cu un obiect de configurare. Proprietatea minima de configurare necesara este ID-ul clientului aplicatiei dvs., afisat ca ID aplicatie (client) pe pagina Prezentare generala a inregistrarii aplicatiei din portalul Azure.

Pentru metodele de autentificare cu fluxuri de redirectionare (loginRedirect si acquiseTokenRedirect) in MSAL.js 1.2.x sau anterior, trebuie sa inregistrati in mod explicit un apel invers pentru succes sau eroare prin metoda handleRedirectCallback (). Inregistrarea in mod explicit a apelului invers este necesara in MSAL.js 1.2.x si mai devreme, deoarece fluxurile de redirectionare nu returneaza promisiuni, asa cum fac metodele cu o experienta pop-up. Inregistrarea apelului invers este optionala in MSAL.js versiunea 1.3.x si ulterioara.

// Obiect de configurare construit const msalConfig = {auth: {clientId: “11111111-1111-1111-111111111111”}} // Creati instanta UserAgentApplication const msalInstance = new UserAgentApplication (msalConfig); functie authCallback (eroare, raspuns) {// Gestionati raspunsul la redirectionare} // Inregistrati un apel invers de redirectionare pentru succes sau eroare (cand utilizati metode de redirectionare) // ** NECESAR ** in MSAL.js 1.2.x si versiuni anterioare // ** OPTIONAL ** in MSAL.js 1.3.x si mai tarziu msalInstance.handleRedirectCallback (authCallback);

Instanta unica si configuratie

Ambele MSAL.js 1.x si 2.x sunt proiectate pentru a avea o singura instanta si o configuratie a UserAgentApplication sau respectiv PublicClientApplication pentru a reprezenta un singur context de autentificare.

Mai multe instante ale UserAgentApplication sau PublicClientApplication nu sunt recomandate, deoarece provoaca intrari cache si comportament conflictual in browser.

Pasii urmatori

Acest esantion de cod MSAL.js 2.x pe GitHub demonstreaza instantierea unei PublicClientApplication cu un obiect de configurare:

Azure-Samples / ms-identitate-javascript-v2