Quickstart: Aanmelden met embedded native authentication

Van toepassing op: Groene cirkel met een wit vinkje dat aangeeft dat de volgende inhoud van toepassing is op externe tenants. Externe tenants (meer informatie)

Verificatiemethode: ingesloten native verificatie.

In deze quickstart configureert u een React Next.js-voorbeeld voor systeemeigen ingesloten verificatie met Microsoft Authentication Library (MSAL) voor JavaScript 5.29.0. Het e-mail- en wachtwoordtraject maakt gebruik van een aangepast domein dat door de tenant is geverifieerd met CORS (Cross-Origin Resource Sharing) aan de rand.

Important

De Native Authentication API V2 is in preview. De Native Authentication API V1 blijft algemeen beschikbaar. Zie de aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor juridische voorwaarden die van toepassing zijn op preview-functies.

Prerequisites

  • Vereist zijn een externe tenant en een openbare clienttoepassing die is geconfigureerd voor ingesloten systeemeigen verificatie. Voltooi een toepassing configureren.
  • Een door tenant geverifieerd aangepast domein, de toepassings-id en de GUID van de directorytenant.
  • CORS op de edge van het aangepaste domein die is geconfigureerd voor de oorsprong van de browser van het voorbeeld, http://localhost:3000. Pas het gedeelde proxycontract toe voor origins, preflight, SDK-headers en geslaagde en foutreacties.
  • Een klantaccount met e-mail en wachtwoord. Als tenantbeleid meervoudige verificatie (MFA) vereist, bereid een geactiveerde e-mail- of sms-factor voor voor dit voorbeeldtraject.
  • Node.js 20.9.0 of hoger, npm, Git en een code-editor.
  • Poort 3000 is beschikbaar voor de toepassing.

Het voorbeeld ophalen

Het voorbeeld heeft een geïntegreerd startprogramma voor V1 en V2. Gebruik de vastgemaakte revisie en SDK-versie hieronder om deze quickstart te volgen:

  1. Kloon de repository, schakel over naar de voorbeeldrevisie en open de React Next.js-toepassing:

    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. Installeer de exacte SDK-versie met de voorbeeldafhankelijkheden:

    npm install --save-exact "@azure/msal-browser@5.29.0"
    

De toepassing configureren

Gebruik https://<tenant-verified-custom-domain>/<tenant-GUID> voor zowel de serviceautoriteit als de SDK API-transportbasis in deze edge-route. Houd ondoorzichtige absolute HAL-koppelingen voor die instantie ongewijzigd. Voeg geen clientgeheim toe aan de browserconfiguratie.

  1. src/config/auth-config.ts openen.
  2. Vervang Enter_the_Application_Id_Here door de toepassings-id.
  3. Vervang de volledige waarde van auth.authority door https://<tenant-verified-custom-domain>/<tenant-GUID>, waarbij u uw geverifieerde hostnaam en tenant-GUID in https://<tenant-verified-custom-domain>/<tenant-GUID> vervangt.
  4. Voeg auth.knownAuthorities toe als een array die de geverifieerde hostnaam bevat, zonder een schema of pad.
  5. Stel de vereiste customAuth.authApiProxyUrl tekenreeks in op dezelfde volledige https://<tenant-verified-custom-domain>/<tenant-GUID> authority. Neem de tenant-GUID op in beide SDK-URL-instellingen.
  6. Sla het configuratiebestand op. Het V2-voorbeeld maakt gebruik van de standaardbereiken van de SDK zonder aangepaste claims. MFA-vereisten zijn afkomstig van uw tenantbeleid, niet van het selecteren van V2.

Het voorbeeld uitvoeren

Voer de toepassing uit vanuit de voorbeeldmap. Deze edge-configuratie voor aangepast domein maakt geen gebruik van de lokale CORS-proxy van het voorbeeld:

  1. Start de toepassing:

    npm run dev
    
  2. Open http://localhost:3000 in een browser en selecteer V2. Houd het applicatieproces actief tijdens het testen.

Meld u aan als testklant

Gebruik het geïntegreerde startprogramma van het voorbeeld om alleen methoden te testen die zijn ingeschakeld voor de huidige transactie.

  1. Voer het e-mailadres van de testgebruiker in en selecteer Aanmelden.
  2. Als de service meerdere first-factor-methoden biedt, selecteert u de wachtwoordmethode. Voer het wachtwoord in wanneer hierom wordt gevraagd en selecteer Aanmelden.
  3. Als de service MFA aanvraagt, selecteert u een aangeboden e-mail- of sms-methode en voert u de bijbehorende verificatiecode in.
  4. Controleer of het voorbeeld meldt dat de aanmelding is voltooid. Stel tokens niet bloot in schermopnamen, logboeken of ondersteuningsuitvoer.

Eenmalige aanmelding met toegangscodes per e-mail maakt gebruik van een klantaccount en gebruikersstroom die voor die methode is geconfigureerd. Deze quickstart volgt het e-mail- en wachtwoordtraject.

De sessie opschonen

Beëindig de lokale test zonder gedeelde tenantconfiguratie te verwijderen.

Als u zich afmeldt bij het voorbeeld, worden andere toepassings- of browsersessies niet beëindigd.

  1. Meld u af bij het voorbeeld en wis de gebruikersinterface van de accounttoepassing.
  2. Stop het toepassingsproces in de terminal.