Gå til indhold

Autentificering via Billetautomaten

Denne vejledning beskriver kald mod Billetautomaten (BAT), der med et registreret OCES3-certifikat udsteder en JWT-token til dataudveksling med DUPLA. Selve kald og kaldemønstre til DUPLAs APIer bliver ikke beskrevet i vejledningen.  

Sådan kaldes Billetautomaten med OCES3 certifikat 

Billetautomaten modtager et OCES3 organisationscertifikat og udsteder en token til digital identifikation af anvender systemet, baseret på virksomhedens CVR-nummer på certifikatet.  

Systembeskrivelse BAT og anvendersystem
Certifikater og TLS 

En TLS-forbindelse opsættes mellem den kaldende klient og Billetautomaten. I kald til Billetautomaten sendes dataanvenders OCES3-certifikat, som valideres af Billetautomaten. 

Dataanvenders OCES3-certifikat udveksles som en del af TLS handshaket. En forudsætning for at TLS-forbindelse kan etableres er, at Globalsigns rodcertifikat skal være installeret. 

Kald til Billetautomaten (BAT)  

For at få udstedt en access token af Billetautomaten med identifikation og evt. verifikation af et fuldmagtsforhold (autorisation) kaldes Billetautomaten endpoint, https://bat.skat.dk/realms/oces/protocol/openid-connect/token   

Bodyparameter 

  • 'client_id' udfyldes med 'api-gateway'
  • 'scope' udfyldes med 'openid'
  • 'grant type' udfyldes med ”password”
  • ’x-transaction-id” udfyldes med et unikt UUID 
Brugsmønstre

Indhold mangler

Test og produktionsmiljøer
   
TFE: Testmiljø for eksterne dataaftagere  https://bat.tfe.skat.dk/realms/oces/protocol/openid-connect/token   
PROD: Produktionsmiljø for Billetautomaten.  https://bat.skat.dk/realms/oces/protocol/openid-connect/token   
OBS: Det returnerede accesstoken opbevares og behandles sikkert.