Share via


取得 Microsoft Entra 令牌,並使用它將事件傳送至事件中樞

如需取得 Microsoft Entra 令牌的概觀,請參閱從應用程式進行驗證

本文提供您取得 Microsoft Entra 令牌的範例,可讓您用來將事件傳送至事件中樞命名空間,並從中接收事件。 它會使用 Postman 工具進行測試。

必要條件

向 Microsoft Entra ID 註冊您的應用程式

第一個步驟是向 Microsoft Entra 租用戶註冊您的應用程式,並記下租用戶標識碼、用戶端標識碼和客戶端密碼的值。 使用 Postman 工具測試 REST API 時,您會使用這些值。

  1. 登入 Azure 入口網站

  2. 在搜尋列中,搜尋 Microsoft Entra ID,然後從下拉式清單中選取它。

  3. [Microsoft Entra ID] 頁面上,選取左側功能表上的 [應用程式註冊] 鏈接,然後選取工具列上的 [+ 新增註冊]。

    顯示 [應用程式註冊] 頁面的螢幕快照,其中已選取 [新增註冊] 連結。

  4. 輸入應用程式 的名稱 ,然後選取 [ 註冊]。

    顯示 [註冊應用程式] 頁面的螢幕快照。

  5. 在應用程式的首頁上,記下 應用程式 (用戶端) 標識符目錄 (租使用者) 標識符的值。 您可以使用這些值從 Microsoft Entra ID 取得令牌。

    此螢幕快照顯示醒目提示用戶端標識碼和租用戶標識碼的首頁。

  6. 現在,選取左側功能表上 的 [憑證 & 秘密 ],然後選取 [+ 新增客戶端密碼]。

    顯示 [憑證 & 秘密] 頁面的螢幕快照。

  7. 輸入 描述,選取秘密 到期的時間,然後選取 [ 新增]。

    顯示描述、選取到期時間和 [新增] 按鈕的螢幕快照。

  8. 選取 [ 客戶端密碼 ] 列表中秘密值旁邊的 [複製] 按鈕,將值複製到剪貼簿。 將它貼到某處。 您稍後會使用它,從 Microsoft Entra ID 取得令牌。

    顯示客戶端密碼按鈕的螢幕快照。

將應用程式新增至事件中樞數據傳送者角色

在此範例中,我們只會將訊息傳送至事件中樞,因此請將應用程式新增至 Azure 事件中樞 數據傳送者角色。

  1. 在 [事件中樞命名空間] 頁面上,從左側功能表中選取 [訪問控制],然後在 [新增角色指派] 圖格上選取 [新增]。

    顯示 [存取控制] 頁面的螢幕快照。

  2. 在 [新增角色指派] 頁面上,針對角色選取 [Azure 事件中樞 數據傳送者],然後在此範例中選取您的應用程式 (ServiceBusRestClientApp) 。

    顯示將應用程式新增至 Azure 事件中樞 資料寄件者角色的螢幕快照。

  3. 選取 [新增角色指派] 頁面上的 [儲存],以儲存角色指派。

使用 Postman 取得 Microsoft Entra 令牌

  1. 啟動Postman。

  2. 針對 方法,選取 [GET]。

  3. 針對 URI,輸入 https://login.microsoftonline.com/<TENANT ID>/oauth2/token。 將取代 <TENANT ID> 為您稍早複製的租用戶標識碼。

  4. 在 [ 標頭] 索引 標籤上,新增 Content-Type 索引鍵和 application/x-www-form-urlencoded 值。

    顯示內容類型標頭的螢幕快照。

  5. 切換至 [ 本文] 索引卷標,然後新增下列索引鍵和值。

    1. 選取 表單數據

    2. 新增 grant_type 索引鍵,並輸入 client_credentials 值。

    3. 新增 client_id 索引鍵,並貼上您稍早記下的 用戶端標識符 值。

    4. 新增 client_secret 金鑰,並貼上您稍早記下的 客戶端密碼 值。

    5. 新增 resource 索引鍵,並輸入 https://eventhubs.azure.net 值。

      顯示要求本文的螢幕快照。

  6. 選取 [傳送 ] 以傳送要求以取得令牌。 您會在結果中看到令牌。 儲存令牌 (排除雙引號) 。 您稍後會使用它。

    顯示來自 Microsoft Entra 存取令牌的螢幕快照。

將事件傳送至事件中樞

  1. 在 Postman 中,開啟新的索引標籤。

  2. 選取 方法的POST

  3. 以下列格式輸入 URI: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages。 將取代 <EVENT HUBS NAMESPACE NAME> 為事件中樞命名空間的名稱。 將 <QUEUE NAME> 取代為佇列名稱。

  4. 在 [ 標頭] 索引 標籤上,新增下列兩個標頭。

    1. 以下列格式為它新增 Authorization 索引鍵和值: Bearer <TOKEN from Microsoft Entra ID>。 當您複製/貼上令牌時,請勿複製括住的雙引號。

    2. 新增 Content-Type 索引鍵,並將其 application/atom+xml;type=entry;charset=utf-8 作為其值。

      事件中樞強調的 [標頭] 索引標籤螢幕快照。

  5. 在 [ 本文] 索引標籤上,選取數據類型 的原始 ,然後輸入 This is a message 或本文的任何訊息。

    事件中樞原始本文檢視中測試事件的螢幕快照。

  6. 選取 [傳送 ] 將訊息傳送至佇列。 您會看到與程式代碼 201 相同的狀態 Created ,如下圖所示。

    顯示成功狀態的螢幕快照。

  7. 在 Azure 入口網站 的命名空間頁面上,您可以看到訊息已張貼至佇列。

    顯示張貼至佇列之訊息的螢幕快照。

另請參閱

查看下列文章: