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.
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
| 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 |