Jostle instellen voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in Jostle en Microsoft Entra ID voor het configureren van automatische voorziening van gebruikers. Wanneer geconfigureerd, richt Microsoft Entra ID automatisch gebruikers en groepen in en maakt deze ongedaan bij Jostle met behulp van de Microsoft Entra inrichtingsservice. Raadpleeg Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID voor belangrijke informatie over wat deze service doet, hoe deze werkt, en veelgestelde vragen.

Ondersteunde mogelijkheden

  • Gebruikers maken in Jostle
  • Gebruikers verwijderen in Jostle wanneer ze geen toegang meer nodig hebben
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Jostle
  • Eenmalige aanmelding bij Jostle (aanbevolen)
  • Ondersteuning voor langlevende bearer token-authenticatie.

Vereisten

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

Stap 1: Plan de implementatie van uw voorziening

  1. Leer over hoe de voorzieningenservice werkt.
  2. Bepaal wie binnen de reikwijdte van de voorziening valt.
  3. Bepaal welke gegevens moeten worden gekoppeld tussen Microsoft Entra ID en Jostle.

Stap 2: Jostle configureren ter ondersteuning van inrichting met Microsoft Entra ID

Automatiseringsaccount

Voordat u begint, moet u een Automation-gebruiker maken in uw Jostle-intranet. Dit is het account dat u gaat gebruiken om te configureren met Azure. Automation-gebruikers kunnen worden gemaakt in Beheer Instellingen > Gebruikersaccounts en gegevens > Automation-gebruikers beheren.

Zie dit artikel voor meer informatie over Automation-gebruikers en hoe u er een maakt.

Nadat het Automation-gebruikersaccount moet worden geactiveerd (dat wil zeggen, ten minste één keer moet zijn aangemeld bij uw intranet) voordat het kan worden gebruikt om Azure te configureren.

Inrichting van gebruikers beheren

Voordat u begint, moet u ervoor zorgen dat uw accountabonnement SSO-/gebruikersinrichtingsfuncties bevat. Als dat niet het probleem is, kunt u contact opnemen met uw Customer Success Manager success@jostle.me en kan deze u helpen de functies toe te voegen aan uw account.

De volgende stap is het verkrijgen van de API-URL en API-sleutel van Jostle:

  1. Ga naar de hoofdnavigatie en selecteer Beheerinstellingen.

  2. Selecteer onder Gebruikersgegevens naar/van andere systemende optie Gebruikersinrichting beheren . Als u 'Gebruikersinrichting beheren' hier niet ziet en hebt gecontroleerd of uw account SSO-/gebruikersinrichting bevat, neemt u contact op met Ondersteuning support@jostle.me om deze pagina in uw beheerinstellingen in te schakelen).

  3. Ga in de sectie Api-details van gebruikersinrichting naar het veld Uw basis-URL , selecteer de knop Kopiëren en sla de URL ergens op waar u deze later gemakkelijk kunt openen.

    Schermopname van de gebruikersvoorziening-API-details.

  4. Selecteer vervolgens de nieuwe sleutel toevoegen... knoop

  5. Ga in het volgende scherm naar het veld Automation-gebruiker en gebruik de vervolgkeuzelijst om uw Automation-gebruikersaccount te selecteren.

    Schermopname van Integratieaccount.

  6. Geef in het veld Provisioning API-sleutelbeschrijving uw sleutel een naam (zoals Azure) en selecteer vervolgens de knop Toevoegen.

  7. Zodra uw sleutel is gegenereerd, moet u deze meteen kopiëren en opslaan waar u uw URL hebt opgeslagen (omdat deze de enige keer is dat uw sleutel wordt weergegeven).

  8. Vervolgens gebruikt u de API-URL en API-sleutel om de integratie in Azure te configureren.

Voeg Jostle toe vanuit de Microsoft Entra-applicatiegalerij om te beginnen met het inrichten voor Jostle. Als u Jostle eerder hebt ingesteld voor SSO, kunt u dezelfde toepassing gebruiken. Het is echter raadzaam een afzonderlijke app te maken wanneer u de integratie voor het eerst test. Klik hier voor meer informatie over het toevoegen van een toepassing uit de galerie.

Stap 4: Bepaal wie binnen de scope van voorzieningen 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 5: Automatische gebruikersvoorziening configureren naar Jostle

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra inrichtingsservice om gebruikers en groepen in de Jostle-app te maken, bij te werken en uit te schakelen op basis van gebruikers- en groepstoewijzingen in Microsoft Entra ID.

Notitie

Zie User-Provisioning-Azure-Integration voor meer informatie over automatische gebruikersinrichting voor Jostle.

Automatische gebruikersinrichting configureren voor Jostle in Microsoft Entra ID:

  1. Meld u aan bij de Microsoft Entra-beheercentrum als ten minste een Cloud-toepassingsbeheerder.

  2. Blader naar Entra ID>Enterprise apps

    Schermopname van het tabblad Enterprise-applicaties.

  3. Selecteer Jostle in de lijst met toepassingen.

    Schermopname van de koppeling Jostle in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten en selecteer Aan de slag.

    Schermopname van het tabblad Inrichten.

  5. Selecteer + Nieuwe configuratie.

    Schermopname van het tabblad Inrichten automatisch.

  6. Voer in het veld Tenant-URL uw Jostle-tenant-URL en geheimtoken in. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Jostle. Als de verbinding mislukt, controleert u of uw Jostle-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

    Schermopname van de voorzieningstestverbinding.

  7. Selecteer Maken om uw configuratie te maken.

  8. Selecteer Eigenschappen op de pagina Overzicht .

  9. Voer in het veld E-mailmelding het e-mailadres in van een persoon die de meldingen over inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt .

    Schermopname van provisioning-instellingen.

  10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

  11. Controleer in de sectie Attribute-Mapping de gebruikerskenmerken die vanuit Microsoft Entra ID met Jostle worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Jostle te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Jostle-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Typologie Ondersteund voor filteren
    gebruikersnaam Snaar / Touwtje ✓
    actief Booleaans
    naam.gegevenNaam Snaar / Touwtje
    naam.achternaam Snaar / Touwtje
    emails[type gelijk aan "work"].waarde Snaar / Touwtje
    emails[type eq "persoonlijk"].value Snaar / Touwtje
    emails[type eq "alternate1"].value Snaar / Touwtje
    emails[type eq "alternate2"].value Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail1Label Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail2Label Snaar / Touwtje
    DisplayName Snaar / Touwtje
    ExternalIdentifier Snaar / Touwtje
    Title Snaar / Touwtje
    Bijnaam Snaar / Touwtje
    Gebruikerstype Snaar / Touwtje
    Geboortedatum Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomBadge Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomFilterCategory Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomProfile Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:JoinDate Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Locations Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:LoginType Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:PersonalPronouns Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Country Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Locality Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1PostalCode Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1StreetAddress Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Region Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Country Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Locality Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2PostalCode Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2StreetAddress Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Region Snaar / Touwtje
    phoneNumbers[type eq "workofficephone"].value Snaar / Touwtje
    phoneNumbers[type eq "homephone"].value Snaar / Touwtje
    phoneNumbers[type eq "workmobilephone"].value Snaar / Touwtje
    phoneNumbers[type eq "personalmobilephone"].value Snaar / Touwtje

  12. Als u bereikfilters wilt configureren, raadpleegt u de instructies in het artikel Bereikfilter.

  13. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

  14. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie controleren

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. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
  3. Als de implementatieconfiguratie in een ongezonde staat lijkt te verkeren, wordt de toepassing in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Meer middelen

Verwante inhoud

  • Last updated on