Persontjenesten på Navet

Strøm fra Persontjenesten

Persontjenesten tilbyr en enkelt strøm på Navet som har det nyeste persondokumentet for hver unike person i Persontjenesten. Strømmen er tilgjengelig på både ny og gammel kafka plattform, men alle konsumenter bør begynne å benytte strømmen i den nye, selvbetjente plattformen. For mer informasjon om den nye plattformen, se Ny selvbetjent plattform.

Strømmen kan brukes til å innhente informasjon om hele norges befolkning, og holde denne oppdatert. Strømmen inneholder data om alle personer i Folkeregisteret, i tillegg til alle nasjonale felles hjelpenummer som er opprettet. For mer informasjon om felles hjelpenummer, se Alternate Identification Number API.

Under er en oversikt over hvor data ligger idag. Produksjonsdata er ikke tilgjengelig for øyeblikket i ny plattform, men vil bli tilgjengelig iløpet av høsten 2024.

Miljø Bootstrap servers Topic navn Using schema registry
Gammel plattform (TEST) 10.204.39.16:9091,10.204.39.26:9091,10.204.39.27:9091 t.shp-persontjenesten-persons-compact Yes
Gammel plattform (PROD) 10.204.39.15:9091,10.204.39.17:9091,10.204.39.23:9091,10.204.39.34:9091 t.shp-persontjenesten-persons-compact Yes
Ny plattform (TEST) bootstrap-trd-test.kafka.nhn.no:9094
bootstrap-osl-test.kafka.nhn.no:9094
nhn-test-test-t.shp-persontjenesten-persons-compact No
Ny plattform (PROD) bootstrap-trd.kafka.nhn.no:9094
bootstrap-osl.kafka.nhn.no:9094
nhn-prod-prod-t.shp-persontjenesten-persons-compact No

Meldingsformat

Primærnøkkelen (message key) for meldingene i strømmen er persontjenestens personId, en GUID som blir tildelt hver unike person. Når informasjon i persondokumentet for en person oppdateres, skrives dette dokumentet som en ny melding på strømmen med samme nøkkel (personId). Strømmen er "compacted", som gjør at gamle dokumenter for den samme personen vil etter hvert blir slettet, og kun det nyeste dokumentet vil ligge igjen i strømmen.

Selve meldingen (message payload) inneholder det nyeste persondokumentet for en person i Persontjenesten, i JSON format. Formatet på dokumentet er identisk med responsen fra Persontjenestens API, men i motsetning til API'et der man må spesifisere hvilke informasjonselementer man vi ha med, vil persondokumentet i strømmen være komplett, med all data. Konsumenter må vurdere hvilken informasjon man har hjemmel for å innhente for deres tjeneste, og kun bruke/lagre dette. For mer informasjon om informasjonsmodellen, se Information model.

Ny selvbetjent plattform

Selvbetjening for den nye plattformen er tilgjengelig på https://axual.kafka.nhn.no. NHN SSO kan benyttes for å logge inn. Det anbefales at man får opprettet en gruppe for leveranseteamet, som brukeren kan legges til i.

For å få tilgang til strømmen fra Persontjenesten må man gjøre følgende:

  1. Opprette en ny applikasjon, helst knyttet til gruppen for ditt leveranseteam
  2. Forespørre lesetilgang for denne applikasjonen på t.shp-persontjenesten-persons-compact strømmen, og få godkjent denne
  3. Generere en sertifikatpakke som inkluderer et offentlig sertifikat og en privatnøkkel som brukes for å autentisere applikasjonen mot kafka clusteret
  4. Laste opp det offentlige sertifikatet for applikasjonen i selvbetjeningsverktøyet
  5. Koble applikasjonen til kafka clusteret med bruk av SSL