kotlin-ktor

name	kotlin-ktor
description	Ktor-applikasjoner i Kotlin — routes, plugins, Koin DI, JWT-claims som NAVident, CallLogging/MDC, StatusPages/ApiError, paginering og input-validering. Brukes via /kotlin-ktor ved Ktor-arbeid.

Ktor — Nav-spesifikt

Autentisering

authenticate("azureAd") {
    get("/api/protected") {
        val principal = call.principal<JWTPrincipal>()
        val navIdent = principal?.getClaim("NAVident", String::class)
    }
}

Avhengighetsinjeksjon

Koin er standard DI-rammeverk for Ktor-repoer i teamet (hvis io.insert-koin finnes i avhengighetene).

Logging

install(CallLogging) {
    mdc("x_request_id") { call.request.header("X-Request-Id") ?: UUID.randomUUID().toString() }
}

Feilhåndtering — StatusPages + ApiError

Team-standard mønster for strukturerte feilresponser: sealed ApiErrorException-hierarki + StatusPages-plugin som mapper til en enhetlig ApiError-payload. Se references/error-handling.md for full implementasjon (ErrorType-enum, ApiErrorException-klasser, installStatusPages(), determineApiError()).

Paginering og input-validering

Team-standard PaginatedResponse<T>-wrapper og route-validering med tidlig-retur på ugyldige parametre. Se references/paginering-og-validering.md.

Graceful shutdown

embeddedServer { ... }.start(wait = true) håndterer SIGTERM via shutdown-hook automatisk i Ktor. Trenger ikke manuell readiness-toggling i applikasjonen. Plattformkonteksten er felles — se nais-manifest-skillen for hvordan NAIS preStop-hook fungerer. Anti-mønstre: manuell readiness=false og lav terminationGracePeriodSeconds.