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

Målet med den här självstudien är att demonstrera de steg som ska utföras i Smartsheet och Microsoft Entra ID för att konfigurera Microsoft Entra-ID för att automatiskt etablera och avetablera användare och/eller grupper till Smartsheet. 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 Smartsheet
  • Ta bort användare i Smartsheet när de inte längre behöver åtkomst
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Smartsheet
  • Enkel inloggning till Smartsheet (rekommenderas)

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. Ta reda på vem som finns i etableringsomfånget.
  3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Smartsheet.

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

Innan du konfigurerar Smartsheet för automatisk användaretablering med Microsoft Entra-ID måste du aktivera SCIM-etablering på Smartsheet.

  1. Logga in som systemadministratör i Smartsheet-portalen och gå till Administrationscenter för konto>.

    Skärmbild av Administratör för Smartsheet-konto

  2. På sidan Administrationscenter klickar du på menyalternativet för att visa menypanelen.

    Skärmbild av Smartsheet-säkerhetskontroller

  3. Gå till menyn > Inställningar > domäner och automatisk etablering av användare.

    Skärmbild av Smartsheet-domän

  4. Om du vill lägga till en ny domän klickar du på Lägg till domän och följer anvisningarna. När domänen har lagts till kontrollerar du att den också verifieras.

  5. Generera den hemliga token som krävs för att konfigurera automatisk användaretablering med Microsoft Entra-ID genom att navigera till Smartsheet-portalen och sedan navigera till Kontoappar > och Integreringar.

  6. Välj API-åtkomst. Klicka på Generera ny åtkomsttoken.

    Skärmbild av dialogrutan Personlig Inställningar med alternativen API Access och Generate new access token (Generera ny åtkomsttoken).

  7. Definiera namnet på API-åtkomsttoken. Klicka på OK.

    Skärmbild av steg 1 av 2: Generera API-åtkomsttoken med alternativet OK framhävt.

  8. Kopiera API-åtkomsttoken och spara den eftersom det är den enda gången du kan visa den. Detta krävs i fältet Hemlig token i Microsoft Entra-ID.

    Smartsheet-token

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

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

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. 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 endast ska etableras 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.

  • För att säkerställa paritet i användarrolltilldelningar mellan Smartsheet och Microsoft Entra-ID rekommenderar vi att du använder samma rolltilldelningar som fylls i i den fullständiga Smartsheet-användarlistan. Om du vill hämta den här användarlistan från Smartsheet går du till Kontoadministratör > Användarhantering > Fler åtgärder > Ladda ned användarlista (csv).

  • För att få åtkomst till vissa funktioner i appen kräver Smartsheet att en användare har flera roller. Om du vill veta mer om användartyper och behörigheter i Smartsheet går du till Användartyper och Behörigheter.

  • Om en användare har flera roller tilldelade i Smartsheet måste du se till att dessa rolltilldelningar replikeras i Microsoft Entra-ID för att undvika ett scenario där användare kan förlora åtkomsten till Smartsheet-objekt permanent. Varje unik roll i Smartsheet MÅSTE tilldelas till en annan grupp i Microsoft Entra-ID. Användaren MÅSTE sedan läggas till i var och en av de grupper som motsvarar önskade roller.

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

Steg 5: Konfigurera automatisk användaretablering till Smartsheet

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

Så här konfigurerar du automatisk användaretablering för Smartsheet 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 Smartsheet.

    Skärmbild av länken Smartsheet i programlistan.

  4. Välj fliken Etablering.

    Skärmbild av alternativen Hantera med alternativet Etablering framhävt.

  5. Ange Etableringsläge som Automatiskt.

    Skärmbild av listrutan Etableringsläge med alternativet Automatiskt framhävt.

  6. Under avsnittet Administratörsautentiseringsuppgifter anger du scim 2.0-bas-URL:en https://scim.smartsheet.com/v2 för och värdet för åtkomsttoken som hämtades tidigare från Smartsheet i hemlig token. Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till Smartsheet. Om anslutningen misslyckas kontrollerar du att ditt Smartsheet-konto har SysAdmin-behörigheter 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 och markerar kryssrutan – Skicka ett e-postmeddelande när ett fel inträffar.

    Skärmbild av e-postavisering.

  8. Klicka på Spara.

  9. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Smartsheet.

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Smartsheet i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Smartsheet för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering
    userName String
    aktiv Booleskt
    rubrik String
    name.givenName String
    name.familyName String
    phoneNumbers[type eq "work"].value String
    phoneNumbers[type eq "mobile"].value String
    phoneNumbers[type eq "fax"].value String
    emails[type eq "work"].value String
    externalId String
    roller String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager String
  11. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

  12. Om du vill aktivera Microsoft Entra-etableringstjänsten för Smartsheet ändrar du etableringsstatusen till i avsnittet Inställningar.

    Skärmbild av aktiverad etableringsstatus.

  13. Definiera de användare och/eller grupper som du vill etablera till Smartsheet 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 klickar du på Spara.

    Skärmbild av hur du sparar etableringskonfigurationen.

Den här åtgärden startar den inledande synkroniseringen av alla användare och/eller grupper som definierats i omfånget i avsnittet Inställningar. Den inledande synkroniseringen tar längre tid att utföra än efterföljande synkroniseringar, som sker 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 till att övervaka distributionen:

  • Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har 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. Läs mer om karantänstatus här.

Anslut eller begränsningar

  • Smartsheet stöder inte mjuk borttagning. När en användares aktiva attribut är inställt på Falskt tar Smartsheet bort användaren permanent.

Ändringslogg

  • 2020-06-16 – Stöd för enterprise-tilläggsattributen "Cost Center", "Division", "Manager" och "Department" har lagts till för användare.
  • 02/10/2021 – Stöd för grundläggande attribut har lagts till för "e-postmeddelanden[skriv eq "arbete"]" för användare.
  • 2022-02-12 – SCIM-bas-/klientorganisations-URL har https://scim.smartsheet.com/v2 lagts till för SmartSheet-integrering under avsnittet Administratörsautentiseringsuppgifter.

Ytterligare resurser

Nästa steg