Microsoft Koppeling

Automatische synchronisatie van gebruikersgegevens via de Microsoft Graph API.

🔗 Overzicht

De Microsoft koppeling stelt u in staat om automatisch gebruikersgegevens te synchroniseren vanuit uw Microsoft 365 / Azure AD omgeving naar EduDisplay. Dit elimineert handmatig gebruikersbeheer en zorgt voor actuele gegevens.

✅ Voordelen

  • â€ĸ Automatische synchronisatie van gebruikers
  • â€ĸ Ondersteuning voor leerlingen en medewerkers
  • â€ĸ Selectieve groepen synchronisatie
  • â€ĸ Dagelijkse automatische updates
  • â€ĸ Mapping van custom velden (UID)

📋 Vereisten

  • â€ĸ Microsoft 365 / Azure AD tenant
  • â€ĸ Globale beheerder rechten
  • â€ĸ App registratie in Azure AD
  • â€ĸ Graph API permissions
  • â€ĸ UID velden geconfigureerd in AD

💡 Aanbeveling

Deze methode is aanbevolen voor scholen met meer dan 500 gebruikers en een Microsoft 365 / Azure AD omgeving. Voor kleine scholen kan een CSV import eenvoudiger zijn.

⚙ī¸ Tenant configuratie

Stap 1: App registratie in Azure AD

  1. Log in op de Azure Portal
  2. Ga of zoek naarApp registrations
  3. Klik op New registration
  4. Vul de volgende gegevens in:
    • Name: EduDisplay Integration
    • Supported account types: Accounts in this organizational directory only
    • Redirect URI: Laat leeg
  5. Kies Register

Stap 2: API permissies configureren

  1. Ga in de app registratie naar Manage → API permissions
  2. Klik op Add a permission
  3. Selecteer Microsoft Graph → en kies de onderste optie Application permissions
  4. Stel nu volgende permissies in, door ze toe te voegen:
    • Directory.Read.All - Voor directory toegang
    • Group.Read.All - Voor lezen van groepen
    • User.Read.All - Voor lezen van gebruikersgegevens
  5. Kies op Grant admin consent for.. om en keur de permissions goed via (Yes), de status wordt dan groen.

Stap 3: Client secret aanmaken

  1. Ga naar Certificates & secrets
  2. Klik op New client secret
  3. Vul de beschrijving in (bijv. "EduDisplay Secret")
  4. Kies een vervaldatum bij expires in: (aanbevolen: 24 maanden)
  5. Klik op Add
  6. Belangrijk: Kopieer de secret value waarde meteen - deze wordt maar ÊÊn keer getoond!

⚠ī¸ Belangrijk

Bewaar de Application ID, Directory ID en Client Secret value veilig. Deze gegevens zijn nodig voor de configuratie in EduDisplay.
Agendeer waarneer de Client Secret vervalt, en maak tijdig een nieuwe aan.

🔄 Sync instellingen

Configuratie in EduDisplay

  1. Ga naar Zermelo → Gebruikersbeheer in het EduDisplay portal
  2. Klik op Microsoft Koppeling
  3. Vul de volgende gegevens in:
    • Tenant ID: Directory ID uit Azure AD
    • Client ID: Application ID uit Azure AD
    • Client Secret: De secret value die u eerder hebt aangemaakt en gekopieerd
  4. Test de verbinding via Verbinding testen

Sync type selecteren

👨‍🎓 Leerling sync

Synchroniseert leerlingenaccounts.

👨‍đŸĢ Medewerker sync

Synchroniseert personeelsaccounts.

UID veld mapping

Ondersteunde velden:

Extension Attributes:
â€ĸ extensionAttribute1-15
â€ĸ employeeId
â€ĸ employeeNumber
Contact gegevens:
â€ĸ mobilePhone
â€ĸ telephoneNumber
â€ĸ facsimileTelephoneNumber
Organisatie:
â€ĸ department
â€ĸ companyName
â€ĸ jobTitle

💡 Tip: UID configuratie

Zorg ervoor dat het UID veld in uw Active Directory overeenkomt met de UID's op uw schoolpassen/badges. Meestal wordt hiervoor extensionAttribute1 of employeeId voor gebruikt.

⏰ Automatische synchronsatie

Dagelijkse synchronisatie

Instellingen:

  • â€ĸ Auto-sync inschakelen: Ja/Nee toggle
  • â€ĸ Sync tijd: Standaard 11:00 (configureerbaar)
  • â€ĸ Sync frequentie: Dagelijks
  • â€ĸ Groepen filter: Optioneel specifieke groepen

Wat gebeurt er:

  • â€ĸ Nieuwe gebruikers worden toegevoegd
  • â€ĸ Bestaande gebruikers worden bijgewerkt
  • â€ĸ Uitgeschreven gebruikers worden gemarkeerd
  • â€ĸ Synchronisatie log wordt bijgehouden

Handmatige sync

Naast automatische sync kunt u ook handmatig een synchronisatie starten:

  1. Ga naar Gebruikersbeheer → Microsoft Koppeling
  2. Klik op Sync nu starten
  3. Monitor de voortgang in de sync log
  4. Controleer de resultaten na voltooiing

Sync monitoring

Status Betekenis
Success Sync voltooid zonder problemen
Partial Sync voltooid met waarschuwingen
Failed Sync mislukt - controle vereist

🔍 Problemen oplossen

🔌 Verbindingsproblemen

Symptoom: "Authentication failed"

  • Controleer of Client ID en Secret correct zijn
  • Verifieer dat de secret niet verlopen is
  • Check of admin consent is verleend voor alle permissions

Symptoom: "Insufficient privileges"

  • Controleer of alle benodigde Graph API permissions zijn toegekend
  • Verifieer dat admin consent is verleend
  • Check of de app registratie nog actief is

👤 Sync problemen

Symptoom: "Geen gebruikers gevonden"

  • Controleer of de juiste groepen zijn geselecteerd
  • Verifieer dat gebruikers in de geselecteerde groepen zitten
  • Check of sync type (student/teacher) correct is ingesteld

Symptoom: "UID veld leeg"

  • Controleer of het juiste UID veld is geselecteerd
  • Verifieer dat bij gebruikers in de Active Directory het UID veld is ingevuld
  • Check of het veld beschikbaar is via Graph API

🆘 Nog steeds problemen?

Als de bovenstaande oplossingen niet helpen, neem dan contact op met ons:

📧 support@edudisplay.nl