Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
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:
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-sampleInstallare 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.
- Apri
src/config/auth-config.ts. - Sostituisci
Enter_the_Application_Id_Herecon l'ID dell'applicazione. - Sostituire il valore completo
auth.authorityconhttps://<tenant-verified-custom-domain>/<tenant-GUID>, sostituendo il tuo nome host verificato e il GUID del tenant. - Aggiungere
auth.knownAuthoritiescome array contenente il nome host verificato, senza uno schema o un percorso. - Impostare la stringa richiesta
customAuth.authApiProxyUrlsulla stessa autorità completahttps://<tenant-verified-custom-domain>/<tenant-GUID>. Includi il GUID del tenant in entrambe le impostazioni URL dell'SDK. - 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:
Avviare l'applicazione:
npm run devAprire
http://localhost:3000in 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.
- Immettere l'indirizzo di posta elettronica del cliente di test e selezionare Accedi.
- Se il servizio offre più metodi di primo fattore, selezionare il metodo password. Immettere la password quando richiesto e selezionare Accedi.
- Se il servizio richiede l'autenticazione a più fattori, selezionare un'opzione e-mail o SMS disponibile e immettere il relativo codice di verifica.
- 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.
- Disconnettersi dall'esempio e cancellare l'interfaccia utente dell'applicazione correlata all'account.
- Arrestare il processo dell'applicazione nel terminale.