Azure Active Directory (Azure AD) token beszerzése és az események küldése az Event hub-baGet an Azure Active Directory (Azure AD) token and use it send events to an event hub

A Azure Active Directory-(Azure AD-) token beszerzésének áttekintését lásd: hitelesítés alkalmazásból .See Authenticate from an application for an overview of getting an Azure Active Directory (Azure AD) token.

Ez a cikk egy olyan Azure Active Directory (Azure AD-) token beszerzését ismerteti, amely segítségével események küldhetők egy Service Bus névtérből, és fogadhat eseményeket.This article gives you an example of getting an Azure Active Directory (Azure AD) token that you can use to send events to and receive events from a Service Bus namespace. Tesztelési célokra a Poster eszközt használja.It uses the Postman tool for testing purposes.

ElőfeltételekPrerequisites

Az alkalmazás regisztrálása az Azure AD-benRegister your app with Azure AD

Első lépésként regisztrálnia kell az alkalmazást az Azure AD-Bérlővel, és fel kell jegyeznie a bérlői azonosító, az ügyfél-azonosító és az ügyfél titkos kulcsának értékeit.First step is to register you application with the Azure AD tenant and note down the values of tenant ID, client ID, and client secret. Ezeket az értékeket legutóbb fogja használni, amikor a Poster eszköz használatával teszteli a REST API.You will use these values latest when testing the REST API using the Postman tool.

  1. Jelentkezzen be az Azure Portalra.Sign in to the Azure portal.

  2. A keresési sávban keresse meg a Azure Active Directory, majd válassza ki a legördülő listából.In the search bar, search for Azure Active Directory, and select it from the drop-down list.

    Azure Active Directory keresése és kiválasztása

  3. A Azure Active Directory lapon válassza a bal oldali menüben az alkalmazás regisztrációi hivatkozása elemet, majd az eszköztáron válassza az + új regisztráció lehetőséget.On the Azure Active Directory page, select App Registrations link on the left menu, and then select + New registration on the toolbar.

    Váltson a Alkalmazásregisztrációk lapra, és válassza az új regisztráció lehetőséget.

  4. Adja meg az alkalmazás nevét , majd válassza a regisztrációlehetőséget.Enter a name for the app, and select Register.

    Adjon meg egy nevet, és válassza a regisztráció lehetőséget.

  5. Az alkalmazás kezdőlapján jegyezze fel az alkalmazás (ügyfél) azonosítóját és a címtár-(bérlői) azonosítóértékét.On the home page for the application, note down the values of Application (client) ID and Directory (tenant) ID. Ezeket az értékeket fogja használni az Azure AD-beli jogkivonat beszerzéséhez.You will use these values to get a token from Azure AD.

    Jegyezze fel az ügyfél-azonosítót és a bérlő AZONOSÍTÓját

  6. Most válassza ki a tanúsítványok & Secrets elemet a bal oldali menüben, és válassza az + új ügyfél titkalehetőséget.Now, select Certificates & secrets on the left menu, and select + New client secret.

    Váltson a tanúsítványok & titkok lapra, és válassza az új ügyfél titka elemet.

  7. Adja meg a leírást, válassza ki, hogy mikor járjon lea titkos kulcs, majd válassza a Hozzáadáslehetőséget.Enter a description, select when the secret will expire, and select Add.

    Adja meg a leírást, válassza ki a lejárati időt, és válassza a Hozzáadás lehetőséget.

  8. Válassza a titkos érték melletti másolás gombot az ügyfél- titkok listájában, és másolja az értéket a vágólapra.Select the copy button next to the secret value in the Client secrets list to copy the value to the clipboard. Illessze be valahova.Paste it somewhere. Később az Azure AD-ből származó token beszerzéséhez fogja használni.You will use it later to get a token from Azure AD.

    Ügyfél titkos kulcsának másolása

Alkalmazás hozzáadása a Event Hubs adatküldői szerepkörhözAdd application to the Event Hubs Data Sender role

Ebben a példában csak az Event hub-ra küldünk üzenetküldést, ezért az alkalmazást az Azure Event Hubs adatküldő szerepkörhöz adja hozzá.In this example, we are only sending messaging to the event hub, so add the application to the Azure Event Hubs Data Sender role.

  1. A Event Hubs névtér lapon a bal oldali menüben válassza a hozzáférés-vezérlés lehetőséget, majd válassza a Hozzáadás lehetőséget a szerepkör-hozzárendelés hozzáadása csempén.On the Event Hubs Namespace page, select Access control from the left menu, and then select Add on the Add a role assignment tile.

    Hozzáférés-vezérlés – > szerepkör-hozzárendelés hozzáadása

  2. A szerepkör-hozzárendelés hozzáadása lapon válassza az Azure Event Hubs Adatfeladó a szerepkörhözlehetőséget, majd válassza ki az alkalmazást (ebben a példában a ServiceBusRestClientApp) az egyszerű szolgáltatásnév számára.On the Add role assignment page, select Azure Event Hubs Data Sender for Role, and select your application (in this example, ServiceBusRestClientApp) for the service principal.

    Alkalmazás hozzáadása az Azure Event Hubs adatfeladói szerepkörhöz

  3. A szerepkör-hozzárendelés mentéséhez válassza a szerepkör-hozzárendelés hozzáadása lap Mentés elemét.Select Save on the Add role assignment page to save the role assignment.

