In deze stap configureren we de synctool zodat deze verbinding kan maken met zowel Microsoft Entra ID (voorheen Azure AD) als de Workspace.

Alle gegevens die je in de eerste twee stappen hebt verzameld, kunnen worden ingevuld in de configuratie-interface tool. Je kunt deze tool vinden in de gedownloade Workspace 365 synctool map. Wanneer je de map uitpakt, is de naam van het bestand:

Om de welkomstpagina uit te schakelen, deselecteer het selectievakje onderaan de pagina. Je kunt de standaardtaal wijzigen naar Nederlands of Engels. Klik op Volgende om door te gaan.

Om de Azure AD synctool te verbinden met Microsoft Entra ID, vul je de onderstaande velden in. Klik op Volgende wanneer alle informatie is ingevoerd. Hier wordt de verbinding met de ingevoerde informatie/Microsoft Entra ID gevalideerd.

Om een nieuwe omgeving toe te voegen, vul je de volgende gegevens in en klik je op 'Opslaan' wanneer je klaar bent:

URL van je Workspace-site: dit is de basis-URL van de workspace waar alle omgevingen op gehost worden, meestal 'https://{bedrijfsnaam}.workspace365.net'.

Omgevingsnaam: dit moet exact overeenkomen met de omgevingsnaam in Workspace 365 en kan worden opgehaald uit de Workspace 365 URL, bijvoorbeeld 'https://portal.workspace365.net/john -> john'.

Sync API authenticatietoken: dit moet overeenkomen met de API-sleutel van de Workspace 365 omgeving onder 'Gebruikers & groepen' > 'Gebruikersprovisioning' > API-sleutel (stap 2).

Per ongeluk de verkeerde groep en/of domein opgenomen in de filtering? Geen zorgen! Volg deze stappen:

De overeenkomstige gebruikers worden dan automatisch verwijderd en kunnen niet meer inloggen op Workspace. De verwijderde gebruikers zullen worden weergegeven onder de lijst "verwijderde gebruikers" onder 'Gebruikersbeheer' en worden permanent verwijderd na 30 dagen (deze gebruikers worden natuurlijk niet verwijderd uit Microsoft 365!).

Van gedachten veranderd of een specifieke groep en/of domein toevoegen?

Volg deze stappen:

De overeenkomstige gebruikers worden nu toegevoegd aan de Workspace-omgeving.

Je kunt de gewenste filteropties kiezen. Als je beide opties, domein- en groepsfiltering, niet aanvinkt, worden alle gebruikers en groepen gesynchroniseerd.

Als je domeinfiltering wilt inschakelen, vink dan het selectievakje 'Domeinfiltering inschakelen' aan. Dit zal alle domeinen en subdomeinen binnen het huidige domein tonen.

Je kunt een selectie maken van de gewenste domeinen die je wilt synchroniseren. Alle gebruikers met het geselecteerde domeinvoorvoegsel worden in dit geval gesynchroniseerd:

Niet gesynchroniseerd:

Als je groepsfiltering wilt inschakelen, vink dan het selectievakje 'Groepsfiltering inschakelen' aan. Dit zal alle groepen binnen dit huidige domein tonen.

Let op: We ondersteunen geen geneste groepen.

Hier kun je een selectie maken van de gewenste groepen die je wilt synchroniseren. Alle gebruikers binnen de geselecteerde groep en de groep zelf worden in dit geval gesynchroniseerd:

Niet gesynchroniseerd:

Het is mogelijk om zowel domein- als groepsfiltering te combineren, zoals hieronder weergegeven:
​
​

​

We hebben de volgende Active Directory-structuur:

Als domeinfiltering is ingeschakeld en het volgende is aangevinkt:

Als groepsfiltering is ingeschakeld en het volgende is aangevinkt:

De volgende gebruikers en groepen worden gesynchroniseerd:

Worden niet gesynchroniseerd:

Klik op voorkeuren om het synchronisatie-instellingenmenu te openen.

Je kunt het synchronisatietype instellen op 'Periodiek' of 'Eenmaal per dag'. Als je ervoor kiest om het synchronisatietype op 'Periodiek' in te stellen, moet je het interval in uren en/of minuten definiëren. Als je ervoor kiest om het synchronisatietype op 'Eenmaal per dag' in te stellen, moet je het tijdstip definiëren waarop je de synchronisatie wilt uitvoeren.

Waarom hebben we caching? Caching maakt processen veel sneller. In plaats van elke gebruikersobject vanaf nul te synchroniseren, zal de Azure AD-synctool alleen controleren op wijzigingen, en alleen deze wijzigingen zullen door de synctool worden verwerkt en in de cache worden geschreven. De cache kan worden gezien als het "geheugen" van de synctool. Wanneer je de cache van de synctool wist, wis je eigenlijk het geheugen van de synctool en daarmee de gehele gebruikersgeschiedenis. Helaas kun je de cachegeschiedenis niet inzien.

Wanneer je gebruikerswijzigingen aanbrengt, zoals het toevoegen of verwijderen van gebruikers in Microsoft Entra ID, worden deze wijzigingen in de cache van de synctool geschreven. Dit gebeurt wanneer de synchronisatie vanuit de gebruikers provisioneringsinstellingen in Workspace is ingeschakeld.

Maar wat gebeurt er als je de synchronisatie uitschakelt en handmatige gebruikerswijzigingen aanbrengt in Workspace 365? Bijvoorbeeld, je verwijdert een gebruiker in Workspace uit een groep die wordt gesynchroniseerd terwijl de synchronisatie was uitgeschakeld in Workspace. Als gevolg hiervan zal deze gebruikerswijziging niet in de cache worden geschreven. Met andere woorden, de cache denkt nog steeds dat de gebruiker bestaat in Workspace.

Dus, wat gebeurt er als je een fout hebt gemaakt en diezelfde gebruiker opnieuw wilt toevoegen? Het maakt niet uit of je de gebruiker ook uit de lijst met verwijderde gebruikers hebt verwijderd, de cache denkt nog steeds dat de gebruiker bestaat in Workspace en daarom zal de synctool de gebruiker niet synchroniseren.

Als gebruikers niet worden bijgewerkt of toegevoegd aan specifieke groepen, kan het wissen van de cache dit probleem oplossen. We hebben echter gezien dat het wissen van de cache later tot gebruikersverschillen kan leiden en het kan lang duren om alle gebruikersobjecten te synchroniseren, vooral in grote omgevingen, en dit is over het algemeen te intensief voor de resources.

Wis de cache niet als eerste oplossing! Als je de cache wist, zorg er dan voor dat je de nieuwste versie van de Azure AD-synctool gebruikt. Neem contact op met de supportafdeling als je twijfelt.

Als groepen niet correct worden gesynchroniseerd, probeer dan eerst de filtering uit te schakelen en voer een volledige synchronisatie uit voordat je de cache wist. Wanneer de synchronisatie is voltooid, kun je de filtering opnieuw inschakelen en de geselecteerde groepen synchroniseren.

Cache wissen

Ga verder naar stap 4.