Självstudie: Konfigurera Slack för automatisk användaretablering
Kommentar
Integrering med Slack med ett anpassat/BYOA-program stöds inte. Det finns stöd för att använda galleriprogrammet enligt beskrivningen i den här självstudien. Galleriprogrammet har anpassats för att fungera med Slacks SCIM v1-server.
Målet med den här självstudien är att visa de steg du behöver utföra i Slack och Microsoft Entra-ID för att automatiskt etablera och avetablera användarkonton från Microsoft Entra-ID till Slack. 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 Slack
- Ta bort användare i Slack när de inte behöver någon åtkomst längre
- Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Slack
- Etablera grupper och gruppmedlemskap i Slack
- Enkel inloggning till Slack (rekommenderas)
Förutsättningar
Det scenario som beskrivs i självstudien förutsätter att du redan har följande objekt:
- En Microsoft Entra-klientorganisation.
- En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
- En Slack-klientorganisation med plusplan eller bättre aktiverat.
- Ett användarkonto i Slack med teamadministratörsbehörighet.
Kommentar
Den här integreringen är också tillgänglig för användning från Microsoft Entra US Government Cloud-miljön. Du hittar det här programmet i Microsoft Entra US Government Cloud Application Gallery och konfigurerar det på samma sätt som från det offentliga molnet.
Steg 1: Planera etableringsdistributionen
- Lär dig mer om hur etableringstjänsten fungerar.
- Ta reda på vem som finns i etableringsomfånget.
- Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Slack.
Steg 2: Lägg till Slack från Microsoft Entra-programgalleriet
Lägg till Slack från Microsoft Entra-programgalleriet för att börja hantera etablering till Slack. Om du tidigare har konfigurerat Slack 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 3: 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.
Om du behöver ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.
Steg 4: Konfigurera automatisk användaretablering till Slack
Det här avsnittet vägleder dig genom att ansluta ditt Microsoft Entra-ID till Slacks API för etablering av användarkonton och konfigurera etableringstjänsten för att skapa, uppdatera och inaktivera tilldelade användarkonton i Slack baserat på användar- och grupptilldelning i Microsoft Entra-ID.
Så här konfigurerar du automatisk etablering av användarkonton till Slack i Microsoft Entra-ID:
Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
Bläddra till Identity>Applications Enterprise-program>
Välj Slack i programlistan.
Välj fliken Etablering.
Ange Etableringsläge som Automatiskt.
Under avsnittet Autentiseringsuppgifter för administratör klickar du på Auktorisera. En dialogruta för Slack-auktorisering öppnas i ett nytt webbläsarfönster.
I det nya fönstret loggar du in på Slack med ditt teamadministratörskonto. i dialogrutan för auktorisering väljer du det Slack-team som du vill aktivera etablering för. Välj sedan Auktorisera. När du är klar går du tillbaka till Azure-portalen för att slutföra etableringskonfigurationen.
Välj Testa anslutning för att se till att Microsoft Entra-ID kan ansluta till din Slack-app. Om anslutningen misslyckas kontrollerar du att ditt Slack-konto har teamadministratörsbehörighet och försöker sedan igen.
I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.
Välj Spara.
Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Slack.
I avsnittet Attributmappningar granskar du de användarattribut som ska synkroniseras från Microsoft Entra-ID till Slack. Observera att de attribut som väljs som Matchande egenskaper kommer att användas för att matcha användarkontona i Slack vid uppdateringsåtgärder. Välj knappen Spara för att spara ändringarna.
| Attribut | Typ |
|---|---|
| aktiv | Booleskt |
| externalId | String |
| displayName | String |
| name.familyName | String |
| name.givenName | String |
| rubrik | String |
| emails[type eq "work"].value | String |
| userName | String |
| nickName | String |
| addresses[type eq "untyped"].streetAddress | String |
| addresses[type eq "untyped"].locality | String |
| addresses[type eq "untyped"].region | String |
| addresses[type eq "untyped"].postalCode | String |
| addresses[type eq "untyped"].country | String |
| phoneNumbers[type eq "mobile"].value | String |
| phoneNumbers[type eq "work"].value | String |
| roles[primary eq "True"].value | String |
| nationella inställningar | String |
| name.honorificPrefix | String |
| photos[type eq "photo"].value | String |
| profileUrl | String |
| timezone | String |
| userType | String |
| preferredLanguage | String |
| urn:scim:schemas:extension:enterprise:1.0.department | String |
| urn:scim:schemas:extension:enterprise:1.0.manager | Referens |
| urn:scim:schemas:extension:enterprise:1.0.employeeNumber | String |
| urn:scim:schemas:extension:enterprise:1.0.costCenter | String |
| urn:scim:schemas:extension:enterprise:1.0.organization | String |
| urn:scim:schemas:extension:enterprise:1.0.division | String |
Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till Slack.
I avsnittet Attributmappningar granskar du de gruppattribut som ska synkroniseras från Microsoft Entra-ID till Slack. Observera att de attribut som väljs som Matchande egenskaper kommer att användas för att matcha grupperna i Slack vid uppdateringsåtgärder. Välj knappen Spara för att spara ändringarna.
Attribut Typ displayName String medlemmar Referens Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.
Om du vill aktivera Microsoft Entra-etableringstjänsten för Slack ändrar du etableringsstatusen till På i avsnittet Inställningar
Definiera de användare och/eller grupper som du vill etablera till Slack genom att välja önskade värden i Omfång i avsnittet Inställningar.
När du är redo att etablera klickar du på Spara.
Å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 5: Ö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.
Felsökningstips
När du konfigurerar Slack-attributet displayName bör du vara medveten om följande beteenden:
Värden är inte helt unika (till exempel 2 användare kan ha samma visningsnamn)
Har stöd för icke-engelska tecken, blanksteg och skiftläge.
Tillåtna skiljetecken omfattar punkter, understreck, bindestreck, apostrofer, hakparenteser (till exempel
( [ { } ] )), och avgränsare (till exempel, / ;).displayName-egenskapen får inte innehålla något ”@”-tecken. Om ett ”@” ingår kan det finnas en överhoppad händelse i etableringsloggarna med beskrivningen ”AttributeValidationFailed”.
Uppdateringar görs endast om de här två inställningarna har konfigurerats i Slacks arbetsplats/organisation – Profilsynkronisering har aktiverats och Användarna inte kan ändra sina visningsnamn.
Slacks userName-attribut måste kortare än 21 tecken och ha ett unikt värde.
Slack tillåter endast matchning med attributen userName och email.
Vanliga felkoder dokumenteras i den officiella Slack-dokumentationen – https://api.slack.com/scim#errors
Ändringslogg
- 06/16/2020 – Attributet DisplayName har ändrats till att endast uppdateras när en ny användare skapas.
Ytterligare resurser
- Hantera användarkontoetablering för Enterprise-appar
- Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?