Delen via


Gebruikersinrichting in Slack automatiseren met Microsoft Entra-id

Notitie

Integratie met Slack met een aangepaste/BYOA-toepassing wordt niet ondersteund. Het gebruik van de galerietoepassing zoals beschreven in dit artikel wordt ondersteund. De galerietoepassing is aangepast om te werken met de SCIM v1-server van Slack.

Het doel van dit artikel is om u te laten zien welke stappen u moet uitvoeren in Slack en Microsoft Entra ID om gebruikersaccounts automatisch in te richten en de inrichting van gebruikersaccounts ongedaan te maken van Microsoft Entra ID naar Slack. Voor belangrijke informatie over wat deze service doet, hoe deze werkt, en de veelgestelde vragen, raadpleeg Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Slack
  • Gebruikers verwijderen in Slack wanneer ze geen toegang meer nodig hebben
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Slack
  • Groepen en groepslidmaatschappen inrichten in Slack
  • Eenmalige aanmelding bij Slack (aanbevolen)

Vereisten

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al de volgende items hebt:

Notitie

Deze integratie is ook beschikbaar voor gebruik vanuit de Microsoft Entra US Government Cloud-omgeving. U vindt deze toepassing in de Microsoft Entra US Government Cloud Application Gallery en configureert deze op dezelfde manier als vanuit de openbare cloud.

Stap 1: Het plannen van uw voorzieningsimplementatie

  1. Leer hoe de voorzieningenservice werkt.
  2. Bepaal wie binnen het toepassingsgebied van valt voor de voorziening van.
  3. Bepaal welke gegevens moeten worden gemapt tussen Microsoft Entra ID en Slack.

Voeg Slack toe vanuit de galerie met Microsoft Entra-toepassingen om te beginnen met het inrichten voor Slack. Als u Slack eerder hebt ingesteld voor eenmalige aanmelding, kunt u dezelfde toepassing gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Klik hier voor meer informatie over het toevoegen van een toepassing uit de galerie.

Stap 3: Definiƫren wie binnen het bereik voor verstrekking valt

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfiltergebruiken.

  • Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen aan de app toe te wijzen. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

  • Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 4: Automatische gebruikersinrichting configureren voor Slack

In deze sectie wordt u begeleid bij het verbinden van uw Microsoft Entra-id met de api voor het inrichten van gebruikersaccounts van Slack en het configureren van de inrichtingsservice voor het maken, bijwerken en uitschakelen van toegewezen gebruikersaccounts in Slack op basis van gebruikers- en groepstoewijzing in Microsoft Entra ID.

Automatische voorziening van gebruikersaccounts configureren voor Slack in Microsoft Entra ID

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.

  2. Navigeer naar Entra ID>Enterprise apps

    De blade Bedrijfstoepassingen

  3. Selecteer in de lijst met toepassingen de optie Slack.

    De Slack-koppeling in de lijst met toepassingen

  4. Selecteer het tabblad Inrichten.

    Schermopname van de opties onder Beheren met de optie Inrichten gemarkeerd.

  5. Stel Inrichtingsmodus in op Automatisch.

    Schermopname van de vervolgkeuzelijst Inrichtingsmodus waarin de optie Automatisch is gemarkeerd.

  6. Selecteer Autoriserenin de sectie Beheerdersreferenties. Hiermee opent u een Slack-autorisatievenster in een nieuw browservenster.

    Screenshot toont de knop 'Beheerdersreferenties Autoriseren'.

  7. Meld u in het nieuwe venster aan bij Slack met het beheerdersaccount van uw team. Selecteer in het resulterende autorisatievenster het Slack-team waarvoor u het inrichten wilt inschakelen en selecteer vervolgens Autoriseren. Ga daarna terug naar de Azure-portal om de configuratie van de voorziening te voltooien.

    Autorisatiedialoogvenster

  8. Selecteer Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met uw Slack-app. Als de verbinding mislukt, moet u controleren of uw Slack-account teambeheerdersmachtigingen heeft en probeer de stap Autoriseren nogmaals.

  9. Voer in het veld E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen en schakel het selectievakje Een e-mailmelding verzenden als een fout optreedt in.

    E-mailmelding

  10. Selecteer Opslaan.

  11. In de sectie Toewijzingen, selecteer Microsoft Entra-gebruikers synchroniseren met Slack.

  12. Controleer in de sectie Kenmerktoewijzingen de gebruikerskenmerken die vanuit Microsoft Entra-id met Slack worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Slack te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

