Opsæt oprettelse af brugerkonti via SCIM

Oprettet af Trevor Tarpley, Ændret den Thu, 29 Okt kl. 10:59 AM af Trevor Tarpley

Opsæt oprettelse af brugerkonti via SCIM

INDHOLDSFORTEGNELSE

Overblik

SCIM er en metode til at oprette medarbejdere direkte fra dit Identity Provider (IdP).

Spotnana understøtter SCIM sammen med Entra ID. 

  • Fordele ved SCIM: Hvis du allerede bruger SCIM til andre systemer, kan du hurtigt komme i gang, da det er en standardiseret løsning. Ofte kan det sættes op uden at skulle ændre kode eller oprette filer.

  • Mulige ulemper ved SCIM: De felter, der kan overføres fra din IdP, er ofte færre end dem, du har i dit HR-system. Derfor kan det ske, at alle de oplysninger, du har i HR-systemet, ikke automatisk findes i Entra ID. Hvis du har brug for at overføre flere felter, kan det gøre opsætningen lidt mere kompleks.

Forudsætninger

Nogle ting, du skal have styr på, før du går i gang med at matche dine attributter:

  • Gennemgå den SCIM-klient, som din IdP stiller til rådighed. Tjek, om de data, du får gennem SCIM, lever op til de krav, du har til brugerdata i Spotnana.

  • Bed din Spotnana Account Manager eller TMC-supporten om at oprette en API-bruger til dig med SCIM-token, der ikke udløber.

  • Sørg for, at din SCIM-klient har en rapporteringsfunktion, der kan bekræfte og logge, om forespørgsler lykkes eller fejler.

Kortlæg de nødvendige attributter

Brug tabellen nedenfor som vejledning, når du skal matche de påkrævede attributter.

Faste felter

Matchning ved brug af Entra ID

Matchning ved brug af anden IdP *

Særlige bemærkninger/konfigurationsnoter

userName

userPrincipalName

Primær arbejds-e-mail

Bør bruges som det attribut, der matcher brugeren

active

Switch([IsSoftDeleted], , "False", "True", "True", "False")

boolean-værdi: True eller False


emails[type eq "work"].value

mail

Arbejdsmail


name.givenName

givenName

Fornavn


name.familyName




efternavn

Efternavn


externalId

mailNickname

Yderligere unik ID

Valgfri, skal være unik

urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User:legalEntityRef:name

legalEntityName

Juridisk enheds navn

BEMÆRK: Der skal tilknyttes en juridisk enhed til hver bruger. Hvis en bruger importeres via SCIM uden en juridisk enhed, vil brugeren automatisk blive tilføjet til en standard juridisk enhed. Hvis det ikke er ønsket, at brugere tilføjes til en standard juridisk enhed, bør du undlade at bruge SCIM. 

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber

employeeId

Medarbejder-ID eller medarbejdernummer

Valgfri, skal være unik

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department

afdeling

Navn på afdeling


urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager

leder

Objekt som {“value”: managerId}


urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User:officeRef:name

officeName

Navn på kontor


urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter

costCenterName

Navn på omkostningssted


urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User:isoCountryCode

isoCountryCode

2-cifret ISO-landekode


* Bemærk: For værdier til IdP’er, der ikke er Entra, kan vi muligvis ikke foreslå en specifik værdi. Du kan dog ofte finde ud af, hvilken værdi du skal bruge, ved at se på det, vi har angivet for Entra.

Aktivér SCIM i online bookingværktøjet

Hvis du flytter fra et andet brugersystem til SCIM

Hvis du skifter til SCIM fra en anden HR-løsning, som tidligere har været brugt til at oprette brugerkonti i Spotnana, skal du sørge for at stoppe brugen af denne HR-løsning (eller andre). Dette gælder blandt andet:

  • Stop med at sende HR-data via OBT

  • Stop med at sende HR-data via SFTP

  • Stop med at benytte Spotnanas brugeradministrations-API'er

  • Bed Spotnana support om at deaktivere eventuel HRIS-integration og synkronisering

Når du har gennemført alle disse trin, kan du fortsætte til Hvis du aktiverer SCIM for første gang nedenfor.

Hvis du aktiverer SCIM for første gang

Disse trin tager udgangspunkt i, at du bruger Entra som din IdP. Men du kan i store træk følge samme fremgangsmåde, hvis du bruger en anden IdP.

Hvis du skal aktivere SCIM for første gang, skal du gennemføre følgende trin i din IdP:

  1. Begynd med at opsætte SCIM-konfigurationen i din IdP. For eksempel skal du i Entra oprette en brugerdefineret virksomhedsapplikation til SCIM-provisionering.

  2. Opret de relevante mapping-regler i Entra ved at bruge indstillingerne i tabellen ovenfor.

  3. Angiv "https://api.spotnana.com/v2/scim" som basisdomæne (i din IdP), hvor SCIM-forespørgsler skal sendes til. 

  4. Bed din Spotnana-support eller TMC-support om et API-brugertoken med lang levetid. 

  5. Tilføj derefter dette token i din IdP, så det bruges til langvarig godkendelse for din SCIM-klient.

  6. Bed din Spotnana-support eller TMC-support om at tilføje din e-mail som modtager af fejlrapporter for SCIM.

  7. Prøv at oprette én bruger som test og gennemgå resultatet. Testen er godkendt, hvis:

    • Brugeren er oprettet på Spotnana-platformen, og kontoen indeholder alle de nødvendige oplysninger.

    • SCIM-klienten laver logfiler, der viser, om processen er gennemført korrekt. Hvis der opstår fejl, eller hvis du oplever problemer, skal du kontakte Spotnana.

  8. Vælg de brugergrupper i dit IdP-system, som skal oprettes via SCIM. Det er disse grupper, der får adgang til Spotnana.

  9. Slå brugen af SCIM-grupper fra i IdP’ens SCIM-indstillinger. 

    • Bemærk:IdP-brugergrupper er ikke SCIM-grupper. Du kan stadig klargøre IdP-brugergrupper. Spotnana understøtter dog ikke SCIM-grupper.

  10. Aktiver automatisk SCIM-provisionering for alle brugere i dit IdP-system. 

Tjek at din SCIM-integration fungerer

Gør følgende for at sikre, at din SCIM-integration fungerer, som den skal: 

  • Sørg for, at brugerprofiler bliver indlæst i Spotnana.

  • Tjek jævnligt, om der bliver sendt fejlbeskeder til den angivne mailkonto. 

Hvis din brugerkonto er sat op til at modtage fejlmeldinger fra SCIM, får du dagligt en mail med en oversigt over eventuelle fejl.

Relaterede emner


Var denne artikel nyttig?

Fantastisk!

Tak for din feedback

Beklager, at vi ikke var nyttige

Tak for din feedback

Fortæl os, hvordan vi kan forbedre denne artikel!

Vælg mindst én af grundene
Captcha-bekræftelse er påkrævet.

Feedback sendt

Vi sætter pris på din indsats og vil forsøge at rette artiklen