Skip to Content

ASP.NET Core

Middleware de correlación y de mantenimiento, endpoints de versión y entorno, comprobación de estado, sesión web, cookies, Turnstile y extensiones de petición.

El módulo dinaup.aspnet (namespace Dinaup) conecta una app ASP.NET Core con Dinaup: correlación de logs, endpoints de estado, página de mantenimiento si cae la conexión, sesión web del usuario y extensiones de petición.

Antes de empezar

  • Paquete Dinaup instalado. Ver SDK .NET.
  • Para la página de mantenimiento y la sesión web, un DinaupClientC conectado y registrado en el contenedor. Ver Cliente Dinaup.

Correlación de logs entre servicios

app.UseCorrelationId() registra CorrelationIdMiddleware. Lee la cabecera X-Correlation-Id o, si no viene, genera un id de 16 caracteres hexadecimales. Lo añade a los logs como correlation_id y lo devuelve en la cabecera de respuesta. Las constantes son CorrelationIdMiddleware.HeaderName y CorrelationIdMiddleware.PropertyName. Ver Dinaup.Logs.

Endpoints de versión y entorno

app.MapDinaupEnv() registra dos endpoints GET:

RutaRespuesta
GET /Version{ "version" }
GET /Env{ "app", "version", "env", "host", "loglvl" }

version es la de tu app, no la del SDK. Nombre y versión salen del ensamblado de entrada (GetAppName, GetAppVersion); si la detección falla (tests, IIS), fíjalo al arrancar con SetEntryAssembly(assembly).

Comprobación de estado

El SDK no registra la ruta de salud. Exponla tú y registra los clientes del SDK que implementan IHealthCheck: DinaupClientC, MyAppKVClient, DinaS3ClientC y DinaS3MultiClientC.

builder.Services.AddHealthChecks().AddCheck("Dinaup", dinaupClient);

var app = builder.Build();
app.MapHealthChecks("/HealthCheck");
app.MapDinaupEnv();

DinaupClientC.HealthCheckAsync() da el mismo veredicto como bool. Fuera del endpoint, await check.StatusAsyn() devuelve el HealthStatus de cualquier IHealthCheck, y IsHealthy(), IsDegraded() e IsUnhealthy() lo comparan.

Página de mantenimiento

app.UseMiddleware<DinaupWebMiddleware>() corta el tráfico si el cliente no está conectado o no hay DefaultSession: responde 503 Service Unavailable con una página de mantenimiento que se recarga a los 30 segundos. Con conexión, refresca la sesión web (UpdateSessionAsync) y sigue. Regístralo después de tener DinaupClientC y DinaupUserWebSession en el contenedor: los recibe por inyección en cada petición.

Sesión web del usuario

DinaupUserWebSession mantiene la sesión de un usuario de Dinaup en una app web con cookies: new DinaupUserWebSession(dinaupClient, cookie, httpContextAccessor). cookie es un ICookie (SetValue(key, value, days) y GetValue(key, def), asíncronos); la clase Cookie del módulo lo implementa. Implementa IUserSession, así que sirve como DefaultSession del cliente.

MiembroQué hace
SignInAsync(SignInModel)Inicia sesión con correo y contraseña y guarda la cookie.
SetSession(SessionSignInResponse)Fija la sesión desde una respuesta de Session_SignInAsync.
UpdateSessionAsync(useCache = true)Refresca los datos de la sesión.
CloseSession()Cierra la sesión y borra la cookie.
IsLogged, TwoFactorPending, NeedsPasswordChangeEstado de la sesión.
UserId, UserIdSTR, UserName, Email, Nombre, LicenseId, SessionDatos del usuario. Session (DinaupUserSessionDTO) nunca es nulo.
Request_UserIP, Request_UserAgent, Request_RefererDatos de la petición en curso.
Cookie(key), CookiesAccepted, ActualizarCookiesNavegador()Cookies pendientes de volcar al navegador.
SessionChanged, TriggerSessionChanged()Evento al cambiar la sesión, y cómo dispararlo a mano.
Avisos_Ok, Avisos_ErroresAvisos para mostrar en la interfaz.

Otras piezas

  • [SingleExecutionController(minIntervalSeconds: 60)]: impide ejecutar a la vez la misma acción de controlador. Responde 429 Too Many Requests si ya está en curso o no ha pasado el intervalo.
  • TurnstileValidator: valida el token de Cloudflare Turnstile de un formulario público. Fija publickey y secretKey al arrancar y llama a await TurnstileValidator.ValidateToken(token, remoteIp); ante cualquier error devuelve false y lo registra.
  • ThrowIf_InvalidDataAnnotations(obj, argName) y ThrowIf_IsTooOld(fecha, argName): guardas para modelos con anotaciones de datos y para fechas.

Extensiones de petición

ExtensiónQué devuelve
context.GetUserIP()La IP real del usuario, detrás de proxies.
context.GetUserAgent(), context.GetBrowser()User agent y nombre del navegador.
context.GetHost()El host de la petición.
context.GetUserCountry()El país que informa Cloudflare.
request.ReadGet(clave), request.ReadPost(clave), request.ReadGetOrPost(clave)Un parámetro de la cadena de consulta, del cuerpo o de cualquiera.
request.ReadGetDic(), request.ReadGetOrPostDic(), request.ReadHeadersDic()Todos los parámetros o cabeceras como Dictionary<string, string>.
navigationManager.ReadGET(clave)Un parámetro de la cadena de consulta desde Blazor.

En esta página