BRS-NO-624 Oppdatering av tredjepartstilgang via URL

Oversikt

Før oppdatering av tilgang skal tredjepart ha gyldig kontrakt med sluttbruker og med Elhub.

Tredjepart kan med denne prosessen få tilgang til måleverdier og grunndata uten å ha kjennskap til hvilke målepunkt sluttbruker eier eller sluttbrukers fødselsnummer/organisasjonsnummer.

Prosessflyt

Prosessforløp

Hovedprosessen er som følger:

• Tredjepart sender melding – URL til sluttbruker fra sitt datasystem/applikasjon.

• Sluttbruker logger inn på Elhub Min side via ID-porten.

• Sluttbruker gir tilgang til de målepunktene tredjepart skal ha tilgang til, eventuelt avviser forespørselen.

• Tredjepart får melding tilbake om hvilke målepunkter tilgang er gitt for samt startdato, eventuelt melding dersom forespørsel ikke godkjennes.

Forutsetning

• GLN-nummer til tredjepart og returadresse må whitelistes hos Elhub. Informasjon om GLN-nummer og returadresse sendes til post@elhub.no.

Fra tredjepart til Elhub

Tredjepartene kan videresende sluttbrukere til Elhub Min Side for å godkjenne BRS-NO-624. Adressen skal ha følgende format: 

https://minside.elhub.no/third-party-access/authorize?client_id=<GLN number>&request_id=<request id from third party>&scope=Full&redirect_url=<URL>

Eksempel:

https://minside.elhub.no/third-party-access/authorize?client_id=1234567890123&request_id=df88e4ca-5804-4dac-aaf4-170a58f5bb36&scope=Full&redirect_url=minurl.no?some_param=value

• Forklaring:

  • “GLN-nummer” er GLN-nummer til tredjepart

  • “request_id” skal være på UUID format

  • “scope” kan være enten “Full” eller “Limited”

  • “redirect_url” er en valgfri returadresse etter at tilgang er gitt/ avbrutt av sluttbruker. Hvis dette ikke er satt bør brukeren lukke siden selv

Returmelding til tredjepart med kontraktsinformasjon

Det kan sendes en returmelding etter BRS-NO-624 er fullført som sender brukeren tilbake til tredjeparten. Denne returadressen oppgis av oppgis av tredjeparten og må whitelistes hos Elhub.

Det sendes én returmelding per BRS-NO-624 brukeren får. Returmeldingen sendes som en POST med Content-Type “application/json”. Denne kan inneholde et eller flere “notification”-objekter, avhengig av antall målepunkter brukeren godkjenner.

Returmeldingen inneholder følgende elementer:

• elhubGLN – Elhub’s GLN nummer

• ThirdpartyGLN– tredjepart sitt GLN nummer

• contractId - unik id for kontrakt i Elhub

• requestid – request_id som er mottatt fra tredjepart

• accessCode - Full or Limited

• MeteringPointId– målepunktid som det er gitt tilgang på

• Start – Dato for innflytt for sluttbruker på målepunktet

• End – Dato tilgang gjelder til dersom dato er angitt fra sluttbruker, default dato er 3 år frem i tid

Eksempel på returmelding til tredjepart

BRS-NO-624-returmelding-eksempel-v2 (1).pdf

Valideringsregler