Denne guide beskriver, hvordan man som ekstern aftager af JobannonceService udfylder de nødvendige headers i et request, hvorpå vi kan identificere og authenticate en given aftager. De to nødvendige headers har følgende format.
ActiveOrganisation (x-activeOrganisation)
{
"OrganisationType": 0,
"OrganisationCode":"string"
}
RequestUserMetadata (x-requestUserMetadata)
{
"RequestUserStructure":
{
"UserFullName":"string",
"RequestUserType": 0,
"UserEmail": null,
"UserIdentifier":"string"
},
"RequestOrganisationStructure":
{
"OrganisationType": 0,
"OrganisationCode":"string"
},
"RegistrationDateTime":"2023-06-12T13:01:56.0362963+02:00"
}
Herunder følger et skema, som giver en oversigt over, hvad man skal udfylde headers med af værdier, alt efter hvilken type aftager man er.
ImpersonatedAuthority (ActiveOrganisation) - CVR validering
| KSS, Jobcenter | KSS, A-Kasse | Virksomhed | HR-system | Portal |
|---|---|---|---|---|---|
OrganisationType | 8 (Jobcenter) | 2 (AKasse) | 24 (Virksomhed) | 24 (Virksomhed) | 24 (Virksomhed) |
OrganisationCode | Jobcenterkode (fx. 10100) | A-kassekode (fx. 15) | CVR | CVR for systemets bruger | CVR for portalen |
CallingAuthority (RequestOrganisationStructure)
| KSS, Jobcenter | KSS, A-Kasse | Virksomhed | HR-system | Portal |
|---|---|---|---|---|---|
RequestUserStructure.UserFullName | Sagsbehandlers navn | Sagsbehandlers navn | Virksomhedens kontaktpersons navn | Systemets kontaktpersons navn | Portalbrugerens navn |
RequestUserStructure.RequestUserType | 2 (Sagsbehandler) | 2 (Sagsbehandler) | 4 (Medarbejder) | 3 (System) | 4 (Medarbejder) |
RequestUserStructure.UserEmail | Sagsbehandlers email | Sagsbehandlers email | Virksomhedens kontaktpersons email | Systemets kontaktpersons email | Portalbrugerens email |
RequestUserStructure.UserIdentifier | Skal angives på denne form, hvor alle x skal erstattes af tal eller bogstaver: CVR:xxxxxxxx-UUID:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CVR værdien skal være CVR angivet på certifikatet, UUID skal være certifikatets UUID. Hvis OCES2 certifikat er formen, hvor FID skal være certifikatets FID: CVR:xxxxxxxx-FID:xxxxxxxx | Skal angives på denne form, hvor alle x skal erstattes af tal eller bogstaver: CVR:xxxxxxxx-UUID:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CVR værdien skal være CVR angivet på certifikatet, UUID skal være certifikatets UUID. Hvis OCES2 certifikat er formen, hvor FID skal være certifikatets FID: CVR:xxxxxxxx-FID:xxxxxxxx | Udfyld med selvvalgt identifier som I skal kunne identificere brugeren ud fra | Udfyld med selvvalgt identifier som I skal kunne identificere brugeren ud fra | Udfyld med selvvalgt identifier som I skal kunne identificere brugeren ud fra |
RequestOrganisationStructure.OrganisationType | Hvis,
| Hvis,
| 24 (Virksomhed) | 24 (Virksomhed) | 24 (Virksomhed) |
RequestOrganisationStructure.OrganisationCode | Hvis,
| Hvis,
| CVR | CVR for systemet | CVR for portalens bruger |