Tjekliste for eksterne ifht. webservicebeskeder

Alle som ønsker at modtage STARs webservicebeskeder bedes efterleve nedenstående tjekliste:

Formelt

Aftageren skal sikre at denne har en formel dataudvekslingsaftale med STAR

Teknisk

Rekvirer STARs klientcertifikat info for at kunne understøtte MTLS (via https://topdesk.star.dk/ ). STAR benytter samme klientcertifikat imod alle WSB-aftagere

Opret et eller flere https endpoint (port 443) som kan kaldes af STAR (der er behov for endpoints til både et produktionsmiljø samt et passende antal test-miljøer). SSL certifikater kan ikke være self-signed, men udstedt af trusted CA.

Endpointet skal kunne modtage http requests med JSON payload. Se eksempel herunder:

JSON payload eksempel

Den gode WSB/webservicebesked

Dette json eksempel viser den tiltænkte struktur for metadata. Forbehold for mindre justeringer.

"MetaData":{
    "Oprindelse":{
      "RegistrerendeMyndighed": {
        "OrganisationsType": "5",
        "OrganisationsKode": "1"
      },
      "RegistrerendeBruger": {
        "Brugernavn": "Anders And",
        "BrugertypeId": "1",
        "BrugertypeNavn": "Borger",
        "Brugeridentifikation": "1234567890",
        "Brugeremail": "anders@disney.dk",
        "KaldendeMyndighed": {
          "OrganisationType": "5",
          "OrganisationKode": "1"
        }       
      }
      "SystemId": "4",
      "Systemnavn": "DFDG",
    },
    "BeskedIdentifier": "f89a557e-86c3-4cb6-a350-076f660a1fd5",
    "HaendelsesTid": "2023-01-31T12:34:56.789+02:00",
    "Miljoe": "T4",    
    "KorrelationsIdentifier": "a8443148-2362-4728-a039-b11f4a306c99",
    "EntitetId": "30000",
    "EntitetNavn": "Cv",
    "EksternIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "VersionIdentifier": "6edebedb-0bdb-4a0e-b70b-eb4c1022e2c2",
    "Identifikation": "0000000000"
    "IdentifikationstypeId": "1",
    "IdentifikationstypeNavn": "Cprnummer",
    "AendringstypeId": "2"
    "AendringstypeNavn": "Opdatering"
  },
  "Body": {
    "...": "..."
  }

STARs forventning til processering og returkoder er beskrevet her: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3950510658#Returkoder-og-fejlh%C3%A5ndtering
Der skal oprettes minimum et endpoint pr. myndighed pr system
Systemforvalter skal meddeles baseurl’er via https://topdesk.star.dk/.

Af sikkerhedsmæssige årsager kan aftagere ikke selv styre baseurl via WebApi på nuværende tidspunkt.

Opsæt ønskede abonnementer via WebApi (EksternKommunikation Services) eller LSS' brugergrænseflade

Tjekliste for eksterne ifht. webservicebeskeder

Formelt

Teknisk

Tilgængelighed: https://starwiki.atlassian.net/was