上游终结点

上游终结点功能允许 Azure SignalR 服务以无服务器模式将消息和连接事件发送到一组终结点。 可以使用上游终结点在无服务器模式下从客户端调用某个中心方法，以在客户端建立连接或断开连接时通知终结点。

上游终结点设置

上游终结点的设置包含一系列顺序敏感项：

• 一个 URL 模板，它指定将消息发送到的位置。
• 一组规则。
• 身份验证配置。

触发事件时，将按顺序逐个检查项的规则。 消息将发送到第一个匹配项的上游终结点 URL。

URL 模板设置

可以将上游终结点 URL 参数化以支持各种模式。 有三个预定义的参数：

这些预定义参数可用于 URL 模式。 在评估上游终结点 URL 时，参数将替换为某个指定的值。 例如：

http://host.com/{hub}/api/{category}/{event}

当“聊天”中心内建立了某个客户端连接时，会向以下 URL 发送消息：

http://host.com/chat/api/connections/connected

当“聊天”中心内的客户端调用中心方法 broadcast 时，会向以下 URL 发送消息：

http://host.com/chat/api/messages/broadcast

URL 模板设置中的 Key Vault 机密引用

上游终结点 URL 未加密。 可以使用 Key Vault 保护敏感的上游终结点，并使用托管标识访问它们。

若要在 SignalR 服务实例中启用托管标识并授予其 Key Vault 访问权限，请执行以下操作：

1. 添加系统分配的标识或用户分配的标识。 请参阅如何在 Azure 门户中添加托管标识。

2. 在 Key Vault 的访问策略中授予对托管标识的机密读取权限。 请参阅使用 Azure 门户分配 Key Vault 访问策略

3. 在上游终结点 URL 模式中将敏感文本替换为以下语法：

   {@Microsoft.KeyVault(SecretUri=<secret-identity>)}
   

   <secret-identity> 是 Key Vault 中机密的完整数据平面 URI，可以选择包括版本，例如 https://myvault.vault.azure.cn/secrets/mysecret/ 或 https://myvault.vault.azure.cn/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931

   例如，完整的引用将如下所示：

   {@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.cn/secrets/mysecret/)}
   

   Azure 函数的上游终结点 URL 如下所示：

   https://contoso.chinacloudsites.cn/runtime/webhooks/signalr?code={@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.cn/secrets/mysecret/)}
   

规则设置

可以分别设置“中心规则”、“类别规则”和“事件规则”。 匹配规则支持三种格式：

• 使用星号 (*) 来匹配任何事件。
• 使用逗号 (,) 来联接多个事件。 例如，connected, disconnected 匹配“已连接”和“已断开连接”事件。
• 使用完整的事件名称来匹配事件。 例如，connected 匹配“已连接”事件。

身份验证设置

你可以分别为每个上游终结点设置配置身份验证。 配置身份验证时，会在上游消息的 Authentication 标头中设置令牌。 目前，Azure SignalR 服务支持以下身份验证类型：

• None
• ManagedIdentity

选择 ManagedIdentity 时，必须首先在 Azure SignalR 服务中启用托管标识，并且可以根据需要指定资源。 有关详细信息，请参阅 Azure SignalR 服务的托管标识。

通过 Azure 门户配置上游终结点设置

1. 转到“Azure SignalR 服务”。
2. 选择“设置”。
3. 将“服务模式”切换为“无服务器”。
4. 在“上游 URL 模式”下添加 URL。
5. 选择“中心规则”以打开“上游设置”。
6. 通过在相应字段中输入规则值来更改“中心规则”、“事件规则”和“类别规则”。
7. 在“上游身份验证”下选择
8. “使用托管标识”。 （确保已启用托管标识）
9. 在“颁发的令牌中的受众”下选择任意选项。 有关详细信息，请参阅 Azure SignalR 服务的托管标识。

通过资源管理器模板配置上游终结点设置

若要使用 Azure 资源管理器模板配置上游终结点设置，请在 properties 属性中设置 upstream 属性。 以下代码片段显示了如何设置用于创建和更新上游终结点设置的 upstream 属性。

{
  "properties": {
    "upstream": {
      "templates": [
        {
          "UrlTemplate": "http://host.com/{hub}/api/{category}/{event}",
          "EventPattern": "*",
          "HubPattern": "*",
          "CategoryPattern": "*",
          "Auth": {
            "Type": "ManagedIdentity",
            "ManagedIdentity": {
              "Resource": "<resource>"
            }
          }
        }
      ]
    }
  }
}

无服务器协议

Azure SignalR 服务将消息发送到遵循以下协议的终结点。 可以将 SignalR 服务触发器绑定用于处理这些协议的 Function App。

方法

POST

请求头

请求正文

连续

Content-Type：application/json

已断开连接

Content-Type：application/json

调用消息

Content-Type：application/json 或 application/x-msgpack

签名

服务将同时使用主要访问密钥和辅助访问密钥作为 HMAC 密钥来计算 X-ASRS-Connection-Id 值的 SHA256 代码。 向上游终结点发出 HTTP 请求时，服务会在 X-ASRS-Signature 标头中设置该代码：

Hex_encoded(HMAC_SHA256(accessKey, connection-id))

后续步骤

• Azure SignalR 服务的托管标识
• 通过 Azure SignalR 服务进行的 Azure Functions 开发和配置
• 处理来自 SignalR 服务的消息（触发绑定）
• SignalR 服务触发器绑定示例