Persiltech.UserServices 0.1.0

Persiltech.UserServices

Implementación para ASP.NET Core de IUserService (el Output Port que define 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 paquete arrastra Persiltech.UserServices.Abstractions, así que no hace falta instalarlo aparte en el proyecto que registre el adaptador. La capa de dominio o de aplicación, en cambio, sí debe referenciar solo las abstracciones.

El contrato

namespace Persiltech.UserServices;

public sealed class HttpContextUserService : IUserService
{
    public HttpContextUserService(IHttpContextAccessor httpContextAccessor);

    public bool IsAuthenticated { get; }

    public string? UserName { get; }

    public string? FullName { get; }
}

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

El adaptador no guarda estado: cada propiedad se evalúa en el momento de la lectura y nunca se cachea, así que una misma instancia puede atender peticiones distintas. Quien resuelve el contexto de la petición en curso es el IHttpContextAccessor.

IsAuthenticated es false cuando no hay HttpContext —por ejemplo al resolver el servicio desde una tarea en segundo plano— y cuando lo hay pero su usuario no está autenticado. En ambos casos UserName y FullName son null: no se leen reclamaciones de un usuario no autenticado.

Resolución de las reclamaciones

UserName toma la primera con valor de estas, en orden:

FullName toma la primera opción que produzca un valor:

Un valor formado solo por espacios en blanco cuenta como ausente: se descarta y se prueba la siguiente opción. Si ninguna aporta valor, la propiedad es null.

Uso

using Persiltech.UserServices;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAuthentication();
builder.Services.AddAuthorization();
builder.Services.AddHttpContextUserService();

var app = builder.Build();

app.UseAuthentication();
app.UseAuthorization();

app.Run();

A partir de ahí, cualquier servicio pide IUserService sin saber que detrás hay un HttpContext:

using Persiltech.UserServices.Abstractions;

public sealed class CreateOrderHandler(IUserService userService)
{
    public Order Handle(CreateOrderCommand command)
    {
        if (!userService.IsAuthenticated)
        {
            throw new UnauthorizedAccessException();
        }

        return new Order
        {
            Reference = command.Reference,
            CreatedBy = userService.UserName ?? "unknown",
        };
    }
}

AddHttpContextUserService registra también el IHttpContextAccessor que el adaptador necesita, y es idempotente: llamarlo dos veces no duplica nada, y si la solución ya registró su propia implementación de IUserService, esa se respeta.

Decisiones de diseño

• El contrato IUserService no se redefine aquí: llega del paquete Persiltech.UserServices.Abstractions, consumido por NuGet. Un solo contrato para todas las soluciones.
• 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 y en una librería net10.0 duplicaría tipos que el framework compartido ya trae. Como consecuencia, la única dependencia NuGet del paquete son las abstracciones.
• El adaptador es sealed y sin estado: toda la información sale de HttpContext en el momento de la lectura.
• Registro Singleton: el adaptador no guarda estado y quien resuelve el contexto de la petición en curso es el IHttpContextAccessor, que ASP.NET Core también registra como Singleton. Una sola instancia atiende todas las peticiones sin arrastrar datos entre ellas, y así el adaptador puede inyectarse en servicios de cualquier tiempo de vida.
• Sin opciones de configuración para los nombres de las reclamaciones. El orden de resolución es fijo en esta versión; hacerlo configurable es candidato a una versión posterior, cuando haya un caso real que lo exija.

Fuera de alcance

• Escenarios sin HttpContext (consola, workers, servicios en segundo plano). Ahí IsAuthenticated es false: si hacen falta, corresponden a otro paquete.
• Autenticación y autorización: este paquete solo lee la identidad que el canal de ASP.NET Core ya haya establecido; no la establece ni la valida.
• 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 de ASP.NET Core (Microsoft.AspNetCore.App).

Estado

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

Licencia

MIT. Consulta el archivo LICENSE.