Guida introduttiva: Accedere con l'autenticazione nativa incorporata

Si applica a: cerchio verde con un simbolo di segno di spunta bianco che indica che il contenuto seguente si applica ai tenant esterni. Tenant esterni (altre informazioni)

Approccio di autenticazione: Autenticazione nativa incorporata.

In questa guida introduttiva viene configurato un esempio di React Next.js per l'autenticazione nativa incorporata con Libreria di Autenticazione Microsoft (MSAL) per JavaScript 5.29.1. Il percorso di posta elettronica e password usa un dominio personalizzato verificato dal tenant con condivisione di risorse tra le origini (CORS) al perimetro.

Importante

L'API di autenticazione nativa V2 è disponibile in anteprima. L'API di autenticazione nativa V1 rimane disponibile a livello generale. Vedere le Condizioni d'uso supplementari per le anteprime di Microsoft Azure per le condizioni legali applicabili alle funzionalità di anteprima.

Prerequisites

  • Un tenant esterno e un'applicazione client pubblica configurata per l'autenticazione nativa incorporata. Completa Configurare un'applicazione.
  • Un dominio personalizzato verificato dal tenant, l'ID applicazione e il GUID del tenant della directory.
  • CORS nel perimetro del dominio personalizzato configurato per l'origine del browser dell'esempio, http://localhost:3000. Applicare il contratto proxy condiviso per origini, richieste preflight, intestazioni SDK e risposte di esito positivo e di errore.
  • Un account utente con email e password. Se i criteri del tenant richiedono l'autenticazione a più fattori (MFA), preparare un fattore di posta elettronica o SMS abilitato per questo percorso di esempio.
  • Node.js 20.9.0 o versione successiva, npm, Git e un editor di codice.
  • Porta di rete 3000 disponibile per l'applicazione.

Ottenere l'esempio

L'esempio include un'utilità di avvio unificata per V1 e V2. Usare la revisione bloccata e la versione dell'SDK seguenti per seguire questa guida introduttiva:

  1. Clonare il repository, controllare la revisione di esempio e aprire l'applicazione React Next.js:

    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. Installare la versione esatta dell'SDK con le dipendenze di esempio:

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

Configurare l'applicazione

Usare https://<tenant-verified-custom-domain>/<tenant-GUID> sia per l'autorità di servizio che per la base di trasporto dell'API SDK in questa route perimetrale. Mantenere invariati i collegamenti HAL assoluti opachi per tale autorità. Non aggiungere un segreto client alla configurazione del browser.

  1. Apri src/config/auth-config.ts.
  2. Sostituisci Enter_the_Application_Id_Here con l'ID dell'applicazione.
  3. Sostituire il valore completo auth.authority con https://<tenant-verified-custom-domain>/<tenant-GUID>, sostituendo il tuo nome host verificato e il GUID del tenant.
  4. Aggiungere auth.knownAuthorities come array contenente il nome host verificato, senza uno schema o un percorso.
  5. Impostare la stringa richiesta customAuth.authApiProxyUrl sulla stessa autorità completa https://<tenant-verified-custom-domain>/<tenant-GUID> . Includi il GUID del tenant in entrambe le impostazioni URL dell'SDK.
  6. Salvare il file di configurazione. L'esempio V2 usa gli ambiti predefiniti dell'SDK senza claim personalizzati. I requisiti di autenticazione a più fattori provengono dai criteri del tenant, non dalla selezione di V2.

Esegui l'esempio

Eseguire l'applicazione dalla directory di esempio. Questa configurazione perimetrale del dominio personalizzato non usa il proxy CORS locale dell'esempio:

  1. Avviare l'applicazione:

    npm run dev
    
  2. Aprire http://localhost:3000 in un browser e selezionare V2. Mantenere in esecuzione il processo dell'applicazione durante il test.

Accedi al cliente di test

Usare l'utilità di avvio unificato dell'esempio per testare solo i metodi abilitati per la transazione corrente.

  1. Immettere l'indirizzo di posta elettronica del cliente di test e selezionare Accedi.
  2. Se il servizio offre più metodi di primo fattore, selezionare il metodo password. Immettere la password quando richiesto e selezionare Accedi.
  3. Se il servizio richiede l'autenticazione a più fattori, selezionare un'opzione e-mail o SMS disponibile e immettere il relativo codice di verifica.
  4. Verificare che i report di esempio indichino un accesso completato. Non esporre token in screenshot, log o output di supporto.

L'accesso con passcode monouso tramite posta elettronica usa un account cliente e un flusso utente configurato per tale metodo. Questa guida introduttiva segue il percorso di posta elettronica e password.

Pulire la sessione

Terminare il test locale senza eliminare la configurazione del tenant condiviso.

La disconnessione dall'esempio non termina altre sessioni dell'applicazione o del browser.

  1. Disconnettersi dall'esempio e cancellare l'interfaccia utente dell'applicazione correlata all'account.
  2. Arrestare il processo dell'applicazione nel terminale.