分享方式：

Azure Web PubSub 服務資料平面 REST API 參考

  • 文章

Diagram showing the Web PubSub service workflow.

如上述工作流程圖表所說明，以及內部 描述 的詳細工作流程，您的應用程式伺服器可以將訊息傳送至用戶端，或使用 Web PubSub 服務公開的 REST API 來管理連線的用戶端。 本文詳細說明 REST API。

使用 REST API

透過 Azure Web PubSub Service AccessKey 進行驗證

在每個 HTTP 要求中，需要具有 JSON Web 權杖 （JWT） 的 授權標頭，才能向 Azure Web PubSub 服務進行驗證。

簽署演算法和簽章

HS256，即 HMAC-SHA256，用來做為簽署演算法。

您應該使用 AccessKey Azure Web PubSub Service 實例連接字串中的 來簽署產生的 JWT 權杖。

宣告

下列宣告必須包含在 JWT 權杖中。

宣告類型 是必要的 描述
aud true 應該 與您的 HTTP 要求 URL 相同 。 例如，廣播要求的物件看起來像： https://example.webpubsub.azure.com/api/hubs/myhub/:send?api-version=2022-11-01 。
exp true 此權杖到期的 Epoch 時間。

JS 中的虛擬程式碼：

const bearerToken = jwt.sign({}, connectionString.accessKey, {
  audience: request.url,
  expiresIn: "1h",
  algorithm: "HS256",
});

透過 Microsoft Entra 權杖進行驗證

如同使用 AccessKey ， 也需要 JSON Web 權杖 （JWT） 來驗證 HTTP 要求。

差異在於 ，在此案例中，JWT 權杖是由 Microsoft Entra ID 所產生。

瞭解如何產生 Microsoft Entra 權杖

使用的認證範圍應該是 https://webpubsub.azure.com/.default 。

您也可以使用 角色型存取控制 （RBAC） 來授權伺服器對 Azure Web PubSub 服務的要求。

瞭解如何為您的資源設定角色型存取控制角色

API

作業群組 描述
服務狀態 提供檢查服務狀態的作業
中樞作業 提供作業來管理連線，並傳送訊息給它們。