Uniform.Messaging.AzureServiceBus 1.0.41-preview

Uniform.Messaging.AzureServiceBus

Azure Service Bus messaging provider for the Uniform microservice framework. Supports both Basic (queues only) and Standard/Premium (topics + subscriptions) pricing tiers.

Tiers

Standard / Premium (default)

Full pub/sub fanout. Each message type maps to a Topic; each service gets its own Subscription on every topic it consumes. Multiple services can receive the same message independently.

Topics and subscriptions are created automatically on startup. Topic names are sanitised from full CLR type names (e.g. + for nested types → -). Subscription names are limited to 50 characters; names over that threshold are truncated and suffixed with a 7-character hash to avoid collisions.

Basic

Queues only — no Topics or Subscriptions. Each message type maps to a Queue of the same name. Messages are delivered to exactly one consumer (competing consumers, no fanout). Use this tier when your namespace is on the Azure Service Bus Basic pricing plan, or when you only need point-to-point command routing and don't require multiple services to receive the same message.

Usage

// Standard/Premium tier (default — reads "AzureServiceBus:Tier" from config)
await Starter<MyUniform>.Create(args)
    .AddModule<AzureServiceBusModule>()
    .Start();

// Explicit tier override in code
await Starter<MyUniform>.Create(args)
    .AddModule(new AzureServiceBusModule(AzureServiceBusTier.Basic))
    .Start();

Configuration

Connection string (simple)

{
  "AzureServiceBus": {
    "ConnectionString": "Endpoint=sb://my-namespace.servicebus.windows.net/;SharedAccessKeyName=...;SharedAccessKey=..."
  }
}

Managed identity (recommended for production)

{
  "AzureServiceBus": {
    "Namespace": "my-namespace.servicebus.windows.net"
  }
}

When Namespace is set instead of ConnectionString, the provider uses DefaultAzureCredential from Azure.Identity, which resolves credentials in this order: environment variables, workload identity, managed identity, Visual Studio, Azure CLI, etc.

Full options

{
  "AzureServiceBus": {
    "ConnectionString": "...",
    "Tier": "Standard",
    "MaxConcurrentConsumers": 10,
    "RequestTimeoutSeconds": 30
  }
}

Tier accepts Basic or Standard (case-insensitive) and defaults to Standard if omitted. A tier set via the AzureServiceBusModule(AzureServiceBusTier) constructor always takes precedence over the config value.

ConnectionString and Namespace are mutually exclusive; ConnectionString takes precedence if both are set. The required roles on the namespace are Azure Service Bus Data Owner (for topology management) or at minimum Data Sender + Data Receiver with pre-created topics/subscriptions (Standard) or queues (Basic).