Panoramica dell'autenticazione nativa

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.

L'autenticazione nativa incorporata è un approccio di autenticazione che consente all'applicazione di presentare l'iscrizione, l'accesso e la reimpostazione della password mentre Microsoft Entra per ID esterno convalida le credenziali e applica i requisiti di autenticazione. L'app controlla l'interfaccia e gestisce le azioni, i metodi disponibili e i collegamenti restituiti dall'API di autenticazione nativa.

Limiti delle versioni dell'API

Importante

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

I riferimenti primari descrivono l'API di autenticazione nativa guidata dalla risposta, con route native come /api/v2.0. Seguire i collegamenti forniti dal servizio senza riscriverne le versioni o i percorsi. Il percorso dell'endpoint /oauth2/v2.0 OAuth viene usato anche dalle integrazioni V1.

Le integrazioni V1 esistenti possono continuare a usare le informazioni di riferimento sull'API V1 e i riferimenti alla libreria SDK. Le guide e le esercitazioni legacy V1 sono state rimosse da questa documentazione. Questa modifica alla documentazione non annuncia il ritiro della versione 1 o degli SDK. Vedere Compatibilità e migrazione dell'SDK per i requisiti della piattaforma e dei pacchetti.

Esperienza di proprietà dell'applicazione, autenticazione controllata dal servizio

Con l'autenticazione nativa incorporata, un'applicazione per dispositivi mobili, desktop o a pagina singola può presentare l'autenticazione all'interno della propria interfaccia. L'applicazione controlla il layout, l'interazione e il feedback di convalida. Microsoft Entra per ID esterno convalida le credenziali, applica i requisiti di autenticazione e rilascia i token.

I criteri di accesso condizionale e tenant e il flusso utente dell'applicazione si applicano all'autenticazione ospitata Microsoft, all'autenticazione nativa incorporata e all'esperienza utente Bring Your Own UX (BYO UX). Le responsabilità di presentazione e integrazione differiscono. Con l'autenticazione nativa incorporata, l'app gestisce le interazioni necessarie, ad esempio una richiesta di secondo fattore dopo la verifica della password o più raccolte di attributi dopo la verifica della posta elettronica.

L'autenticazione ospitata da Microsoft presenta pagine per conto dell'app. Scegli l'autenticazione nativa incorporata quando il team necessita del controllo dell'interfaccia e può gestire le risposte e le responsabilità di sicurezza. Per un confronto più ampio, vedere Scegliere un approccio di autenticazione .

Percorsi del cliente

La stessa transazione di autorizzazione racchiude ogni percorso. L'app avvia l'autorizzazione, completa le interazioni di autenticazione restituite, riprende l'autorizzazione e scambia il codice di autorizzazione per i token.

Viaggio Behavior
Iscrizione Creare un account email con password o un account email con passcode monouso (OTP) senza password. Raccogliere gli attributi e completare i passaggi di verifica previsti dal flusso utente.
Accesso Inviare l'identificatore del cliente e completare la verifica usando la password completa o un passcode monouso via e-mail tramite un metodo offerto. L'accesso con nome utente con password è disponibile anche per gli account locali configurati.
Reimpostazione della password Verificare un codice monouso inviato via e-mail o SMS, immettere una nuova password e seguire le risposte del polling per l'aggiornamento della password. Il ripristino può iniziare prima della fase di individuazione dell'accesso o tramite il collegamento recover di un metodo password.
Autenticazione a più fattori (MFA) e registrazione inline Completare la verifica tramite posta elettronica o SMS quando i criteri richiedono l'autenticazione a più fattori. Se è necessaria la registrazione, gestire le operazioni restituite enroll e activate . Gli account basati su OTP tramite e-mail come primo fattore utilizzano un secondo fattore diverso, ad esempio l'SMS.
Requisiti delle policy dopo la registrazione o la reimpostazione della password Continua a gestire l'autenticazione richiesta, inclusa l'autenticazione a più fattori e l'accesso condizionale, prima di richiedere i token. Il completamento della creazione dell'account o un aggiornamento della password non aggira i criteri.

Selezionare percorsi utente e metodi da quelli disponibili nella transazione corrente. L'applicazione può presentare una scelta o applicare la logica del flusso all'interno di tali opzioni.

L'API di autenticazione nativa non supporta la federazione, i numeri di telefono come primo fattore, password monouso (TOTP), passkey, autenticazione push o metodi MFA esterni. Lo step-up in un secondo momento e l'uso di token rilasciati in modo nativo con le API di gestione delle credenziali o del profilo non sono supportati. Vedere il metodo e le matrici di integrazione per il confronto con l'autenticazione ospitata Microsoft e l'esperienza utente BYO.

Per gli eventi di estensione per l'autenticazione personalizzata supportati, vedere il confronto degli approcci. Per la configurazione, vedere Estensioni di autenticazione personalizzate.

