SCIM-provisionering: så fungerar det

Så fungerar det

Din identitetsleverantör skickar ändringar till MuchSkills. När du tilldelar någon MuchSkills-appen skapar leverantören personen. När personens uppgifter ändras skickar den en uppdatering. När du tar bort tilldelningen eller inaktiverar personen inaktiveras hen. MuchSkills skriver aldrig tillbaka något till din identitetsleverantör.

Innan du börjar

• I MuchSkills: rollen Owner eller Admin.
• I din identitetsleverantör: en administratör som kan konfigurera provisionering för en app.
• SCIM-inloggningsuppgifter från MuchSkills. Vi skapar ett OAuth 2.0-klient-ID och en klienthemlighet för din organisation. Hemligheten löper inte ut. Spara båda i din lösenordshanterare.
• Single sign-on först. Vi rekommenderar det, så att provisionerade personer kan logga in direkt. Din identitetsleverantör kan låta dig lägga till provisionering i samma app.
• E-postadresser. Det userName du skickar måste vara den e-postadress som varje person använder för MuchSkills.
• Börja smått. Tilldela först en handfull personer, kontrollera resultatet i MuchSkills och tilldela sedan resten.

Steg

Så gör du i MuchSkills

1. Be supporten om SCIM-inloggningsuppgifter. Mejla support@muchskills.com eller skriv i chatten och tala om vilken identitetsleverantör du använder. Vi skapar ett klient-ID och en klienthemlighet åt dig och skickar dem via en säker kanal. Fram till att provisioneringen är på plats står det på Team/Org › Settings › Security & SAML: SCIM provisioning is available for your organisation. See the setup guide for next steps.

I din identitetsleverantör

2. Öppna provisioneringsinställningarna för din MuchSkills-app. Microsoft Entra ID och Okta har egna guider: Microsoft Entra ID: SCIM-provisionering och Okta: SCIM-provisionering.
3. Ange anslutningsvärdena.

4. Välj vad leverantören får göra. Aktivera att skapa användare, uppdatera användarattribut och inaktivera användare. Låt group push, group import och user import vara avstängda.
5. Kontrollera attributmappningen. userName måste innehålla e-postadressen. Mappa så många av fälten i tabellen under Bra att veta som din leverantör har.
6. Testa anslutningen. De flesta leverantörer har en knapp som heter Test Connection eller liknande. Testet lyckas när bas-URL och inloggningsuppgifter är rätt.
7. Tilldela några personer och skicka över dem. Kontrollera dem i MuchSkills och tilldela sedan resten.

Tillbaka till MuchSkills

8. Kontrollera vilka som har kommit in. Under Team/Org › Members ser du dem, med de roller du skickade.

SCIM-raden under Security & SAML länkar till den här guiden.

Kontrollera att det fungerade

• Provisioneringsloggen i din identitetsleverantör visar att användarna har skapats utan fel.
• Under Team/Org › Members finns de personer du har tilldelat, med rätt namn, titlar, avdelningar och chefer.
• I medlemslistan finns en synkikon bredvid varje provisionerad person. Håller du muspekaren över den visas User profile is currently syncing via SCIM.
• På Team/Org › Settings › Security & SAML står det SCIM provisioning is enabled for your organisation.

Det här får du

• Nyanställda och avgångar sköts åt dig. Personer får ett MuchSkills-konto när du tilldelar dem och inaktiveras när du tar bort dem.
• Ett ställe att hantera åtkomst på. Din identitetsleverantör förblir den källa som avgör vem som använder MuchSkills och med vilken roll.
• Ordnad persondata. Namn, titlar, avdelningar och chefer kommer in redo för filter, rapporter och My Circle.

Bra att veta

Operationer som stöds. Alla sökvägar börjar med https://app.muchskills.com/scim/v2.

Filtrering och paginering. Filter stöder eq på userName, till exempel filter=userName eq "anna.berg@example.com". Paginering använder startIndex och count.

Grupper provisioneras inte. MuchSkills tar bara emot användare, så låt group push vara avstängt. Däremot kan du fortfarande tilldela grupper i din identitetsleverantör för att styra vilka som provisioneras.

Vad som synkas. Bara e-post och namn är obligatoriska. Skicka så många av de övriga fälten som du kan, eftersom varje fält gör MuchSkills mer användbart.

MuchSkills har också ett eget användartillägg med fältet profilePicture, ett enklare alternativ till photos. Fråga supporten efter schemanamnet om du vill använda det.

Roller. Skicka en roll per person i roles, markerad som primär. Giltiga värden är Admin, Member och Analyst. Andra värden ignoreras, och personer utan roll läggs till som Member. Rollen Owner kan inte sättas via SCIM.

Exempelanvändare. Så här ser en förfrågan från din identitetsleverantör ut när den skapar en användare:

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "userName": "anna.berg@example.com",
  "active": true,
  "displayName": "Anna Berg",
  "name": {
    "givenName": "Anna",
    "familyName": "Berg"
  },
  "emails": [
    { "value": "anna.berg@example.com", "type": "work", "primary": true }
  ],
  "title": "Senior Consultant",
  "roles": [
    { "value": "Analyst", "primary": true }
  ],
  "photos": [
    { "value": "https://example.com/photos/anna-berg.jpg", "type": "photo" }
  ],
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "department": "Advisory",
    "manager": { "value": "erik.lund@example.com" }
  }
}

Personer som slutar inaktiveras, de raderas inte. Oavsett om din leverantör sätter active till false eller skickar en DELETE-förfrågan försvinner personen från de vardagliga vyerna, medan projekthistorik och certifikat finns kvar, vilket är viktigt vid revisioner.

Ingen tillåtelselista behövs. SCIM-förfrågningar går från din identitetsleverantör till MuchSkills, så du behöver inte tillåta några MuchSkills-adresser för dem.

E-postadresser hanteras av din leverantör. Personer som provisioneras via SCIM kan inte ändra sin e-postadress i MuchSkills. Under Profile Settings › Account ser de Managed by automated provisioning under Your email.

Data som MuchSkills inte tar emot. Ålder eller födelsedatum, lön eller andra ersättningsuppgifter, prestationsbedömningar samt politiska, religiösa eller hälsorelaterade uppgifter stoppas redan när de kommer in och sparas aldrig.

Felsökning