Gå til indhold

Udviklings- og Forenklingsstyrelsen

Udviklings- og Forenklingsstyrelsen

Connectivity

Beskrivelse af systemkommunikation mellem dataanvenders system og DUPLA / Billetautomaten.

  1. Principdiagran
    Principdiagram for systemkommunikation mellem Billetautomaten og DUPLA

    VOCES certifikat (Generer et JWT via Billetautomaten)

    Ved oprettelse af dataudvekslingsaftalen registreres et VOCES certifikat i aftalen.
    Dette er den offentlige standard for certifikater, som defineret af Digitaliseringsstyrelsen. Organisationscertifikater bruges til at bekræfte en organisations identitet, når organisationen skal have adgang til webservices og andre tjenester hos tjenesteudbydere. De kan også bruges til at kryptere den data, der går til og fra tjenesterne.

    Når jeres system (aftagersystemet) forespørger en DUPLA service, valideres det, at det medsendte certifikat matcher det, som er registreret på dataaftalen. Det benyttede VOCES certifikat skal være tildelt PRG rollen Aftager-system, se tildeling af roller​​​​​​​.

    Der skal foretages et POST request til Billetautomaten, til dette request skal der være tilknyttet VOCES certifikatet som er registreret på den indgåede aftale med Dupla. 

    Benyt et af nedenstående endpoints til Billetautomaten:

    Ekstern test (TFE miljø): https://oces.billetautomat.tfe.skat.dk/auth/realms/oces/certificates/cert

    Produktion: https://oces.billetautomat.skat.dk/auth/realms/oces/certificates/cert

     

    Request body skal se således ud:

    {
    "client_id": "api-gateway",
    "nonce":"UUID v4"
    }

  2. Adgangstoken med rettigheder

    Som svar modtager du et adgangstoken (JWT).

  3. Request + adgangstoken

    Nedenstående headere er et krav for request mod en Dupla service.

    De tre headere fremgår også med præcise feltnavne i Open API specifikationen for den enkelte service (Findes i Servicekataloget). Såfremt der er forskel på nedenstående oversigt og det, der fremgår af Open API specifikationen, så skal I forholde jer til Open API specifikationen.

    Påkrævede headers
    Header   Påkrævet format
    Transaktions_ID UUID v4
    Request_ID UUID v4
    UFST-Adgangsgrundlag urn:ufst:adgangsgrundlag:aftale{{aftale id UUID v4}}
    Authorization header, Type: Bearer token JWT fra Billetautomat

     

End points

Servicens specifikke path kan findes i Open API specifikationen for den relevante service (se Servicekataloget for at downloade Open API specifikationen).

Forudsætninger

Dataaftageren har på forhånd fået oprettet en dataaftale i DUPLA

  • Ekstern test: Brug Dataudvekslings testaftale, så I kan test med anonymiseret eller syntetisk testdata
  • Produktion: Der laves en rigtig aftale, I kan bruge til at modtage produktive data