Microsoft Entra jogkivonat lekérése és az események eseményközpontba való küldése

A Microsoft Entra jogkivonat beszerzésének áttekintését lásd: Hitelesítés alkalmazásból.

Ez a cikk egy példa egy Microsoft Entra jogkivonat beszerzésére, amellyel eseményeket küldhet az Event Hubs-névtérbe, és fogadhat eseményeket. Tesztelési célokra használja a Postman eszközt.

Előfeltételek

• Kövesse a rövid útmutató utasításait: Az Azure Portal használatával hozzon létre egy eseményközpontot az Azure-ban egy Event Hubs-névtér és egy eseményközpont létrehozásához a névtérben.
• Töltse le és telepítse az asztali Postman alkalmazást.

Alkalmazás regisztrálása a Microsoft Entra ID

Első lépésként regisztrálja az alkalmazást a Microsoft Entra bérlővel, és jegyezze fel a bérlőazonosító, az ügyfélazonosító és az ügyfél titkos kódjának értékeit. Ezeket az értékeket a legújabban használja a REST API Postman eszközzel történő tesztelésekor.

1. Jelentkezzen be az Azure Portalra.

2. A keresősávon keresse meg a Microsoft Entra ID, és válassza ki a legördülő listából.

3. A Microsoft Entra ID lapon válassza a bal oldali menü Alkalmazásregisztrációk hivatkozását, majd az eszköztáron válassza az + Új regisztráció lehetőséget.

   

4. Adja meg az alkalmazás nevét , é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ának és a címtár-(bérlői) azonosítónak az értékeit. Ezekkel az értékekkel lekérhet egy jogkivonatot Microsoft Entra ID.

   

6. Most válassza a tanúsítványok & titkos kulcsokat a bal oldali menüben, majd válassza az + Új titkos ügyfélkód lehetőséget.

   

7. Adjon meg egy leírást, válassza ki, hogy mikor jár le a titkos kód, majd válassza a Hozzáadás lehetőséget.

   

8. Az ügyfél titkos kulcsainak listájában található titkos kód mellett található Másolás gombra kattintva másolja az értéket a vágólapra. Illessze be valahová. Később használhatja, hogy jogkivonatot szerezzen be Microsoft Entra ID.

   

Alkalmazás hozzáadása az Event Hubs adatküldő szerepkörhöz

Ebben a példában csak az eseményközpontba küldünk üzeneteket, ezért adja hozzá az alkalmazást az Azure Event Hubs adatküldő szerepkörhöz.

1. Az Event Hubs-névtér lapon válassza a hozzáférés-vezérlés lehetőséget a bal oldali menüben, majd válassza a Hozzáadás lehetőséget a Szerepkör-hozzárendelés hozzáadása csempén.

   

2. A Szerepkör-hozzárendelés hozzáadása lapon válassza Azure Event Hubs Szerepkör adatküldőjelehetőséget, majd válassza ki a szolgáltatásnévhez tartozó alkalmazást (ebben a példában ServiceBusRestClientApp).

   

3. A szerepkör-hozzárendelés mentéséhez válassza a Mentés lehetőséget a Szerepkör-hozzárendelés hozzáadása lapon.

A Postman használata a Microsoft Entra jogkivonat lekéréséhez

1. Indítsa el a Postmant.

2. A metódushoz válassza a GET lehetőséget.

3. Az URI mezőbe írja be a következőt https://login.microsoftonline.com/<TENANT ID>/oauth2/token: . Cserélje le a elemet <TENANT ID> a korábban másolt bérlőazonosító értékre.

4. A Fejlécek lapon adja hozzá a Content-Type billentyűt és application/x-www-form-urlencoded az értéket.

   

5. Váltson a Törzs lapra, és adja hozzá az alábbi kulcsokat és értékeket.

   1. Válassza az űrlap-adatok lehetőséget.

   2. Adja hozzá grant_type a kulcsot, és írja be client_credentials az értéket.

   3. Adja hozzá client_id a kulcsot, és illessze be a korábban feljegyzett ügyfél-azonosító értékét.

   4. Adja hozzá client_secret a kulcsot, és illessze be a korábban feljegyzett titkos ügyfélkód értékét.

   5. Adja hozzá resource a kulcsot, és írja be https://eventhubs.azure.net az értéket.

      

6. Válassza a Küldés lehetőséget a jogkivonat lekérésére vonatkozó kérés elküldéséhez. Az eredményben megjelenik a jogkivonat. Mentse a jogkivonatot (a dupla idézőjelek kivételével). Később használhatja.

   

Esemény küldése az eseményközpontba

1. A Postmanben nyisson meg egy új lapot.

2. Válassza a POST lehetőséget a metódushoz.

3. Adja meg az URI-t a következő formátumban: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Cserélje le <EVENT HUBS NAMESPACE NAME> a elemet az Event Hubs-névtér nevére. Cserélje le <QUEUE NAME> a elemet az üzenetsor nevére.

4. Az Élőfejek lapon adja hozzá a következő két fejlécet.

   1. Adja hozzá Authorization a kulcsot és az értéket a következő formátumban: Bearer <TOKEN from Microsoft Entra ID>. A jogkivonat másolása/beillesztésekor ne másolja a mellékelt dupla idézőjeleket.

   2. Adja hozzá Content-Type a kulcsot, és application/atom+xml;type=entry;charset=utf-8 adja hozzá az értéket.

      

5. A Törzs lapon válassza a nyers lehetőséget az adattípushoz, majd írja be This is a message vagy bármilyen üzenetet a törzshöz.

   

6. Válassza a Küldés lehetőséget az üzenet üzenetsorba való küldéséhez. Az alábbi képen látható módon a 201-as kódhoz hasonlóan Created jelenik meg az állapot.

   

7. A Azure Portal névtér lapján láthatja, hogy az üzenetek az üzenetsorba kerülnek.

   

Lásd még:

Lásd az alábbi cikkeket:

• Hitelesítés egy alkalmazásból
• A Microsoft Identitásplatform és az OAuth 2.0 hitelesítési kódfolyamat