Esercitazione - Registrare e configurare l'app per dispositivi mobili Android (Kotlin)
Questa serie di esercitazioni illustra come creare un'app per dispositivi mobili Android (Kotlin) che esegue l'autenticazione tramite un tenant esterno. L'app viene registrata nel tenant del cliente e si crea un'app Android (Kotlin), 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
- Un tenant esterno. Se non è già stato fatto, iscriversi per ottenere una versione di valutazione gratuita.
Registrare un'applicazione
Per abilitare l'applicazione all'accesso degli utenti con Microsoft Entra, è necessario che Microsoft Entra per ID esterno sia a conoscenza dell'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.
I passaggi seguenti illustrano come registrare l'app nell'interfaccia di amministrazione di Microsoft Entra:
Accedere alla 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 dell'applicazione significativo da mostrare agli utenti, ad esempio ciam-client-app.
- In Tipi di account supportati selezionare Account solo in questa directory organizzativa.
Selezionare Registra.
Il riquadro Panoramica dell'applicazione viene visualizzato al termine della registrazione. 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 Android.
- Immettere il nome del pacchetto del progetto. Se è stato scaricato il codice di esempio, il valore sarà
com.azuresamples.msaldelegatedandroidkotlinsampleapp
. - Nella sezione Hash della firma del riquadro Configurare l'app Android, selezionare Generazione di un hash della firma per lo sviluppo. Tale operazione cambia per ogni ambiente di sviluppo. Copiare ed eseguire il comando KeyTool per il sistema operativo corrente nel terminale.
- Immettere il valore di Hash della firma generato da KeyTool.
- Seleziona Configura.
- Copiare la Configurazione MSAL dal riquadro Configurazione Android e salvarla per la successiva 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
Nella pagina Registrazioni app, selezionare l'applicazione creata (ad esempio ciam-client-app) per aprire la relativa pagina di Panoramica.
In Gestisci selezionare Autorizzazioni API. Nell'elenco Autorizzazioni configurate, all'applicazione è stata assegnata l'autorizzazione User.Read. Tuttavia, poiché il tenant è esterno, gli utenti consumer 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:
- Selezionare Concedi consenso amministratore per <nome del tenant>, quindi selezionare Sì.
- Selezionare Aggiorna, quindi verificare che Concesso per <nome del tenant> sia visualizzato in Stato per entrambi gli ambiti.
Passaggi successivi
Esercitazione - Preparare l'app Android per l'autenticazione.