Självstudie: Konfigurera grammatik för automatisk användaretablering

  • Artikel

I den här självstudien beskrivs de steg du behöver utföra i både Grammatik och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När microsoft Entra-ID konfigureras etableras och avetableras användare och grupper automatiskt till Grammatik 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 grammatik
  • Ta bort användare i grammatik när de inte behöver åtkomst längre
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och grammatik

Förutsättningar

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

  • En Microsoft Entra-klientorganisation
  • Ett användarkonto i Microsoft Entra-ID med behörighet att konfigurera etablering (t.ex. programadministratör, molnprogramadministratör, programägare eller global administratör).
  • Ett Grammatikaffärskonto med administratörsåtkomst.

Steg 1: Planera etableringsdistributionen

  1. Lär dig mer om hur etableringstjänsten fungerar.
  2. Ta reda på vem som finns i etableringsomfånget.
  3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Grammatik.

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

Kontakta din grammatikrepresentant eller skriv till för att support@grammarly.com begära din etableringstoken.

Lägg till Grammatik från Microsoft Entra-programgalleriet för att börja hantera etablering till Grammatik. Om du tidigare har konfigurerat Grammatik för enkel inloggning kan du använda samma program. Vi rekommenderar att du skapar en separat app när du testar integreringen från början. Mer information om hur du lägger till ett program från galleriet finns i den här snabbstarten.

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

Du kan använda Microsoft Entra-etableringstjänsten för att omfånget som ska etableras baserat på tilldelning till programmet eller baserat på användarens eller gruppens attribut. Om du väljer att omfånget som ska etableras till din app ska baseras 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 ska etableras enbart baserat på attribut för användaren eller gruppen kan du använda ett omfångsfilter enligt beskrivningen i Etablera appar med omfångsfilter.

  • När du tilldelar användare och grupper till Grammatik måste du välja en annan roll än Standardåtkomst. Användare med standardåtkomstrollen undantas från etablering och markeras som ej berättigade i etableringsloggarna. Om den enda roll som är tillgänglig i programmet är standardåtkomstrollen kan du uppdatera programmanifestet för att lägga till fler roller.

  • Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra det här alternativet 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.

Steg 5: Konfigurera automatisk användaretablering till grammatik

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 eller grupper i TestApp baserat på användar- eller grupptilldelningar i Microsoft Entra-ID.

Konfigurera automatisk användaretablering för grammatik 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.>

    Screenshot that shows the Enterprise applications pane.

  3. I listan över program väljer du Grammatik.

    Screenshot that shows the Grammarly link in the list of applications.

  4. Välj fliken Etablering.

    Screenshot that shows the Provisioning tab.

  5. Ange Etableringsläge till Automatiskt.

    Screenshot that shows Provisioning Mode set to Automatic.

  6. Under avsnittet Administratörsautentiseringsuppgifter anger du i fältet https://sso.grammarly.com/scim/v2Klient-URL och i fältet Hemlig token anger du den token som tillhandahålls av Grammatik (se steg 2 ovan). Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till grammatik. Om anslutningen misslyckas kontrollerar du att ditt grammatikkonto har administratörsbehörighet och försöker igen.

    Screenshot that shows the Tenant URL and Secret Token boxes.

  7. I rutan 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 .

    Screenshot that shows the Notification Email box.

  8. Välj Spara.

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

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

    Attribut Type Stöds för filtrering
    userName String ✓
    externalId String
    aktiv Booleskt
    displayName String
    emails[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 grammatik ändrar du Etableringsstatus till På i avsnittet Inställningar.

    Screenshot that shows the Provisioning Status toggled On.

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

    Screenshot that shows the Provisioning Scope.

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

    Screenshot that shows the Save button.

Å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 att utföra än efterföljande 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 innehålla fel, kommer programmet att placeras i karantän. Mer information om karantäntillstånd finns i Programetableringsstatus för karantän.

Ytterligare resurser

Nästa steg