SPMS_API/SPMS.API/Extensions/ApplicationBuilderExtensions.cs
SEAN df8a8e2e5b feat: X-Service-Code / X-API-KEY 서비스 식별 미들웨어 구현 (#32)
- ServiceRepository: IServiceRepository 구현 (GetByServiceCode, GetByApiKey)
- ServiceCodeMiddleware: X-Service-Code 헤더 검증, DB 조회, 서비스 상태 확인
- ApiKeyMiddleware: /v1/in/device/* 경로 X-API-KEY 검증
- ApplicationBuilderExtensions: 미들웨어 파이프라인 12~13번 등록
- DependencyInjection: IServiceRepository DI 등록

Closes #32
2026-02-09 17:25:19 +09:00

94 lines
3.3 KiB
C#

using Serilog;
using SPMS.API.Middlewares;
namespace SPMS.API.Extensions;
public static class ApplicationBuilderExtensions
{
public static WebApplication UseMiddlewarePipeline(this WebApplication app)
{
// -- 1. 예외 처리 (최외곽 — 이후 모든 미들웨어 예외 포착) --
app.UseMiddleware<ExceptionMiddleware>();
// -- 2. 보안 헤더 주입 (미구현) --
// app.UseMiddleware<SecurityHeadersMiddleware>();
// -- 3. X-Request-ID 발급/반환 (클라이언트 디버깅용) --
app.UseMiddleware<RequestIdMiddleware>();
// -- 4. Serilog 구조적 로깅 (X-Request-ID 이후에 위치) --
app.UseSerilogRequestLogging(options =>
{
options.EnrichDiagnosticContext = (diagnosticContext, httpContext) =>
{
if (httpContext.Items.TryGetValue("RequestId", out var requestId))
{
diagnosticContext.Set("RequestId", requestId);
}
};
});
// -- 5. HTTPS 리다이렉션 (Nginx가 HTTPS 처리하므로 Production에서만) --
if (!app.Environment.IsDevelopment())
{
app.UseHttpsRedirection();
}
// -- 6. 정적 파일 서빙 --
var webRoot = app.Environment.WebRootPath;
if (Directory.Exists(webRoot))
{
app.UseStaticFiles();
}
// -- 7. 라우팅 --
app.UseRouting();
// -- 8. CORS (미구현) --
// app.UseCors("DefaultPolicy");
// -- 9. API 속도 제한 (IP별 분당 100회) --
app.UseRateLimiter();
// -- 10. JWT 인증 --
app.UseAuthentication();
// -- 11. 역할 인가 --
app.UseAuthorization();
// -- 12. X-Service-Code 서비스 식별 --
app.UseMiddleware<ServiceCodeMiddleware>();
// -- 13. X-API-KEY 검증 (SDK/디바이스 엔드포인트용) --
app.UseMiddleware<ApiKeyMiddleware>();
// -- 14. X-SPMS-TEST 샌드박스 모드 (미구현 — Issue #14) --
// app.UseMiddleware<SandboxMiddleware>();
// -- 15. Swagger UI (개발 환경만) --
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI(options =>
{
options.SwaggerEndpoint("/swagger/all/swagger.json", "SPMS API - 전체");
options.SwaggerEndpoint("/swagger/public/swagger.json", "공개 API");
options.SwaggerEndpoint("/swagger/auth/swagger.json", "인증 API");
options.SwaggerEndpoint("/swagger/account/swagger.json", "계정 API");
options.SwaggerEndpoint("/swagger/service/swagger.json", "서비스 API");
options.SwaggerEndpoint("/swagger/device/swagger.json", "디바이스 API");
options.SwaggerEndpoint("/swagger/message/swagger.json", "메시지 API");
options.SwaggerEndpoint("/swagger/push/swagger.json", "푸시 API");
options.SwaggerEndpoint("/swagger/stats/swagger.json", "통계 API");
options.SwaggerEndpoint("/swagger/file/swagger.json", "파일 API");
});
}
// -- 16. 엔드포인트 매핑 --
app.MapControllers();
app.MapFallbackToFile("index.html");
return app;
}
}