Kenmerk Typ
actief Booleaans
externId Snaar / Touwtje
weergavenaam Snaar / Touwtje
naam.achternaam Snaar / Touwtje
naam.voornaam Snaar / Touwtje
titel Snaar / Touwtje
emails[type gelijk aan "work"].waarde Snaar / Touwtje
gebruikersnaam Snaar / Touwtje
bijnaam Snaar / Touwtje
adressen[type eq "ongedefinieerd"].straatAdres Snaar / Touwtje
addresses[type eq "ongedefinieerd"].locality Snaar / Touwtje
adressen[type eq "ongedefinieerd"].regio Snaar / Touwtje
addresses[type eq "untyped"].postalCode Snaar / Touwtje
adressen[type eq "niet getypt"].land Snaar / Touwtje
telefoonnummers[type gelijk aan "mobiel"].waarde Snaar / Touwtje
telefoonNummers[type gelijk aan "werk"].waarde Snaar / Touwtje
roles[primary eq "Waar"].value Snaar / Touwtje
landinstellingen Snaar / Touwtje
naam.eerbetitelPrefix Snaar / Touwtje
foto's[type gelijk aan "foto"].waarde Snaar / Touwtje
profiel-URL Snaar / Touwtje
tijdzone Snaar / Touwtje
gebruikerstype Snaar / Touwtje
voorkeurstaal Snaar / Touwtje
urn:scim:schemas:extension:enterprise:1.0.departemeent Snaar / Touwtje
urn:scim:schemas:extension:enterprise:1.0.manager Verwijzing
urn:scim:schemas:extension:enterprise:1.0.medewerkersnummer Snaar / Touwtje
urn:scim:schemas:extension:enterprise:1.0.costCenter Snaar / Touwtje
urn:scim:schemas:extension:enterprise:1.0.organization Snaar / Touwtje
urn:scim:schemas:extension:enterprise:1.0.division Snaar / Touwtje
  1. Onder de sectie Toewijzingen selecteer Microsoft Entra-groepen synchroniseren met Slack.

  2. Controleer in de sectie Kenmerktoewijzingen de groepskenmerken die zijn gesynchroniseerd vanuit Microsoft Entra-id naar Slack. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Slack te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Typ
    weergavenaam Snaar / Touwtje
    leden Verwijzing
  3. Raadpleeg artikel over bereikfiltersvoor de volgende instructies om bereikfilters te configureren.

  4. Als u de Microsoft Entra-inrichtingsservice voor Slack wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen

    Inrichtingsstatus ingeschakeld

  5. Definieer de gebruikers en/of groepen die u aan Slack wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen te kiezen.

    Provisioneringsomvang

  6. Selecteer Opslaan als u klaar bent om te configureren.

    Inrichtingsconfiguratie opslaan

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd onder Bereik in de sectie Instellingen. De eerste cyclus duurt langer dan volgende cycli, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

Stap 5: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

  1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
  2. Bekijk de status van de voortgangsbalk om te zien hoe ver de voorzieningscyclus is gevorderd en wanneer deze voltooid zal zijn.
  3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Tips voor probleemoplossing

  • Houd rekening met het volgende gedrag bij het configureren van het kenmerk displayName van Slack:

    • Waarden zijn niet helemaal uniek (zoals twee gebruikers kunnen dezelfde weergavenaam hebben)

    • Ondersteunt niet-Engelse tekens, spaties en hoofdlettergebruik.

    • Toegestane interpunctie omvat perioden, onderstrepingstekens, afbreekstreepjes, apostrofs, haakjes (bijvoorbeeld ( [ { } ] )) en scheidingstekens (bijvoorbeeld , / ;).

    • de eigenschap displayName mag geen @-teken hebben. Als een '@' is opgenomen, vindt u mogelijk een overgeslagen gebeurtenis in de inrichtingslogboeken met de beschrijving "AttributeValidationFailed."

    • Alleen updates als deze twee instellingen zijn geconfigureerd in de werkplek/organisatie van Slack: profielsynchronisatie is ingeschakeld en gebruikers kunnen hun weergavenaam niet wijzigen.

  • Het kenmerk userName van Slack moet korter zijn dan 21 tekens en de waarde ervan moet uniek zijn.

  • In Slack is alleen matching met de kenmerken userName en email toegestaan.

  • Veelvoorkomende foutcodes worden beschreven in de officiĆ«le Slack-documentatie - https://api.slack.com/scim#errors

Wijzigingenlogboek

  • 06/16/2020: het kenmerk displayName kan alleen worden gewijzigd tijdens het maken van een nieuwe gebruiker.

Meer middelen