Responsabilità di integrazione

Usare la guida alla configurazione e i riferimenti api per un'integrazione diretta oppure usare un JavaScript, Android o Apple SDK documentato. La guida rapida dell'SDK configura un esempio di React Next.js. I punti di ingresso sdk e le interfacce di continuazione supportate sono specifici del pacchetto e della piattaforma.

Responsabilità Ciò che la tua applicazione implementa
Gestione delle risposte Usa i più recenti state, action e i link per selezionare un'operazione consentita tramite una scelta dell'utente o la logica del flusso dell'applicazione.
Selezione del metodo Selezionare i metodi restituiti, usare hint mascherati dove necessario e seguire i collegamenti del metodo selezionato.
Insieme di attributi Raccogliere i valori in base ai requisiti dei campi restituiti e ai metadati di convalida. Non richiedere metadati di raggruppamento di pagine.
Continuità delle transazioni Mantenere il token di continuazione più recente in memoria e usarlo solo con collegamenti dalla stessa risposta.
Autorizzazione Richiedere inizialmente gli scope necessari e scambiare il codice di autorizzazione finale per i token.
Ripristino Gestire gli errori di convalida, la limitazione, la scadenza, le interazioni non supportate e l'annullamento senza riprodurre automaticamente le credenziali. Un accesso tramite browser configurato separatamente avvia un nuovo tentativo di autenticazione; non riprende il processo di autenticazione nativa in corso.

Le SPA con autenticazione nativa incorporata e i siti web BYO UX necessitano di un proxy o di un criterio di condivisione di risorse tra origini (CORS) sul proxy o sull'edge per le chiamate API del browser tra origini. Le app Android e iOS che usano trasporti HTTP nativi non richiedono CORS o un proxy CORS. Vedere Concetti di CORS per l'autenticazione nativa.

L'API di autenticazione nativa V2 richiede un dominio personalizzato verificato dal tenant per le app basate su browser, ad esempio le applicazioni a pagina singola (SPA), per proteggersi dalla contraffazione di richieste tra siti (CSRF). I client non browser, ad esempio le app Android e iOS che usano trasporti HTTP nativi, non richiedono un dominio personalizzato. Un browser o una visualizzazione Web incorporata non è un trasporto HTTP nativo. I siti Web dell'esperienza utente BYO richiedono comunque un dominio personalizzato verificato dal tenant. Configurare l'autorità di servizio prima di iniziare un flusso; vedere Configurare l'autorità API.

Limiti di sicurezza

L'applicazione gestisce le credenziali, quindi deve proteggere password, passcode monouso, token di continuazione, codici di autorizzazione e token emessi. Usare HTTPS, non registrare i corpi di autenticazione e non memorizzare nella cache le risposte alle credenziali. Verifica le authorities degli URL restituite prima di inviare i dati delle transazioni.

Usare la convalida lato client per aiutare i clienti a correggere l'input. Il servizio convalida le richieste di autenticazione.

Confini della sessione

L'autenticazione nativa incorporata supporta l'accesso Single Sign-On (SSO) per le visualizzazioni Web incorporate. Un'app nativa già autenticata richiede un token di accesso per la risorsa Web e lo include nell'intestazione Authorization della richiesta della webview. La risorsa convalida il token e stabilisce una sessione, consentendo l'accesso senza un altro prompt di accesso. Vedere Autenticare una visualizzazione Web incorporata da un'app nativa.

La disconnessione dall'app nativa non termina altre sessioni dell'applicazione o del browser. Cancellare separatamente la sessione di ogni applicazione quando è necessario il processo di disconnessione.

Configurazione dell'applicazione V1 esistente

Per le applicazioni V1 esistenti, abilita i flussi di autenticazione nativa e del client pubblico, quindi aggiorna la configurazione della piattaforma. Le informazioni di riferimento sull'API V1 descrivono i tipi di verifica e le funzionalità. Per un'integrazione basata su risposta, seguire Configurare un'applicazione per selezionare e configurare i punti di ingresso V2.

Accesso condizionale e frequenza di accesso

Microsoft Entra per ID esterno supporta il controllo di sessione frequenza di accesso (SIF) di Accesso condizionale sia per l'autenticazione ospitata da Microsoft che per l'autenticazione nativa.

Per l'autenticazione nativa, quando la riautenticazione è richiesta dai criteri, Microsoft Entra per ID esterno impedisce il rilascio dei token durante le concessioni di token di aggiornamento (grant_type=refresh_token). L'app deve gestire l'aggiornamento del token non riuscito e richiedere all'utente di accedere di nuovo prima di poter acquisire nuovi token. Il criterio di accesso non visualizza l'interfaccia utente di accesso per l'app.

Passaggi successivi