Okta: SCIM-provisionering
Låt Okta skapa, uppdatera och inaktivera personer i MuchSkills. Du aktiverar SCIM i samma MuchSkills-appintegration som du använder för single sign-on och ansluter den med det klient-ID och den hemlighet som vi skapar åt dig. Sedan väljer du vad Okta får göra och tilldelar personer.
- Vem
- En Owner eller Admin i MuchSkills och en Okta-admin med behörighet att hantera provisionering av appar
- Så kopplas det
- Supporten skickar SCIM-uppgifter, sedan konfigurerar du provisioneringen i Okta
- Krav
- MuchSkills SAML-appintegration i Okta
- Planer
- Ingår i alla planer
How to
Innan du börjar
- I MuchSkills: rollen Owner eller Admin.
- I Okta: en administratör som kan hantera provisionering för MuchSkills-appintegrationen.
- Appen för single sign-on. Okta lägger till SCIM i en befintlig SAML- eller SWA-appintegration. Konfigurera därför Okta: single sign-on först och använd sedan den appen.
- Provisionering aktiverad i din Okta-organisation. Saknas SCIM-alternativet i steg 2 kontaktar du Oktas support.
- SCIM-uppgifter från MuchSkills. Vi skapar ett klient-ID och en klienthemlighet för OAuth 2.0 åt dig. Hemligheten har inget utgångsdatum. Mer om det i steg 1.
- Välj en väg in. Synkar du redan personer med Okta-kopplingen under Settings › Integrations behöver du bestämma vilken av de två du behåller för samma personer.
Steg
På MuchSkills-sidan
- Be supporten om SCIM-uppgifter. Mejla support@muchskills.com eller använd chatten och berätta att du använder Okta. Tills provisioneringen är konfigurerad visar Team/Org › Settings › Security & SAML texten SCIM provisioning is available for your organisation. See the setup guide for next steps.
På Okta-sidan
- Aktivera SCIM. Öppna MuchSkills-appintegrationen i Okta Admin Console. Klicka på Edit under App Settings på fliken General, ställ in Provisioning på SCIM och klicka på Save. Oktas guide till att lägga till SCIM-provisionering
- Fyll i anslutningsvärdena. Gå till Settings › Integration på fliken Provisioning och klicka på Edit:
- SCIM connector base URL:
https://app.muchskills.com/scim/v2 - Unique identifier field for users: userName
- Supported provisioning actions: bocka för Push New Users och Push Profile Updates. Lämna Import New Users and Profile Updates och Push Groups obockade.
- SCIM connector base URL:
- Lägg in uppgifterna. Under Authentication Mode väljer du OAuth2 och grant-typen Client Credentials. Ange
https://app.muchskills.com/oauth2/tokensom endpoint för åtkomsttoken, samt klient-ID:t och klienthemligheten från MuchSkills. Om Okta frågar efter en endpoint för auktorisering anger duhttps://app.muchskills.com/oauth2/authorize.
Klicka på Test Connector Configuration och sedan på Save. - Välj vad Okta får göra. Klicka på Edit under Settings › To App. Bocka för Create Users, Update User Attributes och Deactivate Users. Låt Sync Password vara avstängt och klicka på Save. Oktas guide till provisioneringsinställningar
- Kontrollera attributmappningarna. Skrolla till Attribute Mappings på samma sida. Se till att förnamn, efternamn, mejladress, befattning och avdelning är mappade. Om du vill ändra en mappning klickar du på Go to Profile Editor, öppnar Mappings, redigerar attributet och klickar på Save Mappings och sedan Apply updates now. Användarnamnet hämtas från Application username, som du ställde in på Email för single sign-on.
- Tilldela några personer. Klicka på Assign på fliken Assignments och sedan på Assign to People eller Assign to Groups. Klicka på Assign vid var och en, sedan på Save and Go Back och Done. Okta skapar dem i MuchSkills.
Tillbaka i MuchSkills
- Kontrollera personerna som kommit in. De listas under Team/Org › Members. När allt ser bra ut tilldelar du resten av dina medarbetare i Okta.
Kontrollera att det fungerade
- Test Connector Configuration lyckas i steg 4.
- Personerna du tilldelade visar inga provisioneringsfel på appens flik Assignments i Okta.
- Team/Org › Members listar dem med rätt namn, befattningar och avdelningar.
- Under Team/Org › Settings › Security & SAML står det SCIM provisioning is enabled for your organisation.
Benefits
Det här får du
- Nyanställda och avgångar sköts i Okta. När du tilldelar någon får personen ett MuchSkills-konto. Tar du bort tilldelningen eller inaktiverar personen inaktiveras hen även i MuchSkills.
- Profiländringar följer med. Ändras befattning eller avdelning i Okta skickar Okta uppdateringen vidare till MuchSkills.
- Åtkomsten hanteras på ett ställe. Appen för single sign-on och provisioneringen ligger i samma appintegration i Okta.
Important to know
Bra att veta
Vad som synkas. Bara mejladress och namn är obligatoriska. Mappa så många av de övriga attributen som du har i Okta, eftersom varje attribut gör MuchSkills mer användbart.
| Okta-profil | SCIM-attribut | Behov | Används i MuchSkills till |
|---|---|---|---|
| Användarnamn (mejladressen) | userName | Obligatoriskt | Mejladress och inloggning |
| Primär mejladress | emails | Obligatoriskt | Mejladress. Måste stämma med userName |
| Förnamn, efternamn | name.givenName, name.familyName | Obligatoriskt | Namn |
| Befattning | title | Rekommenderas | Befattning |
| Avdelning | enterprise extension: department | Rekommenderas | Avdelning |
| Chef | enterprise extension: manager | Rekommenderas | Rapportvägar och My Circle. Värdet måste vara chefens mejladress eller användar-id i MuchSkills |
| Adressfält | addresses | Rekommenderas | Plats. Behåll mappningen av land |
| Status | active | Rekommenderas | Inaktivera personer som slutar |
Hur Okta skickar ändringar. Okta identifierar befintliga användare med userName. För att inaktivera någon sätter Okta active till false, och DELETE skickas aldrig för användare. Oktas SCIM-referens
Personer som slutar inaktiveras, de raderas inte. När Okta skickar active satt till false inaktiverar MuchSkills personen. Projekthistorik och certifikat finns kvar.
Roller. Okta skickar ingen MuchSkills-roll i den här konfigurationen, så provisionerade personer får rollen Member. Läs om attributet för roller i SCIM-provisionering: så fungerar det.
Mejladresser hanteras av Okta. Provisionerade personer kan inte ändra sin mejladress i MuchSkills. De ser Managed by automated provisioning under Profile Settings › Account.
Förvara uppgifterna säkert. Behandla token eller klienthemlighet som ett lösenord. Om du misstänker att den har läckt ber du supporten om nya uppgifter och uppdaterar dem i Okta.
Common errors
Felsökning
| Det du ser | Varför | Åtgärd |
|---|---|---|
| Det finns inget SCIM-alternativ under Provisioning | Provisioneringsfunktionen är inte aktiverad i din Okta-organisation, eller så är appen inte en SAML- eller SWA-integration | Kontakta Oktas support och använd SAML-appintegrationen för MuchSkills |
| Test Connector Configuration misslyckas | Bas-URL:en eller inloggningsuppgifterna är felaktiga | Dubbelkolla värdena i steg 3 och 4. Är du osäker kan du be supporten om nya uppgifter |
| Okta visar 401 Unauthorized vid en push | Token eller klientuppgifterna är felaktiga eller gäller inte längre | Ange uppgifterna på nytt eller be supporten om nya |
| En push misslyckas med 409 Conflict | Det finns redan ett MuchSkills-konto med den mejladressen | Kontrollera mejladressen i MuchSkills och i Okta, och att användarnamnet är personens mejladress |
| En push misslyckas eftersom userName inte är en giltig mejladress | Application username är inte satt till Email | Ändra det till Email på fliken Sign On och gör en ny push |
| Ändringar i Okta kommer inte fram till MuchSkills | Push Profile Updates eller Update User Attributes är avstängt | Slå på båda och testa sedan med en ändring |
| En avdelning eller befattning saknas | Attributet är inte mappat till appen | Mappa det under Attribute Mappings och välj sedan Apply updates now |
Vanliga frågor
Behöver vi appen för single sign-on först?
Ja. Okta lägger till SCIM-provisionering i en befintlig SAML- eller SWA-appintegration. Konfigurera därför Okta: single sign-on först och använd sedan den appen.
Vi hittar inte SCIM-alternativet i Okta. Varför?
Enligt Okta måste provisioneringsfunktionen vara aktiverad för din org. Om SCIM inte syns i appens inställningar kontaktar du Oktas support.
Ska vi använda HTTP Header eller OAuth2?
OAuth2. MuchSkills ger dig ett klient-ID och en klienthemlighet, inte en statisk token, så HTTP Header passar inte här. Med grant-typen Client Credentials hämtar Okta själv en ny token som gäller i en timme, varje gång det behövs.
Vad händer när någon slutar?
När du tar bort en persons tilldelning eller inaktiverar personen i Okta skickar Okta active med värdet false, och då inaktiverar MuchSkills personen. Okta raderar aldrig användare i appar. Personens projekthistorik och certifikat finns kvar.
Kan vi skicka Okta-grupper till MuchSkills?
Nej. MuchSkills tar emot användare, inte grupper, så låt Push Groups vara avstängt. Du kan fortfarande tilldela grupper i Okta för att styra vilka som provisioneras.
Vilken roll får de som provisioneras?
Member, så länge ingen roll skickas i attributet roles. I den här konfigurationen skickar Okta ingen MuchSkills-roll, så alla som provisioneras från Okta blir Member.
Kan vi börja med några få personer?
Ja, och det rekommenderar vi. Tilldela en handfull personer, kontrollera dem i MuchSkills och tilldela sedan resten.
Ska vi använda detta eller Okta: synka användare?
Använd en av dem för samma personer. SCIM styrs från Okta. Okta-kopplingen under Settings › Integrations styrs från MuchSkills, synkar var 5:e timme och synkar per grupp. Se Okta: synka användare.
Ingår SCIM i vår plan?
Ja. Alla MuchSkills-planer innehåller SCIM-provisionering och single sign-on (SAML).