Ottenere un token di Microsoft Entra e usarlo per inviare eventi a un hub eventi

  • Articolo

Vedere Autenticare da un'applicazione per una panoramica del recupero di un token di Microsoft Entra.

Questo articolo offre un esempio di recupero di un token di Microsoft Entra che è possibile usare per inviare eventi a e ricevere eventi da uno spazio dei nomi di Hub eventi. Usa lo strumento Postman per scopi di test.

Prerequisiti

Registrare l'app con Microsoft Entra ID

Il primo passaggio consiste nel registrare l'applicazione con il tenant Microsoft Entra e prendere nota dei valori di ID tenant, ID client e segreto client. Questi valori vengono usati più recenti durante il test dell'API REST usando lo strumento Postman.

  1. Accedere al portale di Azure.

  2. Nella barra di ricerca cercare Microsoft Entra ID e selezionarlo nell'elenco a discesa.

  3. Nella pagina Microsoft Entra ID selezionare Registrazione app nel menu a sinistra e quindi selezionare + Nuova registrazione sulla barra degli strumenti.

    Screenshot che mostra la pagina Registrazioni app con il collegamento Nuova registrazione selezionata.

  4. Immettere un nome per l'app e selezionare Registra.

    Screenshot che mostra la pagina Registra applicazione.

  5. Nella home page dell'applicazione prendere nota dei valori dell'ID applicazione (client) e dell'ID directory (tenant). Questi valori vengono usati per ottenere un token da Microsoft Entra ID.

    Screenshot che mostra la home page con ID client e ID tenant evidenziato.

  6. Selezionare Certificati & segreti nel menu a sinistra e selezionare + Nuovo segreto client.

    Screenshot che mostra la pagina Certificati & Segreti.

  7. Immettere una descrizione, selezionare alla scadenza del segreto e selezionare Aggiungi.

    Screenshot che mostra la descrizione, selezionare ora di scadenza e il pulsante Aggiungi.

  8. Selezionare il pulsante copia accanto al valore segreto nell'elenco Segreti client per copiare il valore negli Appunti. Incollarlo da qualche parte. Lo si usa in un secondo momento per ottenere un token da Microsoft Entra ID.

    Screenshot che mostra il pulsante segreto client.

Aggiungere l'applicazione al ruolo Mittente dati dell'hub eventi

In questo esempio si invia solo la messaggistica all'hub eventi, quindi aggiungere l'applicazione al ruolo Hub eventi di Azure mittente dati.

  1. Nella pagina Spazio dei nomi hub eventi selezionare Controllo di accesso dal menu a sinistra e quindi selezionare Aggiungi nel riquadro Aggiungi un'assegnazione di ruolo .

    Screenshot che mostra la pagina Controllo di accesso.

  2. Nella pagina Aggiungi assegnazione ruolo selezionare Hub eventi di Azure Mittente dati per ruolo e selezionare l'applicazione (in questo esempio ServiceBusRestClientApp) per l'entità servizio.

    Screenshot che mostra l'aggiunta dell'app al ruolo Hub eventi di Azure Mittente dati.

  3. Selezionare Salva nella pagina Aggiungi assegnazione ruolo per salvare l'assegnazione di ruolo.

Usare Postman per ottenere il token di Microsoft Entra

  1. Avviare Postman.

  2. Per il metodo selezionare GET.

  3. Per l'URI immettere https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Sostituire <TENANT ID> con il valore ID tenant copiato in precedenza.

  4. Nella scheda Intestazioni aggiungere la chiave Tipo di contenuto e application/x-www-form-urlencoded per il valore.

    Screenshot che mostra l'intestazione del tipo di contenuto.

  5. Passare alla scheda Corpo e aggiungere le chiavi e i valori seguenti.

    1. Selezionare form-data.

    2. Aggiungere grant_type chiave e digitare client_credentials per il valore.

    3. Aggiungere client_id chiave e incollare il valore dell'ID client annotato in precedenza.

    4. Aggiungere client_secret chiave e incollare il valore del segreto client annotato in precedenza.

    5. Aggiungere resource chiave e digitare https://eventhubs.azure.net per il valore.

      Screenshot che mostra il corpo della richiesta.

  6. Selezionare Invia per inviare la richiesta per ottenere il token. Viene visualizzato il token nel risultato. Salvare il token (escluso virgolette doppie). La si usa in un secondo momento.

    Screenshot che mostra il token di accesso da Microsoft Entra.

Inviare un evento all'hub eventi

  1. In Postman aprire una nuova scheda.

  2. Selezionare POST per il metodo .

  3. Immettere l'URI nel formato seguente: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Sostituire <EVENT HUBS NAMESPACE NAME> con il nome dello spazio dei nomi hub eventi. Sostituire <QUEUE NAME> con il nome della coda.

  4. Nella scheda Intestazioni aggiungere le due intestazioni seguenti.

    1. Aggiungere Authorization chiave e valore per esso nel formato seguente: Bearer <TOKEN from Microsoft Entra ID>. Quando si copia/incolla il token, non copiare le virgolette doppie racchiuse.

    2. Aggiungere Content-Type chiave e application/atom+xml;type=entry;charset=utf-8 come valore per esso.

      Screenshot della scheda Intestazioni evidenziata nell'hub eventi.

  5. Nella scheda Corpo selezionare non elaborato per il tipo di dati e immettere o qualsiasi This is a message messaggio per il corpo.

    Screenshot dell'evento di test nella visualizzazione Corpo non elaborato nell'hub eventi.

  6. Selezionare Invia per inviare il messaggio alla coda. Lo stato viene visualizzato come Created con il codice 201, come illustrato nell'immagine seguente.

    Screenshot che mostra lo stato riuscito.

  7. Nella pagina dello spazio dei nomi nella portale di Azure è possibile notare che i messaggi vengono pubblicati nella coda.

    Screenshot che mostra i messaggi pubblicati nella coda.

Vedere anche

Vedere gli articoli seguenti: