Colloquial configureren voor automatische voorziening van gebruikers met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Colloquial als Microsoft Entra ID voor het configureren van automatische gebruikersprovisioning. Controleer voordat u begint de vereisten om ervoor te zorgen dat uw omgeving gereed is. Wanneer het systeem is geconfigureerd, worden gebruikers automatisch ingericht en ongedaan gemaakt door de Microsoft Entra-inrichtingsservice naar Colloquial. Voor belangrijke informatie over wat de Microsoft Entra provisioningservice doet, hoe deze werkt en voor veelgestelde vragen, zie Gebruikersprovisioning en -deprovisioning voor SaaS-toepassingen automatiseren met Microsoft Entra ID.

Ondersteunde mogelijkheden

Colloquial ondersteunt de volgende inrichtings- en toegangsmogelijkheden:

Vereiste voorwaarden

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

• Een Microsoft Entra-tenant
• Een van de volgende rollen: Toepassingsbeheerder, Cloudtoepassingsbeheerder of Toepassingseigenaar.
• Een gebruikersaccount in Colloquial met beheerdersmachtigingen.

Stap 1: Plan uw implementatie van voorzieningen

Voordat u het inrichten configureert, moet u de volgende planningstaken uitvoeren:

• Lees meer over hoe de provisioneringsservice werkt.
• Bepaal wie binnen het toepassingsgebied van valt voor de voorziening van.
• Bepaal welke gegevens moeten worden afgestemd tussen Microsoft Entra ID en Colloquial.

Stap 2: Colloquial configureren ter ondersteuning van inrichting met Microsoft Entra-id

Neem contact op met Colloquial ondersteuning om Colloquial te configureren voor ondersteuning van voorziening met Microsoft Entra ID.

Stap 3: Colloquial toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Voeg Colloquial toe vanuit de Microsoft Entra-toepassingen galerij om de provisioning van Colloquial te beheren. Als u eerder de Colloquial-bedrijfstoepassing voor SSO hebt ingesteld, kunt u die bedrijfstoepassing gebruiken. Het is echter raadzaam een afzonderlijke app te maken wanneer u de integratie voor het eerst test. Meer informatie over het toevoegen van een toepassing vanuit de galerie.

Stap 4: Bepaal wie binnen de scope van voorzieningen valt.

Gebruik de volgende stappen om te bepalen welke gebruikers en groepen onder de provisioning vallen:

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 toe te wijzen aan de app. 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 gebruikersinrichting configureren voor Colloquial

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice voor het maken, bijwerken en uitschakelen van gebruikers in Colloquial op basis van gebruikerstoewijzingen in Microsoft Entra-id.

Automatische gebruikersvoorziening configureren voor Colloquial 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

   

3. Selecteer Colloquial in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Selecteer + Nieuwe configuratie.

   

6. Voer in het veld Tenant-URL uw Colloquial Tenant-URL en Geheime Token in. Selecteer Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Colloquial. Als de verbinding mislukt, controleert u of uw Colloquial-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

   

7. Selecteer Maken om uw configuratie te maken.

8. Selecteer Eigenschappen op de pagina Overzicht .

9. Selecteer het pictogram Bewerken om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantainemeldingen te ontvangen. Schakel preventie van onbedoelde verwijderingen in. Selecteer Toepassen om de wijzigingen op te slaan.

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

    

11. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

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

    Kenmerk	Typ	Ondersteund voor filteren	Vereist door de omgangstaal
    gebruikersnaam	Touwtje	✓	✓
    actief	Booleaan		✓
    emails[type gelijk aan "work"].waarde	Touwtje		✓
    voorkeurstaal	Touwtje
    naam.gegevenNaam	Touwtje		✓
    naam.familienaam	Touwtje		✓
    externId	Touwtje
    locatie	Touwtje
    tijdzone	Touwtje

13. Als u bereikfilters wilt configureren, raadpleegt u de instructies in Bereikfilters definiëren voor het inrichten van gebruikersaccounts.

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

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

Stap 6: Uw implementatie bewaken

Nadat u provisioning hebt ingeschakeld, kunt u de volgende aanwijzingen gebruiken om de uitrol te 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. 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.

Aanvullende bronnen

• Het inrichten van gebruikersaccounts voor enterprise-apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over de inrichtingsactiviteit