Persiltech.UserServices 0.1.4

Persiltech.UserServices

Implementación para ASP.NET Core de IUserService (el Output Port de Persiltech.UserServices.Abstractions), que resuelve la identidad y el estado de autenticación del usuario actual a partir de HttpContext.User.

Instalación

dotnet add package Persiltech.UserServices

El contrato

public sealed class HttpContextUserService(IHttpContextAccessor httpContextAccessor) : IUserService
{
    public bool IsAuthenticated { get; }
    public string? UserName { get; }
    public string? FullName { get; }
}

public static class DependencyInjection
{
    public static IServiceCollection AddHttpContextUserService(this IServiceCollection services);
}

El constructor lanza ArgumentNullException si el accesor es null.

Las propiedades se evalúan en cada lectura y nunca se cachean: la misma instancia puede atender peticiones distintas, y es el IHttpContextAccessor quien resuelve el contexto de la petición en curso.

IsAuthenticated es true solo si hay HttpContext activo y su User.Identity está autenticada. Cuando es false, tanto UserName como FullName son null: no se leen reclamaciones de un usuario no autenticado. Por eso ambas propiedades son anulables — el caso anónimo es legítimo, no un error.

Resolución de las reclamaciones

UserName toma la primera con valor no vacío, en este orden:

1. User.Identity.Name, es decir, la reclamación que la propia identidad declare como nombre (ClaimTypes.Name salvo que se haya remapeado, como suele ocurrir con JWT)
2. preferred_username (OpenID Connect)
3. ClaimTypes.Upn

FullName toma la primera opción que produzca un valor no vacío, en este orden:

1. La reclamación name (OpenID Connect)
2. La unión de ClaimTypes.GivenName y ClaimTypes.Surname, separadas por un espacio, omitiendo la que falte

Un valor formado solo por espacios en blanco cuenta como ausente y se descarta.

Uso

using Persiltech.UserServices;
using Persiltech.UserServices.Abstractions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddHttpContextUserService();

var app = builder.Build();

app.MapGet("/whoami", (IUserService userService) => new
{
    userService.IsAuthenticated,
    userService.UserName,
    userService.FullName
});

app.Run();

AddHttpContextUserService registra IHttpContextAccessor y IUserService → HttpContextUserService con tiempo de vida Singleton, y devuelve la misma colección para encadenar. El registro es idempotente: llamarlo dos veces no duplica los servicios, y si la aplicación ya tenía una implementación de IUserService registrada, la conserva.

El paquete no establece ni valida la autenticación: solo lee la identidad que el canal de ASP.NET Core ya haya establecido, así que la aplicación consumidora sigue siendo la responsable de su UseAuthentication() y su esquema.

Decisiones de diseño

• El contrato IUserService no se redefine aquí: llega del paquete Persiltech.UserServices.Abstractions publicado en nuget.org, referenciado por NuGet.
• La dependencia de ASP.NET Core se declara con <FrameworkReference Include="Microsoft.AspNetCore.App" />, no con un <PackageReference> a Microsoft.AspNetCore.Http.Abstractions. Ese paquete es la vía de ASP.NET Core 2.x sobre netstandard2.0: en una librería net10.0 duplicaría tipos que ya trae el framework compartido. La referencia al framework también aporta Microsoft.Extensions.DependencyInjection.Abstractions, así que el paquete no declara ninguna dependencia NuGet más allá de las abstracciones.
• El adaptador es sealed y sin estado: toda la información sale de HttpContext en el momento de la lectura.
• Registro Singleton: es el tiempo de vida que corresponde a una identidad ligada a la petición, y evita que un consumidor conserve por accidente valores de una petición en otra.
• Sin opciones de configuración para los nombres de las reclamaciones. El orden de resolución es fijo en esta versión.

Fuera de alcance

• Adaptadores para escenarios sin HttpContext (consola, workers, servicios en segundo plano).
• Autenticación y autorización.
• Reclamaciones distintas de las tres propiedades del contrato (roles, permisos, identificadores de inquilino): ampliar el contrato es trabajo del paquete de abstracciones.

Compatibilidad

net10.0, con el framework compartido Microsoft.AspNetCore.App.

Estado

Versión 0.x: la superficie pública puede cambiar entre versiones menores.

Historial de versiones

La superficie pública no ha cambiado desde 0.1.0: todo lo publicado hasta ahora corrige empaquetado y documentación, nunca el contrato. Actualizar es siempre seguro.

Soporte

El código fuente de este paquete no es público. Para dudas, informes de error o peticiones de mejora, usa la página del paquete.

Apoya el desarrollo

Si el paquete te ahorra trabajo, puedes apoyar su mantenimiento en GitHub Sponsors.