Az Azure AD-jogkivonat beszerzése a Poster használatávalUse Postman to get the Azure AD token

  1. Poster elindítása.Launch Postman.

  2. A metódushoz válassza a beolvasáslehetőséget.For the method, select GET.

  3. Az URI esetében adja meg a következőt: https://login.microsoftonline.com/<TENANT ID>/oauth2/token .For the URI, enter https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Cserélje le <TENANT ID> a értéket a korábban átmásolt bérlői azonosítóra.Replace <TENANT ID> with the tenant ID value you copied earlier.

  4. A fejlécek lapon adja hozzá a Content-Type kulcsot és az application/x-www-form-urlencoded értéket.On the Headers tab, add Content-Type key and application/x-www-form-urlencoded for the value.

    Content-Type fejléc hozzáadása

  5. Váltson a törzs lapra, és adja hozzá az alábbi kulcsokat és értékeket.Switch to the Body tab, and add the following keys and values.

    1. Válassza ki az űrlap-az adattípust.Select form-data.

    2. Adja hozzá grant_type a kulcsot, és írja be client_credentials az értéket.Add grant_type key, and type client_credentials for the value.

    3. Adja hozzá client_id a kulcsot, és illessze be a korábban feljegyzett ügyfél-azonosító értékét.Add client_id key, and paste the value of client ID you noted down earlier.

    4. Adja hozzá client_secret a kulcsot, és illessze be a korábban feljegyzett ügyfél titkos kulcs értékét.Add client_secret key, and paste the value of client secret you noted down earlier.

    5. Adja hozzá resource a kulcsot, és írja be https://servicebus.azure.net az értéket.Add resource key, and type https://servicebus.azure.net for the value.

      A kérelem törzsének beállítása

  6. Kattintson a Küldés gombra a jogkivonat beszerzéséhez szükséges kérelem elküldéséhez.Select Send to send the request to get the token. Ekkor megjelenik a token az eredményben.You see the token in the result. Mentse a jogkivonatot (idézőjelek nélkül).Save the token (excluding double quotes). Erre később még szüksége lesz.You will use it later.

    Hozzáférési jogkivonat az Azure AD-ből

Üzenetek küldése egy üzenetsorbaSend messages to a queue

  1. Nyisson meg egy új lapot a Poster-ben.In Postman, open a new tab.

  2. Válassza a post lehetőséget a metódushoz.Select POST for the method.

  3. Adja meg az URI-t a következő formátumban: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages .Enter URI in the following format: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Cserélje le a <EVENT HUBS NAMESPACE NAME> nevet a Event Hubs névtér nevére.Replace <EVENT HUBS NAMESPACE NAME> with the name of the Event Hubs namespace. Cserélje le a <QUEUE NAME> nevet a várólista nevére.Replace <QUEUE NAME> with the name of the queue.

  4. A fejlécek lapon adja hozzá a következő két fejlécet.On the Headers tab, add the following two headers.

    1. Adja hozzá a Authorization kulcsot és az értéket a következő formátumban: Bearer <TOKEN from Azure AD> .Add Authorization key and value for it in the following format: Bearer <TOKEN from Azure AD>. A token másolása/beillesztése során ne másolja a befoglaló idézőjeleket.When you copy/paste the token, don't copy the enclosing double quotes.

    2. Adja hozzá Content-Type a kulcsot és application/atom+xml;type=entry;charset=utf-8 az értéket.Add Content-Type key and application/atom+xml;type=entry;charset=utf-8 as the value for it.

      Az üzenet fejléce

  5. A törzs lapon válassza a nyers lehetőséget az adattípushoz, és adja meg vagy írja be This is a message a törzs bármely üzenetét.On the Body tab, select raw for the data type, and enter This is a message or any message for the body.

    Az üzenet fejléce

  6. Kattintson a Küldés gombra az üzenet várólistába küldéséhez.Select Send to send the message to the queue. A 201-as kóddal megtekintheti az állapotot az Created alábbi képen látható módon.You see the status as Created with the code 201 as shown in the following image.

    Sikeres állapot

  7. A Azure Portal névtér lapján láthatja, hogy az üzenetek a várólistára kerülnek.On the namespace page in the Azure portal, you can see that the messages are posted to the queue.

    Üzenetek elküldve a várólistára

Lásd még:See Also

Lásd az alábbi cikkeket:See the following articles: