https://github.com/navikt/vtp
Virtuell tjenesteplattform
https://github.com/navikt/vtp
backend felles foreldrepenger fpsak k9 mock
Last synced: 4 months ago
JSON representation
Virtuell tjenesteplattform
- Host: GitHub
- URL: https://github.com/navikt/vtp
- Owner: navikt
- License: mit
- Created: 2019-03-21T08:59:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-03-03T10:29:49.000Z (4 months ago)
- Last Synced: 2026-03-03T13:44:18.041Z (4 months ago)
- Topics: backend, felles, foreldrepenger, fpsak, k9, mock
- Language: Java
- Homepage:
- Size: 5.64 MB
- Stars: 12
- Watchers: 25
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
[](https://sonarcloud.io/dashboard?id=navikt_vtp)
[](https://sonarcloud.io/dashboard?id=navikt_vtp)
[](https://sonarcloud.io/dashboard?id=navikt_vtp)
[](https://sonarcloud.io/dashboard?id=navikt_vtp)
[](https://sonarcloud.io/dashboard?id=navikt_vtp)
Virtuell Tjeneste Plattform (VTP)
=================================
#### VTP hjelper deg med å:
- virtualisere grensesnitt rundt applikasjonene i FP-familien.
- instansierer og holde testdata konsistente på tvers av grensesnittene
- ha en plattform for å simulere grensesnitt over REST, GRAPHQL, Kafka, LDAP.
- sikkerhetshåndtering over OAuth2
- REST-grensesnitt for å programatisk opprette testdata (for automatiske tester)
- GUI for å opprette testdata for mennesker.
# Henvendelser
- Team Foreldrepenger
- Team Sykdom-i-familien
## For Nav-ansatte
Interne henvendelser kan sendes via Slack i kanalen #vtp-chatten
## Teknologi som må installeres
- Java (https://adoptopenjdk.net/)
- Maven (http://maven.apache.org/)
## Starte applikasjon
For utvikling på VTP benytt oppsett for å starte server gjennom IDE.
I verdikjedetester benyttes oftest Docker-image av VTP. Dette bygges i VTP sin pipeline.
Når applikasjonen har startet blir Swagger konfigurasjonen tilgjengelig på http://localhost:8060/rest/openapi.json
Swagger-ui kan startet vi docker-compose oppsett i /swagger-ui og blir da tilgjengelig på http://localhost:8061/swagger/
#### Starte backend-server via IDE
* IntelliJ må konfigureres med å sette classpath of module til server, og sette working directory til `$MODULE_WORKING_DIR$` i run/debug-konfiguration.
* Start mock serveren ved å kjøre MockServer (lokalt).
#### Kjøre via docker run / docker-compose
##### For å bygge docker image lokalt:
Bygg prosjektet med `mvn clean install"`, bygg deretter docker-imaget med `docker build -t vtp .`
Imaget blir da tilgjengelig som vtp:latest
##### Hente docker-image bygget i pipe:
docker pull ghcr.io/navikt/vtp (dette krever at en allerede logget inn med docker hos ghcr.io)
## Opprette testdata
Testscenarios opprettes ved hjelp av `TestscenarioRestTjeneste.java`. Her sende man inn en JSON-string av testpersonen(e),
testpersonen blir instansiert i VTP og tilgjengliggjort i alle mockene, og den instansierte testpersonen returneres.
JSON objektet har følgende struktur og godtar at en eller flere felter mangler:
```json5
{
"scenario-navn": "",
"personopplysninger": { },
"inntektytelse-annenpart": { },
"inntektytelse-søker": { },
"organisasjon": { },
"vars": { }
}
```
Eksempel på hvordan en kan gjøre dette befinner seg i `model/src/test/ScenarioTest.java` med hjelpeklassen
`model/src/test/TestscenarioHenter.java`. Hjelpeklassen leser av .json filer og oversetter det til en JSON streng som
kan bli brukt i requesten.
## Kjør tester
* Automatiske tester for FPSAK (og andre FP*-familieapplikasjoner) ligger i eget repo på GitHub (private): [fpsak-autotest](https://github.com/navikt/fpsak-autotest)
* Automatiske tester for K9-applikasjoner ligger i eget repo på GitHub (private): [k9-verdikjede](https://github.com/navikt/k9-verdikjede)
## Sertifiakter for SSL/TLS
For å få VTP til å kjøre med SSL/TLS forbindelse over REST, GRAPHQL og Kafka må keystore angitt i VTP være tilgjengelig i SUT (System under test) sin Truststore.
For lokal utvikling på Team Foreldrepenger og Sykdom-i-familien opprettes key- og truststore i.h.t til instruksjoner i verdikjede/autotest.
Følgende systemvariabler kan defineres for å overstyre defaults i VTP:
```bash
JAVAX_NET_SSL_TRUSTSTORE
JAVAX_NET_SSL_TRUSTSTOREPASSWORD
NO_NAV_MODIG_SECURITY_APPCERT_KEYSTORE
NO_NAV_MODIG_SECURITY_APPCERT_PASSWORD
```
## Konfigurere nye tjenester
Se ApplicationConfig for liste over registrerte REST-tjenester. Nye REST-tjenester registreres her.
## Kjente feil
Swagger-codegen kommer med en recuring problem med manglende SLF4J binding (see https://github.com/swagger-api/swagger-codegen/issues/12135)