Nadrzędne punkty końcowe

Funkcja nadrzędnych punktów końcowych umożliwia usłudze Azure SignalR Service wysyłanie komunikatów i zdarzeń połączenia do zestawu punktów końcowych w trybie bezserwerowym. Za pomocą nadrzędnych punktów końcowych można wywołać metodę centrum od klientów w trybie bezserwerowym w celu powiadamiania punktów końcowych, gdy połączenia klienta są połączone lub rozłączone.

Ustawienia nadrzędnego punktu końcowego

Ustawienia nadrzędnego punktu końcowego składają się z listy elementów wrażliwych na kolejność:

• Szablon adresu URL określający miejsce wysyłania komunikatów.
• Zestaw reguł.
• Konfiguracje uwierzytelniania.

Po wyzwoleniu zdarzenia reguły elementu są sprawdzane według jednej kolejności. Komunikaty zostaną wysłane do pierwszego adresu URL nadrzędnego punktu końcowego pasującego elementu.

Ustawienia szablonu adresu URL

Aby obsługiwać różne wzorce, można sparametryzować nadrzędny adres URL punktu końcowego. Istnieją trzy wstępnie zdefiniowane parametry:

Te wstępnie zdefiniowane parametry mogą być używane we wzorcu adresu URL. Parametry zostaną zastąpione określoną wartością podczas oceniania nadrzędnego adresu URL punktu końcowego. Na przykład:

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

Po nawiązaniu połączenia klienta w centrum "czat" zostanie wysłana wiadomość do tego adresu URL:

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

Gdy klient w centrum "czat" wywołuje metodę broadcastcentrum, do tego adresu URL zostanie wysłana wiadomość:

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

Dokumentacja wpisu tajnego usługi Key Vault w ustawieniach szablonu adresu URL

Nadrzędny adres URL punktu końcowego nie jest szyfrowany. Poufne punkty końcowe można zabezpieczyć przy użyciu usługi Key Vault i uzyskać do nich dostęp za pomocą tożsamości zarządzanej.

Aby włączyć tożsamość zarządzaną w wystąpieniu usługi SignalR i przyznać mu dostęp do usługi Key Vault:

1. Dodaj tożsamość przypisaną przez system lub tożsamość przypisaną przez użytkownika. Zobacz Jak dodać tożsamość zarządzaną w witrynie Azure Portal.

2. Przyznaj uprawnienie do odczytu wpisu tajnego dla tożsamości zarządzanej w zasadach dostępu w usłudze Key Vault. Zobacz Przypisywanie zasad dostępu usługi Key Vault przy użyciu witryny Azure Portal

3. Zastąp tekst poufny poniższą składnią w nadrzędnym wzorcu adresu URL punktu końcowego:

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

   <secret-identity> to pełny identyfikator URI płaszczyzny danych wpisu tajnego w usłudze Key Vault, opcjonalnie zawierający wersję, np. https://myvault.vault.azure.net/secrets/mysecret/ lub https://myvault.vault.azure.net/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931

   Na przykład kompletna dokumentacja wygląda następująco:

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

   Nadrzędny adres URL punktu końcowego do funkcji platformy Azure wygląda następująco:

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

Ustawienia reguły

Reguły centrum, reguły kategorii i reguły zdarzeń można ustawić oddzielnie. Reguła dopasowania obsługuje trzy formaty:

• Użyj gwiazdki (*), aby dopasować dowolne zdarzenie.
• Użyj przecinka (,), aby dołączyć do wielu zdarzeń. Na przykład pasuje connected, disconnected do zdarzeń połączonych i rozłączonych.
• Użyj pełnej nazwy zdarzenia, aby dopasować je do zdarzenia. Na przykład pasuje connected do połączonego zdarzenia.

Ustawienia uwierzytelniania

Uwierzytelnianie dla każdego nadrzędnego punktu końcowego można skonfigurować osobno. Podczas konfigurowania uwierzytelniania token jest ustawiany w Authentication nagłówku komunikatu nadrzędnego. Obecnie usługa Azure SignalR Service obsługuje następujące typy uwierzytelniania:

• None
• ManagedIdentity

Po wybraniu opcji ManagedIdentitynależy najpierw włączyć tożsamość zarządzaną w usłudze Azure SignalR Service i opcjonalnie określić zasób. Aby uzyskać szczegółowe informacje, zobacz Tożsamości zarządzane dla usługi Azure SignalR Service .

Konfigurowanie ustawień nadrzędnego punktu końcowego za pośrednictwem witryny Azure Portal

1. Przejdź do usługi Azure SignalR Service.
2. Wybierz Ustawienia.
3. Przełącz tryb usługi na bezserwerowy.
4. Dodaj adresy URL w obszarze Wzorzec nadrzędnego adresu URL.
5. Wybierz pozycję Reguły centrum, aby otworzyć ustawienia nadrzędne.
6. Zmień reguły centrum, reguły zdarzeń i reguły kategorii, wprowadzając wartość reguły w odpowiednim polu.
7. W obszarze Uwierzytelnianie nadrzędne wybierz pozycję
8. Użyj tożsamości zarządzanej. (Upewnij się, że włączono tożsamość zarządzaną)
9. Wybierz dowolne opcje w obszarze Odbiorcy w wystawionym tokenie. Aby uzyskać szczegółowe informacje, zobacz Tożsamości zarządzane dla usługi Azure SignalR Service .

Konfigurowanie ustawień nadrzędnych punktów końcowych za pomocą szablonu usługi Resource Manager

Aby skonfigurować nadrzędne ustawienia punktu końcowego przy użyciu szablonu usługi Azure Resource Manager, ustaw upstream właściwość we properties właściwości . Poniższy fragment kodu przedstawia sposób ustawiania upstream właściwości tworzenia i aktualizowania nadrzędnych ustawień punktu końcowego.

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

Protokoły bezserwerowe

Usługa Azure SignalR Service wysyła komunikaty do punktów końcowych, które są zgodne z następującymi protokołami. Możesz użyć powiązania wyzwalacza usługi SignalR Service z aplikacją funkcji, która obsługuje te protokoły.

Metoda

Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST".

Nagłówek żądania

Treść żądania

Połączono

Typ zawartości: application/json

Odłączony

Typ zawartości: application/json

Komunikat wywołania

Typ zawartości: application/json lub application/x-msgpack

Podpis

Usługa obliczy kod SHA256 dla X-ASRS-Connection-Id wartości przy użyciu zarówno podstawowego klucza dostępu, jak i pomocniczego HMAC klucza dostępu jako klucza. Usługa ustawi ją w nagłówku X-ASRS-Signature podczas wysyłania żądań HTTP do nadrzędnego punktu końcowego:

Hex_encoded(HMAC_SHA256(accessKey, connection-id))

Następne kroki

• Tożsamości zarządzane dla usługi Azure SignalR Service
• Programowanie i konfigurowanie w usłudze Azure Functions za pomocą usługi Azure SignalR Service
• Obsługa komunikatów z usługi SignalR Service (powiązanie wyzwalacza)
• Przykład powiązania wyzwalacza usługi SignalR Service