你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

如何为客户端生成客户端访问 URL

客户端(无论是浏览器 💻、移动应用 📱 还是 IoT 设备 💡)使用客户端访问 URL 来连接资源并对其进行身份验证。 此 URL 遵循 wss://<service_name>.webpubsub.azure.com/client/hubs/<hub_name>?access_token=<token> 的模式。 本文介绍获取客户端访问 URL 的几种方法。

从 Azure 门户复制

在 Azure 门户 的“密钥”选项卡中,有一个“客户端 URL 生成器”工具,可用于为你快速生成客户端访问 URL,如下图所示。 不存储此处输入的值。

Screenshot of the Web PubSub Client URL Generator.

从服务 SDK 生成

可以使用 Web PubSub 服务器 SDK 生成相同的客户端访问 URL。

  1. 按照服务器 SDK 入门创建 WebPubSubServiceClient 对象 service

  2. 通过调用 WebPubSubServiceClient.getClientAccessToken 来生成客户端访问 URL:

    • 配置用户 ID

      let token = await serviceClient.getClientAccessToken({ userId: "user1" });
      
    • 配置令牌的生存期

      let token = await serviceClient.getClientAccessToken({
        expirationTimeInMinutes: 5,
      });
      
    • 配置一个角色,以便在使用此客户端访问 URL 进行连接时可以直接加入组 group1

      let token = await serviceClient.getClientAccessToken({
        roles: ["webpubsub.joinLeaveGroup.group1"],
      });
      
    • 配置一个角色,以便在使用此客户端访问 URL 进行连接时,客户端可以直接将消息发送到组 group1

      let token = await serviceClient.getClientAccessToken({
        roles: ["webpubsub.sendToGroup.group1"],
      });
      
    • 配置组 group1,以便在使用此客户端访问 URL 进行连接后,客户端可以加入它

      let token = await serviceClient.getClientAccessToken({
        groups: ["group1"],
      });
      

在实际代码中,我们通常有一个服务器端来托管生成客户端访问 URL 的逻辑。 当客户端请求传入时,服务器端可以使用常规身份验证/授权工作流来验证客户端请求。 只有有效的客户端请求才能取回客户端访问 URL。

调用生成客户端令牌 REST API

可以在服务中启用 Microsoft Entra ID,并使用 Microsoft Entra 令牌来调用生成客户端令牌 REST API,以获取供客户端使用的令牌。

  1. 按照从应用程序授权中的要求启用 Microsoft Entra ID。

  2. 按照获取 Microsoft Entra 令牌中的要求,使用 Postman 获取 Microsoft Entra 令牌。

  3. 通过 Postman 使用 Microsoft Entra 令牌调用 :generateToken

    注意

    请使用最新版本的 Postman。 旧版本的 Postman 在路径中支持冒号:一些问题

    1. 对于 URI,请输入 https://{Endpoint}/api/hubs/{hub}/:generateToken?api-version=2022-11-01

    2. 在“身份验证”选项卡上,选择“持有者令牌”,并粘贴在上一步获取的 Microsoft Entra 令牌

    3. 选择“发送”,然后就会在响应中看到“客户端访问令牌”:

      {
        "token": "ABCDEFG.ABC.ABC"
      }
      
  4. 客户端访问 URI 的格式为 wss://<endpoint>/client/hubs/<hub_name>?access_token=<token>