Конечные точки вышестоящего потока

Функция вышестоящих конечных точек позволяет Служба Azure SignalR отправлять сообщения и события подключения в набор конечных точек в бессерверном режиме. Вы можете использовать вышестоящие конечные точки для вызова методов концентратора клиентами в бессерверном режиме, чтобы уведомлять конечные точки о подключении или отключении клиентов.

Параметры вышестоящей конечной точки

Параметры вышестоящей конечной точки состоят из списка элементов с учетом порядка:

• Шаблон URL-адреса, указывающий, куда отправляются сообщения.
• Набор правил.
• Конфигурации проверки подлинности.

При срабатывании события правила элемента проверяются последовательно. Сообщения будут отправлены на URL-адрес вышестоящей конечной точки первого соответствующего элемента.

Параметры шаблона URL-адреса

Вы можете параметризировать URL-адрес конечной точки входящего трафика для поддержки различных шаблонов. Есть три предопределенных параметра:

Эти предопределенные параметры можно использовать в шаблоне URL-адреса. Параметры будут заменены указанным значением при оценке URL-адреса вышестоящей конечной точки. Например:

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

При подключении клиента в концентраторе "chat" сообщение будет отправлено на этот URL-адрес:

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

Когда клиент в концентраторе "chat" вызывает метод концентратора broadcast, сообщение будет отправлено на этот URL-адрес:

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

Ссылка на секрет Azure Key Vault в параметрах шаблона URL-адреса

URL-адрес вышестоящей конечной точки не шифруется. Вы можете защитить конфиденциальные конечные точки вышестоящего потока с помощью Key Vault и получить к ним доступ с помощью управляемого удостоверения.

Чтобы включить управляемое удостоверение в экземпляре службы SignalR и предоставить ней доступ к Key Vault:

1. Добавьте удостоверение, назначенное системой, или удостоверение, назначенное пользователем. Узнайте, как добавить управляемое удостоверение в портал Azure.

2. Предоставьте разрешение на чтение секрета для управляемого удостоверения в политиках доступа хранилища ключей (Key Vault). См. статью Назначение политики доступа Key Vault с помощью портала Microsoft Azure

3. Замените конфиденциальный текст приведенным ниже синтаксисом в шаблоне URL-адреса вышестоящей конечной точки:

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

   <secret-identity> — полный URI плоскости данных секрета в Key Vault, при необходимости включая версию, например https://myvault.vault.azure.net/secrets/mysecret/ или https://myvault.vault.azure.net/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931

   Вот пример полной ссылки:

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

   URL-адрес вышестоящей конечной точки функции Azure выглядит следующим образом:

   https://contoso.azurewebsites.net/runtime/webhooks/signalr?code={@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.net/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.

Настройка параметров вышестоящей конечной точки с помощью шаблона Resource Manager

Чтобы настроить параметры входной конечной точки с помощью шаблона Azure Resource Manager, задайте свойство upstream в свойстве properties. В следующем фрагменте кода показано, как задать 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, которая обрабатывает эти протоколы для вас.

Способ

ПОСТ

Заголовок запроса

Текст запроса

Подключено

Тип содержимого: application/json

Отключено

Тип содержимого: application/json

Сообщение вызова

Content-Type: application/json или application/x-msgpack

Подпись

Служба вычислит код SHA256 для значения X-ASRS-Connection-Id, используя основной и вспомогательный ключи доступа в качестве ключа HMAC. Служба устанавливает ее в заголовке X-ASRS-Signature при выполнении HTTP-запросов к вышестоящей конечной точке:

Hex_encoded(HMAC_SHA256(accessKey, connection-id))

Следующие шаги

• Управляемые удостоверения для Службы Azure SignalR
• Azure Functions development and configuration with Azure SignalR Service (Разработка и настройка функций Azure с помощью Службы Azure SignalR)
• Обработка сообщений от Службы SignalR (привязка триггера)
• Пример привязки триггера Службы SignalR