Webservicebesked (WSB) Tjekliste forudsætninger for ekstern modtagelse af STARs webservicebeskeder

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

Formelt

Databehandleraftale

Aftageren skal sikre at denne har en formel dataudvekslingsaftale med STAR

Teknisk

Krav til processering og returkoder

STARs krav til processering og returkoder er beskrevet her, og skal følges: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3950510658/Den+gode+WSB+webservicebesked#Returkoder-og-fejlh%C3%A5ndtering-(link-til-permanent-forretningsside)

Følgende skal gennemføres, og hvert punkt (1, 3 og 4) bedes bestilt i separate topdesk sager:

1. Rekvirer STARs klientcertifikat og evt. IP adresser til whitelist

Opret topdesk sag og bestil

STAR klientcertifikat

• Test: sys-org-star-test.cer

• Prod: sys-org-star.cer

Certifikatet er nødvendigt for for at kunne understøtte MTLS. STAR benytter samme klientcertifikat imod alle WSB-aftagere

STARs IP adresser

hvis der kræves whitelist for at STAR kan kalde baseurls/endpoints, rekvireres også STARs IP adresser til test og prod miljø.

2. Opret baseurls/endpoints

• Opret et eller flere https endpoint (port 443 eller port 8889) som kan kaldes af STAR (der er behov for endpoints til både et produktionsmiljø samt et passende antal test-miljøer).
  Der skal oprettes minimum et endpoint pr. myndighed pr system

  • Eksempel:
    https://test.akassenavn.dk/webhooknavn
    https://test.kssnavn.dk/aftagersystem1 // https://prod.kssnavn.dk/aftagersystem2
    https://test.aftagersystem.dk/akassenavn

• SSL certifikater kan ikke være self-signed, men skal være udstedt af trusted CA

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

"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": {
    "...": "..."
  }

3. Bestil konfigurering af Baseurls

Opret Topdesk sag, og bestil konfiguration af de oprettede endpoints / Baseurls.

Følgende formular kan anvendes hvis det ønskes (er ikke et krav):

Systemforvalter konfigurerer disse i Subscribersystem hvor vi yderligere indsætter hvilket klientsystem baseurlen tilhører.

4. Opsæt ønskede abonnementer (WebApi eller LSS brugergrænseflade)

Opsæt ønskede abonnementer.

WebApi EksternKommunikation Services

Webservicebesked abonnementsoprettelse

Følgende formular kan anvendes hvis det ønskes (er ikke et krav):

5.Opsæt ønskede abonnementer (LSS brugergrænseflade)

Adgang Test

Hvis man ønsker at bruge LSS brugergrænsefladen, kræver det personligt certifikat, som skal tildeles adgang. Dette bestilles ved at oprette en topdesk sag.

Systemforvaltning udsteder certifikatet til Testmiljøerne (eller tildeler adgang på eksisterende certifikat).

Adgang Produktion

Til Produktion skal aftager selv komme med personligt OCES3 certifikat udstedt af den danske stat, og banke på amportal.bm.dk med certifikatet. Herefter oprettes en sag i topdesk for at få tildelt adgang.

Vejledning - Banke på med certifikat i produktionsmiljøet

Opsætning

LSS: Adgang til WSB administration i LSS for eksterne