Accounts in applicaties
Entra ID Zoom koppeling: Zoom-gebruikers, licenties en groepen vanuit Microsoft Entra ID
Met een koppeling tussen Microsoft Entra ID en Zoom Workplace krijgt elke collega die aan Zoom is toegewezen automatisch een Zoom-gebruiker met het juiste accounttype, en wordt die gedeactiveerd zodra de toewijzing of het account vervalt. KoppelHet zet daarbij ook Zoom-groepen, manager en kostenplaats, een bijgewerkte weergavenaam en een ontvanger voor de opnames van vertrekkers.
Wat de koppeling doet
Organisaties die Zoom-gebruikers vanuit Entra ID aanmaken, houden Zoom-groepen vaak met de hand bij. Instellingen per groep, zoals opnemen in de cloud, lopen dan achter, een getrouwde collega houdt in vergaderingen haar oude naam, en de opnames van een vertrekker raken zoek.
- IT wijst gebruikers en groepen in Entra ID toe aan Zoom; Entra ID maakt de gebruikers aan.
- KoppelHet zet de Entra-groepen die jullie aanwijzen om naar Zoom-groepen, met hetzelfde lidmaatschap.
- KoppelHet vult afdeling, kostenplaats, personeelsnummer en manager aan, en zet de weergavenaam na elke naamswijziging opnieuw.
- Vóór het deactiveren zet KoppelHet de manager als ontvanger van de opnames en vergaderingen.
- Daarna deactiveert Entra ID de Zoom-gebruiker.
Waar je op let bij Microsoft Entra ID en Zoom Workplace
- Zoom gebruikt groepen juist voor instellingen zoals opnemen en webinars. KoppelHet zet de aangewezen Entra-groepen via de SCIM2-API van Zoom om naar Zoom-groepen en houdt de leden gelijk.
- Zoom past de weergavenaam niet aan als alleen voor- of achternaam verandert. Een nieuwe achternaam in Entra ID komt zo niet in vergaderingen terecht. KoppelHet stuurt displayName mee bij elke naamswijziging.
- Zoom verwacht de manager als e-mailadres, terwijl Entra ID de manager als verwijzing naar een andere gebruiker bewaart. KoppelHet zoekt via Microsoft Graph het e-mailadres van de manager op en zet dat in Zoom, en ook als ontvanger van de opnames en vergaderingen bij vertrek.
- Het accounttype Collaboration werkt volgens Zoom niet met Entra ID door een beperking aan de kant van Microsoft. Organisaties die dat type gebruiken, laten KoppelHet het accounttype zetten.
- Zoom ondersteunt geen Bearer-authenticatie meer. KoppelHet gebruikt een eigen server-to-server-app met de scope scim2:admin, die niet aan een persoon hangt, zodat het vertrek van een Zoom-beheerder de koppeling niet stillegt.
- Bij provisioning vanuit Entra ID geldt een maximum van 9.999 Basic-gebruikers in Zoom. Wie iedereen in Entra ID standaard aan Zoom toewijst, kan daar in een grotere organisatie tegenaan lopen. KoppelHet beperkt de toewijzing tot de groepen die Zoom echt nodig hebben en meldt het als het aantal in de buurt komt.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Welk Zoom-abonnement is nodig?
Voor de SCIM2-API die KoppelHet gebruikt een Business- of Education-account met goedgekeurde vanity URL en single sign-on.
Krijgen vertrekkers een melding van Zoom?
De koppeling stuurt zelf niets. Wat Zoom bij deactiveren laat zien, hangt af van de instellingen van jullie account.
Gaan Zoom Phone-nummers ook mee?
Niet in de eerste versie. Nummers toewijzen of terugschrijven naar Entra ID kan later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Entra ID schrijft via provisioning naar https://api.zoom.us/scim met OAuth2 Authorization Code Grant; standaardattributen userName (verplicht en filterbaar), active, name.givenName, name.familyName, emails work, enterprise department en userType.
- KoppelHet leest Entra ID via Microsoft Graph (delta op users en groups, manager met $expand) met alleen leesrechten, en schrijft naar de Zoom SCIM2 API (https://api.zoom.us/scim2, scope scim2:admin): PUT /Users/{userId} met displayName, de enterprise-extensie (department, costCenter, employeeNumber, manager) en transferee; POST en PATCH /Groups voor groepen en leden. De standaardgroep van het account kan niet weg; HTTP 429 bij te veel aanroepen.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Microsoft Entra ID | Veld in Zoom Workplace | Toelichting |
|---|---|---|
userPrincipalName | userName | |
mail | emails[type eq "work"] | |
givenName en surname | name.givenName en name.familyName | |
displayName | displayName | Door KoppelHet, ook na naamswijzigingen |
Groep of attribuut voor de licentie | userType (Basic of Licensed) | |
department | enterprise.department | |
employeeOrgData.costCenter | enterprise.costCenter | |
employeeId | enterprise.employeeNumber | |
manager (mail) | enterprise.manager en transferee | Zoom wil het e-mailadres van de manager |
Toegewezen Entra-groepen | Groups (displayName, members) | |
accountEnabled en toewijzing | active |
Gerelateerd
ADP GlobalView → Microsoft Entra ID
ADP GlobalView Entra ID koppeling: accounts per land uit de internationale payroll
ADP iHCM → Microsoft Entra ID
ADP iHCM Entra ID koppeling: accounts uit de ADP-payroll, in elk Europees land met de juiste licentie
ADP Workforce Now → Microsoft Entra ID
ADP Workforce Now Entra ID koppeling: Microsoft-accounts uit ADP, met het werkadres terug in ADP
AFAS Profit → Microsoft Entra ID
AFAS koppelen met Microsoft Entra ID