Snabbstart: Logga in med inbäddad intern autentisering

Gäller för: Grön cirkel med en vit bockmarkeringssymbol som anger att följande innehåll gäller för externa klienter. 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:

  1. 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-sample
    
  2. Installera 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.

  1. Öppna src/config/auth-config.ts.
  2. Ersätt Enter_the_Application_Id_Here med program-ID:t.
  3. Ersätt det fullständiga auth.authority värdet med https://<tenant-verified-custom-domain>/<tenant-GUID>och ersätt ditt verifierade värdnamn och klient-GUID.
  4. Lägg till auth.knownAuthorities som en matris som innehåller det verifierade värdnamnet, utan protokoll eller sökväg.
  5. Ange den nödvändiga customAuth.authApiProxyUrl-strängen som samma fullständiga https://<tenant-verified-custom-domain>/<tenant-GUID>-auktoritet. Inkludera tenant-GUID i båda SDK-URL-inställningarna.
  6. 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:

  1. Starta programmet:

    npm run dev
    
  2. Öppna http://localhost:3000 i 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.

  1. Ange testkunds e-postadress och välj Logga in.
  2. 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.
  3. Om tjänsten begär MFA väljer du en e-post- eller SMS-metod som erbjuds och anger dess verifieringskod.
  4. 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.

  1. Logga ut från exemplet och rensa det kontorelaterade användargränssnittet.
  2. Stoppa applikationsprocessen i terminalen.