using System.Security.Claims; using Asp.Versioning; using InboxIntel.Api.Auth; using InboxIntel.Application; using InboxIntel.Application.Abstractions; using InboxIntel.Infrastructure; using InboxIntel.Infrastructure.Configuration; using InboxIntel.Infrastructure.Persistence; using Microsoft.AspNetCore.Authentication.Cookies; using Microsoft.AspNetCore.Authentication.Google; using Microsoft.AspNetCore.DataProtection; using Microsoft.AspNetCore.HttpOverrides; using Microsoft.EntityFrameworkCore; using Microsoft.Extensions.Options; using Serilog; var builder = WebApplication.CreateBuilder(args); // Structured logging (Serilog). Note: token values are never logged. builder.Host.UseSerilog((ctx, cfg) => cfg .ReadFrom.Configuration(ctx.Configuration) .Enrich.FromLogContext() .WriteTo.Console()); // Persist Data Protection keys so encrypted refresh tokens survive restarts. builder.Services.AddDataProtection() .PersistKeysToFileSystem(new DirectoryInfo(builder.Configuration["DataProtection:KeyPath"] ?? "/keys")) .SetApplicationName("InboxIntel"); builder.Services.AddApplication(); builder.Services.AddInfrastructure(builder.Configuration); builder.Services.AddHttpContextAccessor(); builder.Services.AddScoped(); // Authentication: cookie session established via Google OAuth2 (only login method). var google = builder.Configuration.GetSection(GoogleOAuthOptions.SectionName).Get() ?? new(); builder.Services.AddAuthentication(options => { options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme; // Challenge via the cookie scheme so unauthenticated API (XHR) calls get a // 401 instead of a redirect to Google. The SPA's axios interceptor turns // that 401 into a top-level navigation to /auth/login, which then starts // the Google flow explicitly. (A 302 to Google on an XHR is CORS-blocked.) options.DefaultChallengeScheme = CookieAuthenticationDefaults.AuthenticationScheme; }) .AddCookie(options => { options.Cookie.HttpOnly = true; options.Cookie.SameSite = SameSiteMode.Lax; // V-04: never emit the session cookie over plain HTTP in non-dev. Behind nginx // the forwarded proto (now only trusted from known proxies, see below) makes // Always work; local http://localhost dev still functions via SameAsRequest. options.Cookie.SecurePolicy = builder.Environment.IsDevelopment() ? CookieSecurePolicy.SameAsRequest : CookieSecurePolicy.Always; options.Cookie.Name = "inboxintel.session"; options.ExpireTimeSpan = TimeSpan.FromDays(7); options.SlidingExpiration = true; // API-style behaviour: return status codes rather than redirecting to a login page. options.Events.OnRedirectToLogin = ctx => { ctx.Response.StatusCode = StatusCodes.Status401Unauthorized; return Task.CompletedTask; }; options.Events.OnRedirectToAccessDenied = ctx => { ctx.Response.StatusCode = StatusCodes.Status403Forbidden; return Task.CompletedTask; }; }) .AddGoogle(options => { options.ClientId = google.ClientId; options.ClientSecret = google.ClientSecret; options.AccessType = "offline"; // request a refresh token options.SaveTokens = true; foreach (var scope in google.Scopes) options.Scope.Add(scope); options.Events.OnCreatingTicket = GoogleAuthEvents.OnCreatingTicketAsync; // Force the consent screen so Google ALWAYS returns a refresh token. // Without this, Google omits the refresh token on re-authorisation, // leaving offline Gmail sync with no usable credential. options.Events.OnRedirectToAuthorizationEndpoint = context => { context.Response.Redirect(context.RedirectUri + "&prompt=consent"); return Task.CompletedTask; }; }); builder.Services.AddAuthorization(); builder.Services.AddApiVersioning(o => { o.DefaultApiVersion = new ApiVersion(1, 0); o.AssumeDefaultVersionWhenUnspecified = true; o.ReportApiVersions = true; o.ApiVersionReader = new UrlSegmentApiVersionReader(); }).AddApiExplorer(o => { o.GroupNameFormat = "'v'VVV"; o.SubstituteApiVersionInUrl = true; }); builder.Services.AddControllers(); builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen(); // V-06: RFC7807 ProblemDetails so the global exception handler returns a safe, // generic error body instead of leaking framework stack traces / internal messages. builder.Services.AddProblemDetails(); builder.Services.AddCors(o => o.AddPolicy("frontend", p => p .WithOrigins(builder.Configuration.GetSection("Cors:Origins").Get() ?? new[] { "http://localhost:5173" }) .AllowAnyHeader().AllowAnyMethod().AllowCredentials())); var app = builder.Build(); // Apply migrations on startup so `docker-compose up` yields a ready schema. using (var scope = app.Services.CreateScope()) { var db = scope.ServiceProvider.GetRequiredService(); if (db.Database.IsRelational() && app.Configuration.GetValue("Database:AutoMigrate", true)) await db.Database.MigrateAsync(); } // Honor X-Forwarded-* from the nginx reverse proxy so OAuth redirect URIs and // cookie Secure flags reflect the external scheme/host, not the container's. // V-08: only trust these headers from KNOWN proxy networks (configurable). The // default covers private/Docker ranges so the compose nginx works, while a client // reaching the API directly can no longer spoof scheme/host/forwarded-for. var forwardedOptions = new ForwardedHeadersOptions { ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto | ForwardedHeaders.XForwardedHost, ForwardLimit = app.Configuration.GetValue("ForwardedHeaders:ForwardLimit") ?? 1 }; forwardedOptions.KnownNetworks.Clear(); forwardedOptions.KnownProxies.Clear(); var trustedNetworks = app.Configuration.GetSection("ForwardedHeaders:KnownNetworks").Get() ?? new[] { "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "127.0.0.0/8", "::1/128" }; foreach (var cidr in trustedNetworks) { var parts = cidr.Split('/'); if (parts.Length == 2 && System.Net.IPAddress.TryParse(parts[0], out var prefix) && int.TryParse(parts[1], out var len)) forwardedOptions.KnownNetworks.Add(new Microsoft.AspNetCore.HttpOverrides.IPNetwork(prefix, len)); } app.UseForwardedHeaders(forwardedOptions); if (app.Environment.IsDevelopment()) { app.UseSwagger(); app.UseSwaggerUI(); } else { // V-06: generic ProblemDetails for unhandled exceptions (no stack traces to clients). app.UseExceptionHandler(); // V-11: HSTS once TLS is enforced at the proxy (forwarded proto now trustworthy). app.UseHsts(); } // V-11: baseline security response headers. CSP is report-only for now so it can be // tuned against the SPA before enforcing (the SPA itself is also served with headers // by its nginx). Applied to API responses here as defense-in-depth. app.Use(async (ctx, next) => { var h = ctx.Response.Headers; h["X-Content-Type-Options"] = "nosniff"; h["X-Frame-Options"] = "DENY"; h["Referrer-Policy"] = "no-referrer"; h["Cross-Origin-Opener-Policy"] = "same-origin"; await next(); }); app.UseSerilogRequestLogging(); app.UseCors("frontend"); app.UseAuthentication(); app.UseAuthorization(); app.MapControllers(); app.Run(); public partial class Program { }