Csag.Blueprint.Realtime.AzureSignalR
0.11.0
dotnet add package Csag.Blueprint.Realtime.AzureSignalR --version 0.11.0
NuGet\Install-Package Csag.Blueprint.Realtime.AzureSignalR -Version 0.11.0
<PackageReference Include="Csag.Blueprint.Realtime.AzureSignalR" Version="0.11.0" />
<PackageVersion Include="Csag.Blueprint.Realtime.AzureSignalR" Version="0.11.0" />
<PackageReference Include="Csag.Blueprint.Realtime.AzureSignalR" />
paket add Csag.Blueprint.Realtime.AzureSignalR --version 0.11.0
#r "nuget: Csag.Blueprint.Realtime.AzureSignalR, 0.11.0"
#:package Csag.Blueprint.Realtime.AzureSignalR@0.11.0
#addin nuget:?package=Csag.Blueprint.Realtime.AzureSignalR&version=0.11.0
#tool nuget:?package=Csag.Blueprint.Realtime.AzureSignalR&version=0.11.0
Csag.Blueprint.Realtime.AzureSignalR
Overview
The Azure SignalR Service provider for the CSAG Blueprint real-time channel. It implements
IRealtimeNotifier and IRealtimeTicketIssuer from Csag.Blueprint.Application on Azure SignalR
Service in serverless mode.
The API never holds a connection. It grants a user membership of the tenant group and mints a client token when the browser asks for a ticket, and it publishes over the service's REST API while it serves the request that changed something. The browser keeps the only long-lived connection, to Azure SignalR. That is what lets the API scale to zero.
Registration
services.AddBlueprintAzureSignalRRealtime(options =>
configuration.GetSection("RealtimeSettings").Bind(options));
A host without real-time registers NoOpRealtimeService (from Csag.Blueprint.Application) for both
interfaces instead.
| Option | Default | Meaning |
|---|---|---|
ConnectionString |
none | Must carry Endpoint and AccessKey. Against the emulator, add ClientEndpoint when the API and the browser reach it under different hostnames. |
HubName |
app |
1-64 letters, digits or underscores. |
TicketTokenLifetimeMinutes |
60 |
How long a client token stays valid. Must be shorter than the membership. |
GroupMembershipTtlHours |
12 |
How long a granted tenant membership lasts, 1 to 8760. |
The options are validated at startup. The connection string goes through the SDK's own parser, so a malformed value fails the start instead of the first request.
Addressing
| Audience | Address on the service |
|---|---|
| Everyone in a tenant | group t:{tenantId:N} |
| One user in a tenant | user {tenantId:N}:{userId:N} |
The user address carries the tenant, so a person in two tenants receives a message only on the
connections opened while in that tenant. RealtimeGroupNames builds both.
Delivery
- Messages go to the client method
Notify, serialized in camelCase:{ eventName, entityId, occurredAt }. - The transient transport sends each message as its own HTTPS request, with the SDK's retries on.
- A failed publish is logged as a warning and never thrown: the change that caused it is already committed.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Csag.Blueprint.Application (>= 0.11.0)
- Microsoft.AspNetCore.Identity.EntityFrameworkCore (>= 10.0.13)
- Microsoft.Azure.SignalR.Management (>= 1.33.1)
- Microsoft.EntityFrameworkCore (>= 10.0.13)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.11.0 | 92 | 11/13/2026 |