Ottenere un token di Azure Active Directory (Azure AD) e usarlo per inviare messaggi a una coda del bus di servizio

  • Articolo

Vedere Autenticare da un'applicazione per una panoramica del recupero di un token di Azure Active Directory (Azure AD).

Questo articolo offre un esempio di recupero di un token di Azure AD che è possibile usare per inviare messaggi a uno spazio dei nomi del bus di servizio. Usa lo strumento Postman per scopi di test.

Prerequisiti

Registrare l'app con Azure AD

Il primo passaggio consiste nel registrare l'applicazione con il tenant di Azure AD e prendere nota dei valori dell'ID tenant, dell'ID client e del segreto client. Questi valori verranno 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 Azure Active Directory e selezionarlo nell'elenco a discesa.

    Cercare Azure Active Directory e selezionarlo

  3. Nella pagina Azure Active Directory selezionare Collegamento Registrazioni app nel menu a sinistra e quindi selezionare + Nuova registrazione sulla barra degli strumenti.

    Passare alla pagina Registrazioni app e selezionare Nuova registrazione

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

    Immettere un nome e selezionare Registra

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

    Annotare l'ID client e l'ID tenant

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

    Passare alla pagina Certificati & Segreti e selezionare Nuovo segreto client

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

    Immettere la descrizione, selezionare scadenza e selezionare Aggiungi

  8. Selezionare il pulsante copia accanto al valore segreto nell'elenco Segreti client per copiare il valore negli Appunti. Incollarlo da qualche parte. Verrà usato in un secondo momento per ottenere un token da Azure AD.

    Copiare il segreto client

Aggiungere l'applicazione al ruolo mittente dati del bus di servizio

In questo esempio si invia solo la messaggistica alla coda del bus di servizio, quindi aggiungere l'applicazione al ruolo Mittente dati del bus di servizio.

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

    Controllo di accesso -> Aggiungere un'assegnazione di ruolo

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

    Aggiungere l'app al ruolo bus di servizio 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 Azure AD

  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.

    Aggiungere 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://servicebus.azure.net per il valore.

      Impostare 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). sarà necessario più avanti.

    Token di accesso da Azure AD

Inviare messaggi a una coda

  1. In Postman aprire una nuova scheda.

  2. Selezionare POST per il metodo .

  3. Immettere l'URI nel formato seguente: https://<SERVICE BUS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Sostituire <SERVICE BUS NAMESPACE NAME> con il nome dello spazio dei nomi del bus di servizio. 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 Azure AD>. 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 del tipo di trattino di autorizzazione e contenuto selezionato come intestazioni nella coda del bus di servizio.

  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 del messaggio di test nella visualizzazione Corpo non elaborato della coda del bus di servizio.

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

    Stato riuscito

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

    I messaggi vengono pubblicati nella coda

    È anche possibile usare Esplora bus di servizio (anteprima) nella pagina Coda del bus di servizio , come illustrato nell'immagine seguente per ricevere o visualizzare messaggi di anteprima.

    Ricevere messaggi con Esplora bus di servizio

Vedere anche

Vedere gli articoli seguenti: