共用方式為


取得 Azure Active Directory (Azure AD) 令牌,並用它來將訊息傳送至服務總線佇列

如需取得 Azure Active Directory (Azure AD) 令牌的概觀,請參閱 從應用程式進行驗證

本文提供您取得可用來將訊息傳送至服務總線命名空間的 Azure AD 令牌範例。 它會使用 Postman 工具進行測試。

必要條件

向 Azure AD 註冊您的應用程式

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

  1. 登入 Azure 入口網站

  2. 在搜尋列中搜尋 Azure Active Directory,然後從下拉式清單中選取它。

    搜尋 Azure Active Directory 並加以選取

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

    切換至 [應用程式註冊] 頁面,然後選取 [新增註冊]

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

    輸入名稱並選取 [註冊]

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

    記下用戶端識別碼和租用戶標識碼

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

    切換至 [憑證 & 秘密] 頁面,然後選取 [新增客戶端密碼]

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

    輸入描述、選取到期時間,然後選取 [新增]

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

    複製用戶端密碼

將應用程式新增至服務總線數據傳送者角色

在此範例中,我們只會將訊息傳送至服務總線佇列,因此請將應用程式新增至 服務總線數據傳送者 角色。

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

    訪問控制 -> 新增角色指派

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

    將應用程式新增至 Azure 服務匯流排 數據傳送者角色

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

使用 Postman 取得 Azure AD 令牌

  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://servicebus.azure.net 值。

      設定要求的本文

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

    從 Azure AD 存取令牌

傳送訊息至佇列

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

  2. 選取 方法的POST

  3. 以下列格式輸入 URI: https://<SERVICE BUS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages。 將取代 <SERVICE BUS NAMESPACE NAME> 為服務總線命名空間的名稱。 將 <QUEUE NAME> 取代為佇列名稱。

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

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

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

      在服務總線佇列中選取為標頭的 [授權] 和 [內容虛線類型] 螢幕快照。

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

    服務總線佇列原始本文檢視中測試訊息的螢幕快照。

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

    成功狀態

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

    訊息會張貼至佇列

    您也可以在 [服務總線佇列] 頁面上使用服務總線總管 (預覽) ,如下圖所示來接收或查看訊息。

    使用服務總線總管接收訊息

另請參閱

查看下列文章: