Felsőbb rétegbeli végpontok

A felsőbb rétegbeli végpontok funkció lehetővé teszi, hogy az Azure SignalR Service kiszolgáló nélküli módban küldjön üzeneteket és kapcsolati eseményeket egy végpontkészletbe. A felsőbb rétegbeli végpontokkal kiszolgáló nélküli módban hívhat meg egy központi metódust az ügyfelektől, hogy értesítse a végpontokat, ha az ügyfélkapcsolatok csatlakoznak vagy megszakadnak.

Felsőbb rétegbeli végpont beállításai

A felsőbb rétegbeli végpont beállításai a sorrendre érzékeny elemek listáját tartalmazzák:

• EGY URL-sablon, amely meghatározza, hogy hová küldenek üzeneteket.
• Egy szabálykészlet.
• Hitelesítési konfigurációk.

Egy esemény aktiválásakor a rendszer egyenként ellenőrzi az elemek szabályait. A rendszer üzeneteket küld az első egyező elem felső végpontjának URL-címére.

URL-sablon beállításai

A különböző minták támogatásához paraméterezheti a felső végpont URL-címét. Három előre definiált paraméter létezik:

Ezek az előre definiált paraméterek használhatók az URL-mintában. A paramétereket a rendszer egy megadott értékre cseréli a felső végpont URL-címének kiértékelésekor. Példa:

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

Ha a "csevegőközpont" ügyfélkapcsolata csatlakozik, a rendszer a következő URL-címre küld üzenetet:

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

Amikor a "csevegőközpont" egyik ügyfele meghívja a hub metódust broadcast, a rendszer üzenetet küld erre az URL-címre:

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

Key Vault titkos kulcshivatkozás az URL-sablon beállításaiban

A felső végpont URL-címe nincs titkosítva. Bizalmas, felsőbb rétegbeli végpontokat biztonságossá tehet a Key Vault használatával, és felügyelt identitással érheti el őket.

Felügyelt identitás engedélyezése a SignalR szolgáltatáspéldányban, és Key Vault-hozzáférés biztosítása:

1. Adjon hozzá egy rendszer által hozzárendelt vagy felhasználó által hozzárendelt identitást. Lásd : Felügyelt identitás hozzáadása az Azure Portalon.

2. Titkos olvasási engedélyt adhat a felügyelt identitáshoz a Key Vault hozzáférési szabályzataiban. Lásd: Key Vault hozzáférési szabályzat hozzárendelése az Azure Portal használatával

3. Cserélje le a bizalmas szöveget az alábbi szintaxisra a felső végpont URL-mintázatában:

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

   <secret-identity>a Key Vault titkos kulcsainak teljes adatsík URI-ja, opcionálisan egy verziót is beleértve, például https://myvault.vault.azure.net/secrets/mysecret/https://myvault.vault.azure.net/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931

   Egy teljes hivatkozás például a következőhöz hasonlóan nézne ki:

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

   Az Azure-függvényhez tartozó felső végpont URL-címe a következőhöz hasonlóan nézne ki:

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

Szabálybeállítások

A központi szabályokat, a kategóriaszabályokat és az eseményszabályokat külön állíthatja be. Az egyező szabály három formátumot támogat:

• Bármely eseményhez használjon csillagot (*).
• Több esemény összekapcsolásához használjon vesszőt (,). Például connected, disconnected egyezik a csatlakoztatott és a leválasztott eseményekkel.
• Használja a teljes eseménynevet az eseményhez való igazodáshoz. Például connected egyezik a csatlakoztatott eseményével.

Hitelesítési beállítások

A hitelesítést minden felsőbb rétegbeli végponthoz külön konfigurálhatja. A hitelesítés konfigurálásakor egy jogkivonat van beállítva a Authentication felsőbb rétegbeli üzenet fejlécében. Az Azure SignalR Szolgáltatás jelenleg a következő hitelesítési típusokat támogatja:

• None
• ManagedIdentity

Ha ezt választja ManagedIdentity, először engedélyeznie kell egy felügyelt identitást az Azure SignalR Szolgáltatásban, és opcionálisan meg kell adnia egy erőforrást. A részleteket az Azure SignalR Service felügyelt identitásai között találja.

Felsőbb rétegbeli végpontbeállítások konfigurálása az Azure Portalon

1. Nyissa meg az Azure SignalR Szolgáltatást.
2. Válassza a Beállítások lehetőséget.
3. Szolgáltatás mód váltása kiszolgáló nélkülire.
4. URL-címek hozzáadása a felsőbb rétegbeli URL-minta alatt.
5. Válassza a Központi szabályok lehetőséget a felsőbb réteg beállításainak megnyitásához.
6. Módosítsa a központi szabályokat, az eseményszabályokat és a kategóriaszabályokat úgy, hogy megadja a szabály értékét a megfelelő mezőben.
7. Az Upstream Authentication (Felsőbb rétegbeli hitelesítés) területen válassza a
8. Felügyelt identitás használata. (Győződjön meg arról, hogy engedélyezte a felügyelt identitást)
9. A kibocsátott jogkivonat Célközönség területén válasszon lehetőségeket. A részleteket az Azure SignalR Service felügyelt identitásai között találja.

Felsőbb rétegbeli végpontbeállítások konfigurálása Resource Manager-sablonnal

A felsőbb rétegbeli végpontbeállítások Azure Resource Manager-sablonnal való konfigurálásához állítsa be a upstream tulajdonság tulajdonságátproperties. Az alábbi kódrészlet bemutatja, hogyan állíthatja be a tulajdonságot a upstream felsőbb rétegbeli végpontbeállítások létrehozásához és frissítéséhez.

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

Kiszolgáló nélküli protokollok

Az Azure SignalR Service az alábbi protokollokat követő végpontoknak küld üzeneteket. A SignalR Service eseményindító kötését a Függvényalkalmazással használhatja, amely kezeli ezeket a protokollokat.

Metódus

POST

Kérelem fejléce

Kérés törzse

Csatlakoztatva

Tartalomtípus: application/json

Leválasztva

Tartalomtípus: application/json

Meghívási üzenet

Tartalomtípus: application/json vagy application/x-msgpack

Aláírás

A szolgáltatás az érték SHA256-kódját X-ASRS-Connection-Id az elsődleges hozzáférési kulcs és a másodlagos hozzáférési kulcs kulcsként HMAC való használatával számítja ki. A szolgáltatás a fejlécben fogja beállítani, X-ASRS-Signature amikor HTTP-kéréseket küld egy felsőbb rétegbeli végpontra:

Hex_encoded(HMAC_SHA256(accessKey, connection-id))

Következő lépések

• Felügyelt identitások az Azure SignalR Service-hez
• Az Azure Functions fejlesztése és konfigurálása az Azure SignalR szolgáltatással
• A SignalR szolgáltatásból érkező üzenetek kezelése (triggerkötés)
• SignalR service trigger kötési minta