👁 Image
Indice.Services 8.49.1

Indice.Services

A comprehensive library of infrastructure service abstractions and implementations for .NET applications. This package provides production-ready integrations with Azure services and popular third-party providers for common application needs.

👁 NuGet

Installation

dotnet add package Indice.Services

Features

📁 File Storage

Store and retrieve files using different backing stores:

// Azure Blob Storage
services.AddFilesAzure(options => {
 options.ConnectionStringName = "StorageConnection";
 options.ContainerName = "my-container";
});

// Local file system
services.AddFilesLocal(options => {
 options.Path = "uploads";
});

🔧 Configuration (Azure Storage)

AzureClientFactory resolves the connection by ConnectionStringName (StorageConnection by default):

• First from ConnectionStrings:{ConnectionStringName} (or a direct value with the same key)
• Otherwise from managed-identity settings under {ConnectionStringName}

Standard connection string:

{
 "ConnectionStrings": {
 "StorageConnection": "DefaultEndpointsProtocol=https;AccountName=<NAME>;AccountKey=xxx;EndpointSuffix=core.windows.net"
 }
}

Managed Identity (system-assigned):

{
 "StorageConnection": {
 "accountName": "<NAME>",
 "serviceUri": "<SERVICE_URI>"
 }
}

Managed Identity (user-assigned):

{
 "StorageConnection": {
 "accountName": "<NAME>",
 "serviceUri": "<SERVICE_URI>",
 "clientId": "<CLIENT_ID>"
 }
}

For Azure Functions host, you need to provide these extra values too:

AzureWebJobsStorage__accountName = <NAME>
AzureWebJobsStorage__serviceUri = <BASE_SERVICE_URL>

For user-assigned Managed Identity, add this too:

AzureWebJobsStorage__clientId = <CLIENT_ID>

Proper RBAC roles to be assigned to the Managed Identity:

• Storage Account Contributor
• Storage Blob Data Owner
• Storage Queue Data Contributor
• Storage Queue Data Message Processor
• Storage Queue Data Message Sender
• Storage Queue Data Reader

📧 Email Services

Send emails through various providers with template rendering support:

// Auto-discover provider from configuration
services.AddEmailService(configuration);

Configuration (appsettings.json):

{
 "Email": {
 "Provider": "smtp",
 "Sender": "noreply@example.com",
 "SenderName": "My App",
 "SmtpHost": "smtp.example.com",
 "SmtpPort": 587
 }
}

📱 SMS Services

Send SMS messages through multiple gateway providers:

services.AddSmsServiceApifon(configuration);

🔔 Push Notifications

Send push notifications via Azure Notification Hubs:

services.AddPushNotificationServiceAzure((sp, options) => {
 options.ConnectionString = "your-connection-string";
 options.NotificationHubPath = "your-hub-name";
});

📤 Event Dispatching

Dispatch events asynchronously using queue-based messaging:

services.AddEventDispatcherAzure(configuration);

// Raise events
await eventDispatcher.RaiseEventAsync(new OrderCreatedEvent { OrderId = orderId });

🔒 Distributed Locking

Coordinate distributed operations using lease-based locking:

services.AddLockManagerAzure(configuration);

// Acquire and use a lock
await using var lease = await lockManager.AcquireLock("my-resource", TimeSpan.FromSeconds(30));
if (lease.IsAcquired) {
 // Perform exclusive operation
}

📡 SignalR Proxy

Proxy SignalR connections through Azure SignalR Service:

services.AddSignalRProxyServices(configuration);

Configuration

Most services auto-configure from IConfiguration. Common connection string names:

Dependencies

• Azure.Storage.Blobs - Blob storage operations
• Azure.Storage.Queues - Queue storage operations
• Azure.Messaging.ServiceBus - Service Bus messaging
• MailKit - SMTP email sending
• Microsoft.Azure.NotificationHubs - Push notifications
• Microsoft.Azure.SignalR.Management - SignalR proxy

Target Frameworks

• .NET 8.0
• .NET 9.0

License

This project is licensed under the MIT License. See the LICENSE file for details.

Links

• GitHub Repository
• NuGet Package