navikt/syfohelsenettproxy

Skjold mot helsenett

Syfohelsenettproxy

Denne appen fungerer som et skjold helsenett hvor fæle apier med særnorske tegn regjerer. Målet er å tilby konkrete REST-endepunkter som løser våre problemer, og holde ute datamodellene fra helsenett.

Teknologier

• Kotlin
• Ktor
• Gradle
• Kotest
• Jackson
• SOAP

Flytkart

Dette er det eit oversiktsbilde av flyten i applikasjonen

  graph LR
  
      syfohelsenettproxy --- STS
      syfohelsenettproxy --- pep-gw    
      pep-gw --- nhn; 

Bygg & Deploy

På grunn av særnorske tegn i klassenavn / encoding i WSDLen som vi baserer oss på bygger ikke dette prosjektet ut av boksen på Windows. Det er en kjent feil, men vi har ikke funnet en god løsning på det enda. Appen bygges og deployes fra GHA

Gradle kommandoer for bygg og test

For å bygge lokalt og kjøre integrasjonstestene kan du ganske enkelt kjøre

./gradlew clean build

eller på Windows gradlew.bat clean build

Oppgradering av gradle wrapper

Finn nyeste versjon av gradle her: https://gradle.org/releases/

./gradlew wrapper --gradle-version $gradleVersjon

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan stilles som issues her på GitHub

For NAV-ansatte

Interne henvendelser kan sendes via Slack i kanalen #team-sykmelding

syfohelsenettproxy's Issues

MDC

Det hadde vært veldig fint med en Interceptor på restkall som fanger opp en callIdheader og setter denne i MDC. Denne kan da legges på WS-kall bakover.

Det er litt problematisk med da vi bruker coroutines.
En tidligere løsning: https://github.com/navikt/syfonarmesteleder/blob/master/src/main/kotlin/no/nav/syfo/CoroutineMDCContext.kt

Eksempelkode:

-- Rest interceptor -- 
fun Routing.registerCallIdInterceptor() {
    intercept(ApplicationCallPipeline.Setup) {
        val header = call.request.header(NAV_CALLID)
        if (header != null) {
            MDC.put(NAV_CALLID, header)
        } else {
            log.warn("Kall mangler Call Id")
            call.respond(BadRequest, "Mangler header `NAV_CALLID`")
            return@intercept finish()
        }
    }
}
-- TEST --
describe("CallIdInterceptor") {
        val engine = TestApplicationEngine()
        engine.start(wait = false)
        engine.application.apply {
            routing {
                registerCallIdInterceptor()
                get("/testApi") { call.respond(HttpStatusCode.OK) }
            }
        }

        afterGroup {
            engine.stop(0L, 0L, TimeUnit.SECONDS)
        }

        it("Kall uten callId får feilmelding") {
            with(engine.handleRequest(HttpMethod.Get, "/testApi")) {
                response.status()?.shouldEqual(HttpStatusCode.BadRequest)
            }
        }

        it("Kall med callId setter callId i MDC og slippes gjennom") {
            with(engine.handleRequest(HttpMethod.Get, "/testApi") {
                addHeader(NAV_CALLID, "callId")
            }) {
                response.status()?.shouldEqual(HttpStatusCode.OK)
                MDC.get(NAV_CALLID).shouldNotBeNull()
                MDC.get(NAV_CALLID).shouldEqual("callId")
            }
        }
    }
-- WS Interceptor --
class CallIdOutInterceptor : AbstractSoapInterceptor(Phase.WRITE) {
    override fun handleMessage(message: SoapMessage?) {
        val callId = MDC.get(NAV_CALLID) ?: run {
            UUID.randomUUID().toString()
                .also { log.info("Fant ikke callId på kall. Lager ny: $id") }
        }

        message?.headers?.add(Header(QName("callId"), callId))
    }
}