ProMilesV5.SharedOps 1.2.3

ProMilesV5.SharedOps

Shared .NET 8.0 class library for ProMiles projects.

Features

• Company Services: Shared company validation and fuel tax ID operations
• Claims Processing: Authentication claims parsing for application access and feature management
• Common Operations: Utilities and shared functionality across ProMiles applications
• Configurable: Via appsettings.json (and environment-specific variants)
• Docker Ready: Optimized for containerized workflows

Getting Started

Build

dotnet build

Usage

Reference this library in your .NET projects:

<ItemGroup>
  <PackageReference Include="ProMilesV5.SharedOps" Version="1.2.3" />
</ItemGroup>

Dependency Injection Setup

using ProMilesV5.SharedOps.Extensions;

// In your Program.cs or Startup.cs
builder.Services.AddSharedOpsServices(new Uri("https://your-api-base-url.com"));

Claims Processing

The library provides comprehensive claims processing functionality for client applications to parse authentication claims and extract application access and feature information.

Key Components

• AuthClaimsUtility: Static utility class for parsing claims
• IClaimsService: Service interface for dependency injection
• ClaimsService: Service implementation
• IdentityInformation: Convenience container for parsed claims data

Models

• FeatureAccessDto: Represents feature access claims
• FeatureValueDto: Represents feature value claims
• ResolvedFeature: Represents resolved features with precedence
• IdentityInformation: Complete parsed claims container

Usage Examples

Basic Claims Processing

using ProMilesV5.SharedOps.Services;
using ProMilesV5.SharedOps.Utilities;

// Using the service (recommended for DI)
var claimsService = serviceProvider.GetRequiredService<IClaimsService>();
var identityInfo = claimsService.CreateIdentityInformation(user, companyId);

// Using the utility directly
var apps = AuthClaimsUtility.GetApps(user);
var features = AuthClaimsUtility.GetRelevantFeatureValuesForCompany(user, companyId);

Working with IdentityInformation

var identityInfo = claimsService.CreateIdentityInformation(user, companyId);

// Access application list
foreach (var app in identityInfo.ApplicationAccess)
{
    Console.WriteLine($"User has access to: {app}");
}

// Check specific features
if (identityInfo.HasFeature("AdvancedReporting", "Enabled"))
{
    // Enable advanced reporting features
}

// Access all resolved features
foreach (var feature in identityInfo.FeaturesForCompany)
{
    Console.WriteLine($"Feature: {feature.Role}, Value: {feature.Value}");
}

Claims Structure

The library expects claims in the following format:

Role Claims

• Type: ClaimTypes.Role
• Value: Application name (e.g., "App1", "App2")

Feature Access Claims

• Type: "FeatureAccess"
• Value: JSON object with role, assigned, and companyId properties

Feature Value Claims

• Type: "FeatureValue"
• Value: JSON object with role, value, companyId, and scope properties

Assignment Precedence

Features are resolved with the following precedence order:

1. User - User-specific assignments
2. Company - Company-specific assignments (exact company ID match)
3. All Users - Global user assignments
4. App - Application-level assignments

Configuration

• Place your settings in appsettings.json, appsettings.Development.json, or appsettings.Beta.json as needed.
• Files are copied to output automatically.

Docker

Build the Docker image:

docker build -t promilesv5-sharedops .

Development

• Target Framework: .NET 8.0
• Nullable enabled, implicit usings enabled

Authors

ProMiles

License

[Specify your license here]