Esercitazione - Registrare e configurare l'app per dispositivi mobili iOS (Swift)
Questa serie di esercitazioni illustra come creare un'app per dispositivi mobili iOS (Swift) che esegue l'autenticazione tramite un tenant esterno. L'app viene registrata nel tenant del cliente e si crea un'app iOS (Swift), si implementa l'accesso, la disconnessione, quindi si chiama un'API Web protetta.
Questa esercitazione spiega come:
- Registrare un'applicazione nel tenant dei clienti.
- Aggiungere un URL di reindirizzamento della piattaforma
- Abilitare il flusso client pubblico.
- Aggiungere un'autorizzazione delegata per Microsoft Graph
Prerequisiti
- Xcode.
- Un tenant esterno. Se non si dispone già di una versione, iscriversi per ottenere una versione di valutazione gratuita.
Registrare un'applicazione
Per abilitare l'applicazione all'accesso utente con Microsoft Entra, è necessario che Microsoft Entra per ID esterno riconosca l'applicazione creata. La registrazione dell'app stabilisce una relazione di trust tra l'app e Microsoft Entra. Quando si registra un'applicazione, l'ID esterno genera un identificatore univoco noto come ID applicazione (client), un valore usato per identificare l'app durante la creazione di richieste di autenticazione.
La procedura seguente spiega come registrare l'app nell'Interfaccia di amministrazione di Microsoft Entra:
Accedere all’Interfaccia di amministrazione di Microsoft Entra almeno come sviluppatore di applicazioni.
Se si ha accesso a più tenant, usare l'icona Impostazioni nel menu in alto per passare al tenant esterno dal menu Directory e sottoscrizioni.
Passare a Identità>Applicazioni>Registrazioni app.
Seleziona + Nuova registrazione.
Nella pagina Registra un'applicazione che viene visualizzata:
- Immettere un nome significativo per l’applicazione da mostrare agli utenti dell'app, ad esempio ciam-client-app.
- In Tipi di account supportati selezionare Account solo in questa directory organizzativa.
Selezionare Registra.
Al termine della registrazione, viene visualizzato il riquadro Panoramica dell'applicazione. Registrare l'ID applicazione (client) da usare nel codice sorgente dell'applicazione.
Aggiungere un URL di reindirizzamento della piattaforma
Per specificare il tipo di app per la registrazione, seguire questa procedura:
- In Gestisci selezionare Autenticazione.
- Nella pagina Configurazioni della piattaforma, selezionare Aggiungi una piattaforma, quindi selezionare l'opzione iOS/macOS.
- Immettere l'ID del bundle del progetto. Se è stato scaricato il codice di esempio, il valore sarà
com.microsoft.identitysample.ciam.MSALiOS
. - Selezionare Configura e salvare la Configurazione MSAL visualizzata nel riquadro Configurazione di iOS/macOS per poterla inserire successivamente durante la configurazione dell'app.
- Selezionare Fatto.
Abilitare il flusso client pubblico
Per identificare l'app come client pubblico, seguire questa procedura:
In Gestisci selezionare Autenticazione.
In Impostazioni avanzate, selezionare Sì per Consenti flussi client pubblico.
Seleziona Salva per salvare le modifiche.
Concedere il consenso amministratore
Dopo aver registrato l'applicazione, viene assegnata l'autorizzazione User.Read . Tuttavia, poiché il tenant è un tenant esterno, gli utenti del cliente stessi non possono fornire il consenso a questa autorizzazione. L'amministratore deve fornire il consenso a questa autorizzazione per conto di tutti gli utenti nel tenant:
Nella pagina Registrazioni app, selezionare l'applicazione creata (ad esempio ciam-client-app) per aprire la relativa pagina Panoramica.
In Gestisci selezionare Autorizzazioni API.
- Selezionare Concedi consenso amministratore per <nome del tenant>, quindi selezionare Sì.
- Selezionare Aggiorna, quindi verificare che Concesso per <il nome> del tenant venga visualizzato in Stato per l'autorizzazione.