Franz.Common.Identity 2.3.2

Franz.Common.Identity

HTTP, identity, and service integration for the Franz.Common framework on .NET 10.

Overview

The Franz.Common.Identity package provides HTTP, identity, and service integration within Franz.Common. It is designed to compose with the rest of the framework rather than imposing unrelated infrastructure choices on every application.

Installation

dotnet add package Franz.Common.Identity

Design principles

• Explicit composition: register only the capabilities the application needs.
• Clear boundaries: keep domain and application contracts independent from provider-specific infrastructure where the package's role permits it.
• Predictable behavior: make configuration, failure modes, and lifecycle ownership visible rather than relying on hidden conventions.
• Operational readiness: validate security, resilience, diagnostics, and compatibility for the actual deployment environment.

Usage and configuration

Follow the package-specific setup, configuration, and code examples below. Only configure external services when this package requires them, and keep secrets outside source control.

Package-specific guide

A foundational library within the Franz Framework that provides contracts and utilities for managing identity context across applications. This package defines the core abstractions for accessing user identity information in a consistent, provider-agnostic way.

-Current Version: v2.3.2

• Part of the private Franz Framework ecosystem.

Features

• Identity Context Management

  • FranzIdentityContext: unified model (UserId, Email, FullName, Roles, TenantId, DomainId).
  • IIdentityContextAccessor: contract for resolving identity across frameworks.

• Testing Support

  • FakeIdentityContextAccessor: simple stub for unit/integration tests.

• Framework-Agnostic

  • No dependency on ASP.NET Core or HttpContext.
  • ASP.NET-specific implementation lives in Franz.Common.Http.Identity.

Installation

dotnet add package Franz.Common.Identity

Usage

Access Identity Context

using Franz.Common.Identity;

public class MyService
{
    private readonly IIdentityContextAccessor _identityContext;

    public MyService(IIdentityContextAccessor identityContext)
    {
        _identityContext = identityContext;
    }

    public FranzIdentityContext GetIdentity()
        => _identityContext.GetCurrentIdentity();
}

Integration with Franz Framework

The Franz.Common.Identity package integrates seamlessly with:

• Franz.Common.Http.Identity: ASP.NET Core implementation + SSO providers.
• Franz.Common.Headers: standardized HTTP header propagation.

Contributing

This package is part of a private framework. Contributions are limited to the internal development team.

1. Clone the repository @ Franz.Common
2. Create a feature branch.
3. Submit a pull request for review.

License

Licensed under the MIT License. See the LICENSE file for details.

Changelog

Version 1.6.2

• Introduced FranzIdentityContext (UserId, Email, FullName, Roles, TenantId, DomainId).

• Added IIdentityContextAccessor interface for framework-agnostic identity access.

• Added FakeIdentityContextAccessor for testing.

• Moved ASP.NET Core specifics into a new package: Franz.Common.Http.Identity, including:

  • IdentityContextAccessor (HttpContext-based implementation).

  • AddFranzHttpIdentity() DI extension.

  • Provider extensions:

    • AddFranzWsFedIdentity() (WS-Federation).
    • AddFranzOidcIdentity() (OpenID Connect).
    • AddFranzSaml2Identity() (SAML2 via Sustainsys).
    • AddFranzKeycloakIdentity() (Keycloak OIDC with role normalization).

• All providers normalize into FranzIdentityContext.

• Config-driven setup via appsettings.json (no hardcoded values).

Version 1.3

• Upgraded to .NET 9.0.8.
• Added new features and improvements.
• Separated business concepts from mediator concepts.
• Now compatible with both in-house mediator and MediatR.

Version 1.2.65

• Upgraded to .NET 9.

Version 1.6.20

• Updated to .NET 10.0

v2.0.1 – Internal Modernization

• Messaging and infrastructure refactored for async, thread-safety, and modern .NET 10 patterns.
• All APIs remain fully backward compatible.
• Tests, listeners, and pipeline components modernized.

Dependency maintenance — October 2026

This project's dependency references were reviewed and updated as part of the repository-wide .NET 10 maintenance pass. The intended target framework and public API remain unchanged. Verify the resolved direct and transitive dependency graph through the repository's dependency validation workflow before publishing. See the central dependency upgrade record.