Získání tokenu Microsoft Entra a jeho použití k odesílání událostí do centra událostí

Přehled získání tokenu Microsoft Entra najdete v tématu Ověřování z aplikace.

Tento článek obsahuje příklad získání tokenu Microsoft Entra, který můžete použít k odesílání událostí a přijímání událostí z oboru názvů služby Event Hubs. Pro účely testování používá nástroj Postman .

Požadavky

Registrace aplikace pomocí Microsoft Entra ID

Prvním krokem je registrace aplikace v tenantovi Microsoft Entra a poznamenejte si hodnoty ID tenanta, ID klienta a tajného klíče klienta. Tyto hodnoty použijete nejpozději při testování rozhraní REST API pomocí nástroje Postman.

  1. Přihlaste se k webu Azure Portal.

  2. Na panelu hledání vyhledejte Microsoft Entra ID a vyberte ho v rozevíracím seznamu.

  3. Na stránce Microsoft Entra ID vyberte v nabídce vlevo odkaz Registrace aplikací a pak na panelu nástrojů vyberte + Nová registrace.

    Snímek obrazovky se stránkou Registrace aplikací s vybraným odkazem Na novou registraci

  4. Zadejte název aplikace a vyberte Zaregistrovat.

    Snímek obrazovky se stránkou Registrace aplikace

  5. Na domovské stránce aplikace si poznamenejte hodnoty ID aplikace (klienta) a ID adresáře (tenanta). Tyto hodnoty použijete k získání tokenu z Microsoft Entra ID.

    Snímek obrazovky s domovskou stránkou se zvýrazněným ID klienta a ID tenanta

  6. Teď v nabídce vlevo vyberte Certifikáty & tajných kódů a vyberte + Nový tajný klíč klienta.

    Snímek obrazovky zobrazující stránku Certifikáty & tajné kódy

  7. Zadejte popis, vyberte, kdy vyprší platnost tajného klíče, a vyberte Přidat.

    Snímek obrazovky s popisem, výběrem možnosti Čas vypršení platnosti a tlačítkem Přidat

  8. Výběrem tlačítka kopírovat vedle hodnoty tajného klíče v seznamu Tajné kódy klienta zkopírujte hodnotu do schránky. Vložte ho někam. Později ho použijete k získání tokenu z Microsoft Entra ID.

    Snímek obrazovky s tlačítkem tajného klíče klienta

Přidání aplikace do role Odesílatele dat služby Event Hubs

V tomto příkladu posíláme zprávy jenom do centra událostí, takže přidejte aplikaci do role Azure Event Hubs Data Sender.

  1. Na stránce Obor názvů služby Event Hubs v nabídce vlevo vyberte Řízení přístupu a pak na dlaždici Přidat přiřazení role vyberte Přidat.

    Snímek obrazovky zobrazující stránku Access Control

  2. Na stránce Přidat přiřazení role vyberte Azure Event Hubs Odesílatele dat jako Role a jako instanční objekt vyberte aplikaci (v tomto příkladu ServiceBusRestClientApp).

    Snímek obrazovky znázorňující přidání aplikace do role Azure Event Hubs Data Sender

  3. Výběrem možnosti Uložit na stránce Přidat přiřazení role uložte přiřazení role.

Získání tokenu Microsoft Entra pomocí nástroje Postman

  1. Spusťte Nástroj Postman.

  2. Jako metodu vyberte GET.

  3. Jako identifikátor URI zadejte https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Nahraďte <TENANT ID> hodnotou ID tenanta, kterou jste zkopírovali dříve.

  4. Na kartě Headers (Záhlaví ) přidejte jako hodnotu klíč Content-Type (Typ obsahu) a application/x-www-form-urlencoded .

    Snímek obrazovky se záhlavím typu obsahu

  5. Přepněte na kartu Text a přidejte následující klíče a hodnoty.

    1. Vyberte form-data.

    2. Přidejte grant_type klíč a zadejte client_credentials hodnotu.

    3. Přidejte client_id klíč a vložte hodnotu ID klienta , kterou jste si poznamenali dříve.

    4. Přidejte client_secret klíč a vložte hodnotu tajného klíče klienta , kterou jste si poznamenali dříve.

    5. Přidejte resource klíč a zadejte https://eventhubs.azure.net hodnotu.

      Snímek obrazovky s textem žádosti

  6. Výběrem možnosti Odeslat odešlete žádost o získání tokenu. Ve výsledku se zobrazí token. Uložte token (s výjimkou dvojitých uvozovek). Použijete ho později.

    Snímek obrazovky znázorňující přístupový token z Microsoft Entra

Odeslání události do centra událostí

  1. V nástroji Postman otevřete novou kartu.

  2. Jako metodu vyberte POST .

  3. Zadejte identifikátor URI v následujícím formátu: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Nahraďte <EVENT HUBS NAMESPACE NAME> názvem oboru názvů Event Hubs. Nahraďte <QUEUE NAME> názvem fronty.

  4. Na kartě Záhlaví přidejte následující dvě záhlaví.

    1. Přidejte Authorization klíč a hodnotu v následujícím formátu: Bearer <TOKEN from Microsoft Entra ID>. Při kopírování nebo vkládání tokenu nekopírujte uzavřené dvojité uvozovky.

    2. Přidejte Content-Type klíč a application/atom+xml;type=entry;charset=utf-8 jako jeho hodnotu.

      Snímek obrazovky s kartou Záhlaví zvýrazněnou v centru událostí

  5. Na kartě Text vyberte jako datový typ nezpracovaný a jako text zadejte This is a message nebo libovolnou zprávu.

    Snímek obrazovky testovací události v nezpracovaném zobrazení textu v centru událostí

  6. Vyberte Odeslat a odešlete zprávu do fronty. Zobrazí se stav Created s kódem 201, jak je znázorněno na následujícím obrázku.

    Snímek obrazovky se stavem úspěch

  7. Na stránce oboru názvů v Azure Portal uvidíte, že se zprávy odesílají do fronty.

    Snímek obrazovky zobrazující zprávy, které se odesílají do fronty

Viz také

Viz následující články: