Esercitazione: registrare un'API Web con Microsoft Identity Platform

Questa esercitazione illustra come registrare un'API Web con un tenant Microsoft Entra ID. È necessario registrare un'applicazione nell'interfaccia di amministrazione di Microsoft Entra per permettere all'applicazione di interagire con Microsoft Identity Platform. In questo articolo si apprenderà come:

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Questo account di Azure deve disporre delle autorizzazioni per gestire le applicazioni. Usare uno dei ruoli seguenti necessari per registrare l'applicazione:
  • Amministratore di applicazioni
  • Sviluppatore di applicazioni
  • Amministratore applicazione cloud

Registrare l'applicazione e gli identificatori del record

Per completare la registrazione, specificare un nome dell'applicazione e specificare i tipi di account supportati. Dopo la registrazione,nel riquadro Panoramica dell'applicazione vengono visualizzati gli identificatori necessari nel codice sorgente dell'applicazione.

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come sviluppatore di applicazioni.

2. Se si ha accesso a più tenant, usare l'icona Impostazioni nel menu in alto per passare al tenant in cui si vuole registrare l'applicazione dal menu Directory e sottoscrizioni.

3. Passare a Identità>Applicazioni>Registrazioni app.

4. Seleziona Nuova registrazione.

5. Immettere un nome per l'applicazione, ad esempio NewWebAPI1.

6. Per Tipi di account supportati selezionare Account solo in questa directory dell'organizzazione. Per informazioni sui diversi tipi di account selezionare l'opzione Suggerimenti per la scelta.

7. Selezionare Registra.

   

8. Al termine della registrazione viene visualizzato il riquadro Panoramica dell'applicazione. Registrare l'ID directory (tenant) e l'ID applicazione (client) da usare nel codice sorgente dell'applicazione.

   

Esporre un'API

Dopo aver registrato l'API, è possibile configurarne l'autorizzazione definendo gli ambiti esposti dall'API alle applicazioni client. Le applicazioni client richiedono l'autorizzazione per eseguire operazioni passando un token di accesso insieme alle relative richieste all'API Web protetta. L'API Web esegue quindi l'operazione richiesta solo se il token di accesso ricevuto contiene gli ambiti richiesti.

1. In Gestisci selezionare Esporre un'API > Aggiungi un ambito . Accettare l'URI ID applicazione(api://{clientId}) proposto selezionando Salva e continua. {clientId} sarà il valore registrato dalla pagina Panoramica. Immettere quindi le informazioni seguenti:

   1. Per Nome ambito, immettere Forecast.Read.
   2. Per Utenti che possono fornire il consenso assicurarsi che sia selezionata l'opzione Amministratori e utenti.
   3. Nella casella Nome visualizzato del consenso amministratore immettere Read forecast data.
   4. Nella casella di Descrizione del consenso amministratore immettere Allows the application to read weather forecast data.
   5. Nella casella Nome visualizzato del consenso utente immettere Read forecast data.
   6. Nella casella di Descrizione del consenso utente immettere Allows the application to read weather forecast data.
   7. Assicurarsi che lo Stato sia impostato su Abilitato.

2. Seleziona Aggiungi ambito. Se l'ambito è stato immesso correttamente, verrà elencato nel riquadro Esponi un'API.

   

Passaggi successivi