Partager via

Intégrer Azure SignalR Service avec Service Connector

Cet article présente les méthodes et clients d’authentification pris en charge, ainsi qu’un exemple de code que vous pouvez utiliser pour connecter Azure SignalR Service à d’autres services cloud à l’aide du connecteur de services. Cet article montre également le nom et la valeur de la variable d’environnement par défaut (ou configuration Spring Boot) que vous obtenez quand vous créez la connexion de service.

Service de calcul pris en charge

Vous pouvez utiliser le connecteur de services pour connecter les services de calcul suivants à Azure SignalR Service :

  • Azure App Service
  • Azure Container Apps
  • Azure Functions
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Types d’authentification et de clients pris en charge

Le tableau ci-dessous montre quelles combinaisons de méthodes et de clients d’authentification sont prises en charge pour connecter votre service de calcul à Azure SignalR Service à l’aide du connecteur de services. « Oui » indique que la combinaison est prise en charge, tandis que « Non » indique qu’elle n’est pas prise en charge.

Type de client Identité managée affectée par le système Identité managée affectée par l’utilisateur Secret / chaîne de connexion Principal du service
.NET Oui Oui Oui Oui
Aucun Oui Oui Oui Oui

Ce tableau indique que toutes les combinaisons de types client et de méthodes d’authentification dans la table sont prises en charge. Les autres types de clients ne sont pas autorisés à se connecter à Azure SignalR Service à l’aide du connecteur de services.

Noms des variables d’environnement par défaut ou propriétés de l’application

Utilisez les noms de variable d’environnement listés ci-dessous pour connecter les services de calcul à Azure SignalR Service. Pour chaque exemple ci-dessous, remplacez les textes des espaces réservés <SignalR-name>, <access-key>, <client-ID>, <tenant-ID> et <client-secret> par vos propres nom, clé d’accès, ID client, ID locataire et clé secrète client SignalR. Pour plus d’informations sur les conventions d’affectation de noms, consultez l’article Services internes du connecteur de services.

Identité managée affectée par le système

Nom de variable d’environnement par défaut Description Valeur d'exemple
AZURE_SIGNALR_CONNECTIONSTRING Chaîne de connexion SignalR Service avec une identité gérée Endpoint=https://<SignalR-name>.service.signalr.net;AuthType=aad;<client-ID>;Version=1.0;

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure SignalR Service à l’aide d’une identité managée affectée par le système.

  1. Installez des dépendances.

    dotnet add package Microsoft.Azure.SignalR

  2. Obtenez la chaîne de connexion à partir des variables d’environnement ajoutées par le connecteur de services.

    var builder = WebApplication.CreateBuilder(args);

var connectionString = Environment.GetEnvironmentVariable("AZURE_SIGNALR_CONNECTIONSTRING");
builder.Services.AddSignalR().AddAzureSignalR(connectionString);

var app = builder.Build();

Identité managée affectée par l’utilisateur

Nom de variable d’environnement par défaut Description Valeur d'exemple
AZURE_SIGNALR_CONNECTIONSTRING Chaîne de connexion SignalR Service avec une identité gérée Endpoint=https://<SignalR-name>.service.signalr.net;AuthType=aad;client-id=<client-id>;Version=1.0;

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure SignalR Service à l’aide d’une identité managée affectée par l’utilisateur.

  1. Installez des dépendances.

    dotnet add package Microsoft.Azure.SignalR

  2. Obtenez la chaîne de connexion à partir des variables d’environnement ajoutées par le connecteur de services.

    var builder = WebApplication.CreateBuilder(args);

var connectionString = Environment.GetEnvironmentVariable("AZURE_SIGNALR_CONNECTIONSTRING");
builder.Services.AddSignalR().AddAzureSignalR(connectionString);

var app = builder.Build();

Connection string

Avertissement

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d'authentification décrit dans cette procédure demande un degré de confiance très élevé dans l'application et comporte des risques qui ne sont pas présents dans d'autres flux. Vous ne devez utiliser ce flux que si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Nom de variable d’environnement par défaut Description Valeur d'exemple
AZURE_SIGNALR_CONNECTIONSTRING Chaîne de connexion SignalR Service Endpoint=https://<SignalR-name>.service.signalr.net;AccessKey=<access-key>;Version=1.0;

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure SignalR Service à l’aide d’une chaîne de connexion.

  1. Installez des dépendances.

    dotnet add package Microsoft.Azure.SignalR

  2. Obtenez la chaîne de connexion à partir des variables d’environnement ajoutées par le connecteur de services.

    var builder = WebApplication.CreateBuilder(args);

var connectionString = Environment.GetEnvironmentVariable("AZURE_SIGNALR_CONNECTIONSTRING");
builder.Services.AddSignalR().AddAzureSignalR(connectionString);

var app = builder.Build();

Principal du service

Nom de variable d’environnement par défaut Description Valeur d'exemple
AZURE_SIGNALR_CONNECTIONSTRING Chaîne de connexion SignalR Service avec un principal de service Endpoint=https://<SignalR-name>.service.signalr.net;AuthType=aad;ClientId=<client-ID>;ClientSecret=<client-secret>;TenantId=<tenant-ID>;Version=1.0;

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure SignalR Service à l’aide d’un principal de service.

  1. Installez des dépendances.

    dotnet add package Microsoft.Azure.SignalR

  2. Obtenez la chaîne de connexion à partir des variables d’environnement ajoutées par le connecteur de services.

    var builder = WebApplication.CreateBuilder(args);

var connectionString = Environment.GetEnvironmentVariable("AZURE_SIGNALR_CONNECTIONSTRING");
builder.Services.AddSignalR().AddAzureSignalR(connectionString);

var app = builder.Build();

Étapes suivantes

En savoir plus sur les concepts Service Connector