Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Gäller för:
Externa klienter (läs mer)
Autentiseringsmetod: Inbäddad inbyggd autentisering.
I den här snabbstarten konfigurerar du ett React Next.js-exempel för inbäddad intern autentisering med Microsofts autentiseringsbibliotek (MSAL) för JavaScript 5.29.1. E-post- och lösenordsresan använder en tenantverifierad anpassad domän med CORS (Cross-Origin Resource Sharing) vid edge-nätverket.
Important
Native Authentication API V2 är i förhandsversion. API V1 för intern autentisering är fortfarande allmänt tillgängligt. Se kompletterande användningsvillkor för Microsoft Azure förhandsversioner för juridiska villkor som gäller för förhandsversionsfunktioner.
Prerequisites
- En extern tenant och ett offentligt klientprogram som konfigurerats för Embedded native authentication. Slutför konfigurationen av ett program.
- En klientorganisationsverifierad anpassad domän, program-ID och katalogklientorganisationens GUID.
- CORS på den anpassade domängränsen som konfigurerats för exemplets webbläsar ursprung,
http://localhost:3000. Tillämpa det delade proxykontraktet för ursprung, preflight, SDK-huvuden och lyckade och felsvar. - Ett kundkonto med e-post och lösenord. Om klientorganisationsprincipen kräver multifaktorautentisering (MFA) förbereder du en aktiverad e-post- eller SMS-faktor för det här exempelflödet.
- Node.js 20.9.0 eller senare, npm, Git och en kodredigerare.
- Port 3000 är ledig för applikationen.
Hämta exemplet
Exemplet har ett enhetligt startprogram för V1 och V2. Använd den fästa revisionen och SDK-versionen nedan för att följa den här snabbstarten:
Klona repot, kolla in exempelrevisionen och öppna dess React Next.js-applikation:
git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples cd ms-identity-ciam-native-javascript-samples git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808 cd typescript/native-auth/react-nextjs-sampleInstallera den exakta SDK-versionen med exempelberoendena:
npm install --save-exact "@azure/msal-browser@5.29.1"
Konfigurera programmet
Använd https://<tenant-verified-custom-domain>/<tenant-GUID> för både tjänstauktoriteten och SDK API-transportbasen i den här edge-rutten. Behåll ogenomskinliga absoluta HAL-länkar för den auktoriteten oförändrade. Lägg inte till en klienthemlighet i webbläsarkonfigurationen.
- Öppna
src/config/auth-config.ts. - Ersätt
Enter_the_Application_Id_Heremed program-ID:t. - Ersätt det fullständiga
auth.authorityvärdet medhttps://<tenant-verified-custom-domain>/<tenant-GUID>och ersätt ditt verifierade värdnamn och klient-GUID. - Lägg till
auth.knownAuthoritiessom en matris som innehåller det verifierade värdnamnet, utan protokoll eller sökväg. - Ange den nödvändiga
customAuth.authApiProxyUrl-strängen som samma fullständigahttps://<tenant-verified-custom-domain>/<tenant-GUID>-auktoritet. Inkludera tenant-GUID i båda SDK-URL-inställningarna. - Spara konfigurationsfilen. V2-exemplet använder SDK:s standardscopes utan anpassade claims. MFA-kraven kommer från klientorganisationens princip, inte från att välja V2.
Kör det här exemplet
Kör programmet från exempelkatalogen. Den här edge-konfigurationen för anpassad domän använder inte exemplets lokala CORS-proxy:
Starta programmet:
npm run devÖppna
http://localhost:3000i en webbläsare och välj V2. Håll programmet igång medan du testar.
Logga in som testkunden
Använd exemplets enhetliga startprogram för att endast testa metoder som är aktiverade för den aktuella transaktionen.
- Ange testkunds e-postadress och välj Logga in.
- Om tjänsten erbjuder flera förstafaktormetoder väljer du lösenordsmetoden. Ange lösenordet när det begärs och välj Logga in.
- Om tjänsten begär MFA väljer du en e-post- eller SMS-metod som erbjuds och anger dess verifieringskod.
- Bekräfta att exempelrapporten har slutfört inloggningen. Visa inte token i skärmbilder, loggar eller supportutdata.
Inloggning med engångslösenord via e-post använder ett kundkonto och ett användarflöde som konfigurerats för den metoden. Den här snabbstarten följer e-post- och lösenordsresan.
Rensa upp sessionen
Avsluta det lokala testet utan att ta bort delad klientorganisationskonfiguration.
Att logga ut från exemplet avslutar inte andra program- eller webbläsarsessioner.
- Logga ut från exemplet och rensa det kontorelaterade användargränssnittet.
- Stoppa applikationsprocessen i terminalen.