Självstudie: Konfigurera Insite LMS för automatisk användaretablering

  • Artikel

I den här självstudien beskrivs de steg du behöver göra i både Insite LMS och Microsoft Entra ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare och grupper till Insite LMS med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

  • Skapa användare i Insite LMS
  • Ta bort användare i Insite LMS när de inte längre behöver åtkomst
  • Behåll användarattribut synkroniserade mellan Microsoft Entra ID och Insite LMS

Förutsättningar

Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:

Steg 1: Planera etableringsdistributionen

  1. Lär dig mer om hur etableringstjänsten fungerar.
  2. Fastställa vem som är i omfånget för etablering.
  3. Fastställa vilka data som ska mappas mellan Microsoft Entra ID och Insite LMS.

Steg 2: Konfigurera Insite LMS för att stödja etablering med Microsoft Entra-ID

Så här genererar du den hemliga token

  1. Logga in på Insite LMS-konsolen med ditt administratörskonto.

  2. Gå till programmodulen på menyn till vänster.

  3. I avsnittet Självhanterade jobb hittar du ett jobb med namnet "SCIM". Om du inte hittar jobbet kontaktar du supportteamet för Insite LMS.

    Skärmbild av generera API-nyckel.

  4. Klicka på Generera API-nyckel. Kopiera och spara API-nyckeln. Det här värdet anges i fältet Hemlig token på fliken Etablering i ditt Insite LMS-program.

Kommentar

Api-nyckeln är endast giltig i 1 år och måste förnyas manuellt innan den upphör att gälla.

Lägg till Insite LMS från Microsoft Entra-programgalleriet för att börja hantera etablering till Insite LMS. Om du tidigare har konfigurerat Insite LMS för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som är i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. Om du väljer att omfånget vem som är etablerad i din app baserat på tilldelning kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget vem som etableras enbart baserat på attribut för användaren eller gruppen kan du använda ett omfångsfilter enligt beskrivningen här.

  • Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.

  • Om du behöver fler roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till Insite LMS

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i Insite LMS-appen baserat på användar- och grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Insite LMS i Microsoft Entra-ID:

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program>

    Skärmbild av bladet Företagsprogram.

  3. I programlistan väljer du Insite LMS.

    Skärmbild av länken insite LMS i programlistan.

  4. Välj fliken Etablering.

    Skärmbild av fliken Etablering.

  5. Ange Etableringsläge som Automatiskt.

    Skärmbild av fliken Etablering automatiskt.

  6. I avsnittet Administratörsautentiseringsuppgifter anger du url:en för insite LMS-klientorganisationen som och anger den hemliga token som https://api.insitelms.net/scim genererades i steg 2 ovan. Välj Test Anslut ion för att se till att Microsoft Entra ID kan ansluta till Insite LMS. Om anslutningen misslyckas kontrollerar du att ditt Insite LMS-konto har administratörsbehörighet och försöker igen.

    Skärmbild av token.

  7. I fältet E-postavisering anger du e-postadressen till en person eller grupp som ska få meddelanden om etableringsfel. Markera kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

    Skärmbild av e-postavisering.

  8. Välj Spara.

  9. I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Insite LMS.

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Insite LMS i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Insite LMS för uppdateringsåtgärder. Om du ändrar det matchande målattributet måste du se till att Insite LMS-API:et stöder filtrering av användare baserat på det attributet. Välj Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering Krävs av Insite LMS
    userName String ✓ ✓
    emails[type eq "work"].value String ✓ ✓
    aktiv Booleskt
    name.givenName String
    name.familyName String
    phoneNumbers[type eq "work"].value String

  11. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i självstudien om omfångsfilter.

  12. Om du vill aktivera Microsoft Entra-etableringstjänsten för Insite LMS ändrar du Etableringsstatus till På i avsnittet Inställningar.

    Skärmbild av aktiverad etableringsstatus.

  13. Definiera de användare eller grupper som du vill etablera till Insite LMS genom att välja önskade värden i Omfång i avsnittet Inställningar.

    Skärmbild av etableringsomfånget.

  14. När du är redo att etablera väljer du Spara.

    Skärmbild av sparande av etableringskonfiguration.

Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid än nästa cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

  • Använd etableringsloggarna för att avgöra vilka användare som har etablerats eller misslyckats.
  • Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras.
  • Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Mer information om karantäntillstånd finns i Programetableringsstatus för karantän.

Fler resurser

Nästa steg