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
Dinaupinstalado. Ver SDK .NET. - Para la página de mantenimiento y la sesión web, un
DinaupClientCconectado 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:
| Ruta | Respuesta |
|---|---|
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.
| Miembro | Qué 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, NeedsPasswordChange | Estado de la sesión. |
UserId, UserIdSTR, UserName, Email, Nombre, LicenseId, Session | Datos del usuario. Session (DinaupUserSessionDTO) nunca es nulo. |
Request_UserIP, Request_UserAgent, Request_Referer | Datos 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_Errores | Avisos para mostrar en la interfaz. |
Otras piezas
[SingleExecutionController(minIntervalSeconds: 60)]: impide ejecutar a la vez la misma acción de controlador. Responde429 Too Many Requestssi ya está en curso o no ha pasado el intervalo.TurnstileValidator: valida el token de Cloudflare Turnstile de un formulario público. FijapublickeyysecretKeyal arrancar y llama aawait TurnstileValidator.ValidateToken(token, remoteIp); ante cualquier error devuelvefalsey lo registra.ThrowIf_InvalidDataAnnotations(obj, argName)yThrowIf_IsTooOld(fecha, argName): guardas para modelos con anotaciones de datos y para fechas.
Extensiones de petición
| Extensión | Qué 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. |