> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/nl/beheerdershoek/account-and-endpoint-management/scim-guide.md). # SCIM-veldgids voor Entra ID en Okta Een gids voor het maken van aangepaste SCIM-toewijzingen tussen Entra ID of Okta en Zoom ## Overzicht De SCIM2 API van Zoom biedt toegang tot een uitgebreide catalogus van gebruikerattributen die licenties, productrechten, rollen, regio's en service-specifieke configuratie regelen. De standaard provisioning-integraties voor zowel Microsoft Entra ID als Okta mappen slechts een kleine subset hiervan — genoeg om gebruikers aan te maken, bij te werken en te deactiveren, maar niet genoeg om Zoom Phone-sites, contactcenterpakketten, Revenue Accelerator-rollen of een van de tientallen andere attributen te provisionen die Zoom ondersteunt. Deze handleiding leert de herhaalbare methode voor het toevoegen van *elk* Zoom SCIM-attribuut aan uw provisioningconfiguratie. In plaats van één attribuut op zichzelf te documenteren, legt het het onderliggende model uit zodat beheerders een attribuut kunnen opzoeken in de SCIM2 API-referentie van Zoom en het onafhankelijk kunnen Configureer, zonder te wachten tot er een productspecifiek artikel wordt gepubliceerd. ### Hoe u deze handleiding gebruikt Lees de Inleiding, te beginnen met [**SCIM-attributen begrijpen**](#understanding-scim-attributes) eerst, samen met de secties die erop volgen — vereisten, directorygegevens, referentiescenario's en Verificatie aan Zoom-zijde. Deze gelden ongeacht welke identiteitsprovider (IdP) u gebruikt. Werk daarna de Microsoft Entra ID- of Okta-sectie door, afhankelijk van welke u gebruikt. Elk van die delen is volledig, vanaf de eerste configuratiestap tot en met Verificatie en uitgewerkte voorbeelden; u hoeft niet tussen de onderdelen te schakelen. Raadpleeg voor de fundamentele SSO- en SCIM-concepten waarop deze handleiding is gebaseerd de [SSO-gids](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), de [Zoom SSO- en provisioningartikel voor Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), en de [Zoom SSO-artikel voor Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256). {% hint style="danger" %} **Waarschuwing** Verkeerd geconfigureerde provisioning heeft invloed op bestaande gebruikers, inclusief het verwijderen van licenties die al in gebruik zijn. Valideer elke Wijzigen met een enkele testgebruiker voordat u deze toepast op een live populatie. {% endhint %} ### **Vereisten voor het gebruik van SCIM** Alles in dit deel is van toepassing, ongeacht de identiteitsprovider. Lees dit voordat u doorgaat naar uw instructies die specifiek zijn voor de identiteitsprovider. #### Vereisten die voor beide identiteitsproviders gelden * Zakelijk, Onderwijs- of Onderneming Zoom-account met een goedgekeurde [vanity-URL](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540) * Zoom accounteigenaar of beheerdersrechten * [Single Sign-On](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) ingeschakeld op het Zoom-account * Een [geverifieerd gekoppeld domein](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) op het Zoom-account, overeenkomend met het E-maildomein van de gebruikers die worden ingericht * SCIM-provisioning is al ingesteld tussen de identiteitsprovider en Zoom * Het Zoom-licentie-, abonnements-, Add-on(s)- of configuratieobject dat wordt toegewezen, moet al bestaan en Beschikbaar zijn op het Zoom-account. Identiteitsprovider-specifieke vereisten worden aan het begin van elke respectieve sectie vermeld. #### Beperkingen die gemeenschappelijk zijn voor beide identiteitsproviders * SCIM wijst alleen bestaande rechten toe; het kan de objecten waarnaar het verwijst niet aanmaken. Zie het gedeelte [**Voordat u geavanceerde toewijzing probeert, moeten objecten aan de Zoom-kant bestaan voordat SCIM ernaar kan verwijzen**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) hieronder. * Sommige kenmerken accepteren slechts één waarde per gebruiker. Een belabonnement voor Zoom Phone is een voorbeeld — Add-on(s)-pakketten zoals het Customer Engagement Pack kunnen niet via SCIM worden ingericht. * De `gebruikerstype` attribuut is door Zoom gedocumenteerd als gepland voor uitfasering. ## **Introductie** ### **SCIM-attributen begrijpen** Beheerders die begrijpen hoe een Zoom SCIM-attribuut is opgebouwd, kunnen elk attribuut Configureer dat Zoom ondersteunt. Beheerders die een recept volgen, kunnen alleen het attribuut Configureer dat dat recept beschrijft. Dit gedeelte behandelt de opbouw. Het toewijzen van een attribuut aan een gegevensbron komt later aan bod, in de secties over identiteitsproviders. #### Elk attribuut heeft een naamruimte, een naam, een gegevenstype en een toegestane waarde Laten we beginnen met een compleet, werkend voorbeeld. Hier is de Identificatie voor het toewijzen van een gebruiker aan een Zoom Phone-locatie: ``` urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSite ``` Vier eigenschappen van dit attribuut zijn van toepassing. Twee daarvan zijn zichtbaar in de regel hierboven. De andere twee komen uit de API-referentie en worden later elders in uw identiteitsprovider ingevoerd. Voor onze directe doeleinden richten we ons op twee: de **Naamruimte** en de **Naam**.
EigenschapGeëxtraheerd uit het voorbeeldWat het doet
Naamruimteurn:ietf:params:scim:schemas:extension:zoom:1.0:GebruikerGeeft aan Zoom aan tot welk schema de instelling behoort, en dient als gedeelde basis voor bijna elk Zoom-product- en licentieattribuut. Aan Zoom doorgegeven als de eerste helft van de Identificatie.
NaamzoomPhoneLocatieIdentificeert de specifieke Zoom-instelling die wordt geschreven — hier de Zoom Phone-locatie van de gebruiker. Aan Zoom doorgegeven als de tweede helft van de Identificatie. Hoofdlettergevoelig.
GegevenstypetekenreeksGeeft aan uw identiteitsprovider aan welk type waarde het attribuut bevat, zodat het correct wordt opgeslagen en opgemaakt. Niet doorgegeven als onderdeel van de Identificatie; afzonderlijk gedeclareerd als Type in Entra ID, of Gegevenstype in Okta.
Toegestane waardeLON-01, een Zoom Phone-locatienaamDe instelling die daadwerkelijk op de gebruiker wordt toegepast. Vrije tekst voor sommige attributen, een vaste set voor andere — Essentials, Premium, of Elite bijvoorbeeld voor Zoom contactcenter. Aan Zoom doorgegeven op het moment van provisioning, geleverd via de mapping in plaats van via de Identificatie.
{% hint style="danger" %} **Waarschuwing** Zoom publiceert meer dan één namespace voor gebruikersextensies. Productconfiguratie- en licentieattributen gebruiken `urn:ietf:params:scim:schemas:extension:zoom:1.0:Gebruiker`, wat de namespace is die deze handleiding overal gebruikt. Standaard Ondernemingsvelden zoals `department`, `manager`, en `kostenplaats` gebruik `urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker`. Een derde, `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`, bevat aanmeldingstype-informatie die wordt geretourneerd in API-reacties in plaats van tijdens provisioning geconfigureerd. Een attribuut dat op de verkeerde namespace is gebouwd, wordt geaccepteerd door uw identiteitsprovider en stilzwijgend genegeerd door Zoom. {% endhint %} #### Zoek het attribuut dat u nodig hebt in de SCIM2 API-referentie De [SCIM2 API-referentie](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) is de gezaghebbende lijst van alles wat Zoom accepteert tijdens provisioning. Twee bewerkingen zijn van belang: **Maak een gebruiker aan** en **Werk een gebruiker bij**. Werk voornamelijk vanuit **Werk een gebruiker bij**. Creëren gebeurt per persoon slechts één keer, maar attribuutwijzigingen gebeuren continu — een kantoorverhuizing, een plan Wijzigen, een Rol Wijzigen, een vertrekkende medewerker — dus het grootste deel van wat provisioning in de loop van de tijd daadwerkelijk doet, zijn updates. **Werk een gebruiker bij** documenteert ook de verwijderingswaarden die **Maak een gebruiker aan** geen reden heeft om op te nemen, zoals het instellen van `zoomPhoneCallingPlan` naar `-1` om alle belplannen van een gebruiker te verwijderen. Om een attribuut te vinden: * Open de SCIM2 API-referentie en ga naar **Werk een gebruiker bij**. * Zoek in de requestbody het `urn:ietf:params:scim:schemas:extension:zoom:1.0:Gebruiker` object. Elk attribuut dat in deze handleiding wordt behandeld, staat erin vermeld. * Zoek je attribuut op naam en opnemen van zijn **gegevenstype** en zijn **toegestane waarden**. * Lees de beschrijving erbij. Beschrijvingen bevatten gedrag dat je niet uit de attribuutnaam kunt afleiden — `zoomPhoneExtNumber` ingesteld op `0` triggert automatische extensietoewijzing, `zoomPhoneCallingPlan` ingesteld op `-1` verwijdert alle belabonnementen en `zoomPhoneNumber` moet verwijzen naar een nummer dat al niet toegewezen is in het Zoom-account. #### Het samenstellen van de Identificatie: ouder, dubbelepunt, kind Alles wat daarin staat `urn:ietf:params:scim:schemas:extension:zoom:1.0:Gebruiker` object is een **kind** ervan. Het object zelf is de **ouder**. Een Identificatie opbouwen betekent de ouder benoemen, een dubbelepunt toevoegen en vervolgens het kind toevoegen: ``` Ouder urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker Dubbelepunt : Kind zoomPhoneSite Identificatie urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite ``` Dat is de volledige constructie. Er is geen opzoektabel die je bij Zoom hoeft op te vragen en niets om te genereren — de Identificatie is twee dingen die je al hebt, samengevoegd met een dubbelepunt. #### De ouder blijft hetzelfde; alleen het kind verandert Omdat de ouder vastligt, is het configureren van een tweede, vijfde of vijftiende attribuut dezelfde handeling, met een ander kind eraan toegevoegd: ``` Basis (ouder) urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker Zoom Phone locatie urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSite Zoom Phone-nummer urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneNumber Zoom Phone-extensie urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneExtNumber Zoom Phone belabonnement urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan ``` Dezelfde ouder draagt elk ander Zoom-product. Niets Over de constructie verandert wanneer het product dat wel doet: ``` contactcenter Pakket urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomcontactcenterPakket Revenue Accelerator Rol urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomRevenueAcceleratorRol Werkplek-bundel urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace Zoom Docs urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs ``` Je leert dus het bovenliggende element maar één keer. Vanaf dan houdt het configureren van een nieuw attribuut in dat je in de API-referentie slechts drie dingen opzoekt: de naam van het onderliggende element, het gegevenstype en de toegestane waarden. Als je een parent en een child kunt samenstellen, is het moeilijkste deel van deze configuratie achter de rug. Wat nog rest, is je identiteitsprovider vertellen waar elke waarde vandaan moet komen — behandeld in de Entra ID- en Okta-secties die volgen — en beslissen welke attributen je eerst aanpakt, wat hierna aan bod komt. #### Twee soorten mapping: Basis en geavanceerd Niet elk attribuut brengt hetzelfde risico met zich mee, en het is de moeite waard om ze eerst te ordenen voordat je iets configureert. Deze handleiding ontleent de termen **Basis** en **geavanceerde** van de [SSO-gids](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), wat dezelfde lijn trekt voor SAML-respons-mapping. De termen beschrijven **wat Zoom met de waarde doet bij ontvangst**, niet hoe moeilijk het attribuut is om te Configureer. Mechanisch zijn de twee identiek: beide worden gedocumenteerd in dezelfde **Werk een gebruiker bij** requestbody, beide zijn opgebouwd met dezelfde ouder-dubbelepunt-kindconstructie, en beide worden gedeclareerd en toegewezen via dezelfde stappen in Entra ID en Okta. * **Basis mapping** schrijft tekst naar het profiel van een gebruiker. Zoom slaat de waarde exact op zoals verzonden en controleert die nooit tegen iets. * **Geavanceerde mapping** legt een claim op het account. Zoom neemt de waarde en zoekt naar een overeenkomend object, of naar een vrije plaats in een gekocht abonnement — en die opzoeking kan mislukken.
Basis mappingGeavanceerde mapping
Wat de waarde isTekst opgeslagen op het profiel van de gebruikerEen verwijzing naar een object in Zoom, of een aanspraak op een aangekochte licentieplaats
Voorbeeldendepartment, titel, kostenplaatszoomPhoneLocatie, zoomContactCenterRole, zoomWorkplace
BovenliggendOp het hoogste niveau, of de Onderneming-extensieDe Zoom-extensie
Randvoorwaarden in ZoomGeenHet object moet bestaan, of de licentieplaats moet vrij zijn
Als de waarde onjuist isOnjuiste tekst verschijnt op een profielHet attribuut wordt afgewezen of stilzwijgend genegeerd
Het onderscheid stuurt twee praktische beslissingen aan. Het bepaalt **wat je eerst in Zoom moet bouwen** — niets voor Basis mapping, mogelijk heel veel voor geavanceerd — en het bepaalt **wat een fout kost**. Een verkeerde afdeling is een cosmetische fout op een profiel. Een verkeerde locatienaam of een niet-beschikbare licentieplek laat een gebruiker achter zonder werkende telefoon of zonder het product dat ze zijn aangenomen om te gebruiken, en kan in een live-implementatie een recht ontnemen aan iemand die het al had. Dat verschil in gevolg is de reden dat de twee hieronder apart worden behandeld. #### Basis mapping: profielinformatie Basis mapping vult de beschrijvende velden op het Zoom-profiel van een gebruiker. Zoom slaat elke waarde exact op zoals deze is verzonden en valideert deze nooit tegen een bestaand object, dus er is niets om vooraf in Zoom te bouwen en niets dat kapot kan gaan als een waarde onjuist is. **Kernidentiteitsvelden zijn meestal al toegewezen.** `Gebruikersnaam`, `name.givenName`, `name.familyName`, `weergavenaam`, en `e-mailadressen` staan op het hoogste niveau van de requestbody, zonder een bovenliggend element, en zowel de Entra ID- als de Okta-integraties mappen ze standaard. Controleer ze in plaats van ze opnieuw op te bouwen. `titel`, `telefoonnummers`, en `landinstelling` staan ook op het hoogste niveau, maar moeten mogelijk worden toegevoegd. **Ondernemingsvelden gebruiken een tweede bovenliggend item.** De constructie doet geen Wijzigen — alleen de bovenliggende doet dat: ``` Basis (bovenliggend) urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker Afdeling urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Kostenplaats urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:costCenter Werknemersnummer urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:werknemersnummer Organisatie urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:Organisatie Manager urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:manager ``` Het invullen van Afdeling en Kostenplaats via SCIM vereist geen SAML-mapping meer. {% hint style="info" %} **Aanbeveling** Koppel eerst één Basis-attribuut — `department` is een goede kandidaat en wordt uitgewerkt als **Scenario 0** in de referentiescenario's — en voer het van begin tot eind uit voor één testgebruiker voordat je iets configureert onder de Zoom-extensie. Een `department` Een waarde die correct op een Zoom-profiel verschijnt bewijst de schemadefinitie, de mapping, het bereik en je vermogen om de provisioninglogs te lezen. Elk geavanceerd attribuut dat volgt verschilt alleen in waar het naar verwijst, niet in hoe het is geconfigureerd. {% endhint %} #### Geavanceerde mapping: productconfiguratie en rechten Geavanceerde mapping wijst de dingen toe die een gebruiker kan doen: een Zoom Phone-locatie en belabonnement, een contactcenter-rol en Pakket, een Workplace-bundel, een Revenue Accelerator-segment. Deze attributen bevinden zich onder de bovenliggende Zoom-extensie die in deze handleiding overal wordt gebruikt. Het verschil dat ertoe doet, is dat deze waarden niet worden opgeslagen — ze worden **opgelost**. Zoom neemt de waarde die je verzendt en zoekt naar een overeenkomend object of een beschikbare licentie. Waar basis mapping tekst op een profiel schrijft, legt geavanceerde mapping een aanspraak op de configuratie en inventaris van het account, en die aanspraak kan mislukken. Daarom besteedt deze handleiding een hele sectie aan vereisten. Elk geavanceerd attribuut hangt ervan af dat eerst iets is opgebouwd of aangeschaft in de Zoom-webportal, en de foutscenario's zijn aanzienlijk minder vergevingsgezind dan een verkeerd gespelde functietitel. #### De drie lagen die gemeenschappelijk zijn voor elke configuratie Ongeacht welk attribuut of welke identiteitsprovider, het werk bestaat uit dezelfde drie lagen. Alleen de Locatie van elke besturing verschilt.
LaagDoelMicrosoft Entra IDOkta
1. AangevenVertel de identiteitsprovider dat het attribuut bestaat in de Zoom applicatie, zodat het Beschikbaar wordt als toewijzingsdoel.Stap 1Stap 1
2. ToewijzenDefinieer waar de waarde vandaan komt.Stap 2Stappen 2–3
3. ReikwijdteBepaal op welke gebruikers de configuratie van toepassing is en wanneer deze wordt uitgevoerd.Stappen 3–5Stappen 4–5
Zodra dit patroon begrepen is, is het toevoegen van een vijfde of vijftiende attribuut een herhaling van dezelfde drie lagen, geen nieuw project. #### Entra en Okta verschillen in waar een waarde vandaan kan komen Dit is het enige meest ingrijpende architecturale verschil tussen de twee paden, en het verklaart waarom dezelfde Zakelijk vereiste verschillende configuraties oplevert tussen Entra en Okta. * **Entra ID haalt waarden alleen uit attributen van het object van de gebruiker.** Een waarde moet afkomstig zijn van een veld op de gebruiker — een bestaand directoryveld of een Speciaal gebouwd extensieattribuut. Wanneer de directorywaarde en de Zoom-waarde niet dezelfde tekenreeks zijn, is een expressie vereist om tussen beide te vertalen. * **Okta kan waarden halen uit het profiel van de gebruiker of een Groep-toewijzing.** Een attribuut declareren met **Attribuuttype: Groep** maakt het mogelijk dat de waarde één keer op een groep wordt ingesteld en door elk lid wordt overgenomen. Waar configuratie de organisatiestructuur volgt, vervalt daardoor de noodzaak voor vertaallogica volledig. Geen van beide benaderingen is universeel beter, maar ze leiden tot verschillende configuraties. ### **Zoom-Zijde-voorconfiguratievereisten** #### Voordat u geavanceerde toewijzing probeert, moeten objecten aan de Zoom-kant bestaan voordat SCIM ernaar kan verwijzen SCIM is een toewijzingsmechanisme, geen aanmaakmechanisme — het koppelt een gebruiker aan configuratie die al bestaat in het Zoom-account, en het **niet** bouwt die configuratie namens de gebruiker. Een groot deel van de geavanceerde toewijzingsattributen bestaat uit **verwijzingen**: de waarde die u verzendt, moet worden omgezet naar een object dat al bestaat in Zoom — een locatie, een Rol, een sjabloon, een gekocht plan, een specifiek nummer of toestelnummer. Eén regel geldt voor allemaal: > Als een attribuut een ding benoemt, moet dat ding al bestaan, exact gespeld zijn zoals verzonden, en — wanneer het uit een eindige pool put — ongebruikte Capaciteit hebben. Wanneer een verwezen object niet bestaat, maakt SCIM het niet aan en zet het de aanvraag niet in de wachtrij. Het attribuut faalt dan direct, met de fout teruggegeven in het provisioninglogboek, of wordt stilzwijgend genegeerd — Zoom accepteert de payload, past niets toe en meldt succes. De onderstaande secties splitsen de voorwaarden per product uit, met het navigatiepad en het ondersteuningsartikel voor het opzetten van elk ervan. Lees eerst de notities op accountniveau en daarna de sectie voor elk product dat u wilt inrichten. #### Accountvereisten op accountniveau zijn van toepassing voordat een product kan worden ingericht De accountvereisten die aan het begin van deze handleiding worden vermeld — vanity-URL, SSO, SCIM-autorisatie en een geverifieerd gekoppeld domein — zijn voorwaarden voor elk attribuut dat volgt. Configureer beveiliging en SSO onder [**Beheerdercentrum**](https://zoom.com/account) → [**Beveiliging en vertrouwen**](https://zoom.com/account/setting/security), en beheer gekoppelde domeinen onder [**Beheerdercentrum**](https://zoom.com/account) → **account** → [**accountprofiel**](https://zoom.com/account); zie [Zoom + Microsoft Entra ID SSO/SCIM-configuratie](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121). Nog twee punten moeten expliciet worden vermeld: * **Het kopen van een licentie is niet hetzelfde als het toewijzen ervan.** SCIM voert de toewijzing uit, maar de licentie moet eerst bestaan. Zie [Zoom-licenties toewijzen aan of verwijderen van gebruikers](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911). * **Licenties moeten bij het exacte aangevraagde plan horen.** Het verzenden van een licentieattribuut wanneer dat specifieke plan geen vrije plaatsen heeft, mislukt zelfs als een ander plan in het account nog beschikbare Capaciteit heeft. #### Zoom Phone Zoom Phone bevat de grootste set verwijzingsattributen, omdat een Telefoongebruiker wordt samengesteld uit verschillende onderdelen van vooraf gekochte of vooraf gebouwde infrastructuur. | Attribuut | Wat al moet bestaan | Hoe het aan te maken | | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | De Zoom Phone-licentie zelf | Een Beschikbaar Zoom Phone-licentierecht — het vereiste recht voordat iets hieronder kan worden gekoppeld. | Koop vooraf. Zie [Kopen en toewijzen van Zoom Phone-licenties](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929). | | `zoomPhoneLocatie` | De locatie, exact benoemd zoals de verzonden waarde. Als u het attribuut weglaat, wordt de hoofdlocatie van het account toegewezen, die als Standaard bestaat zodra Meerdere sites is ingeschakeld. | [Beheerdercentrum](https://zoom.com/account) → Productconfiguratie → Telefoonsysteem → [Bedrijfsinformatie](https://zoom.com/pbx/page/telephone/settings#/settings) → **Locatie Toevoegen**, of **Importeren** voor bulkcreatie. Zie [Meerdere sites beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716). | | `zoomPhoneNumber` | Het nummer, gekocht of geporteerd in het account en momenteel niet toegewezen. Een nummer dat al wordt gebruikt door een andere gebruiker, oproepwachtrij of automatische receptionist kan niet opnieuw worden gebruikt. | [Beheerdercentrum](https://zoom.com/account) → Productconfiguratie → Nummers → [Telefoonnummers](https://zoom.com/cpw/page/phoneNumbers#/number-list). Koop of Porteren hier, en laat het doelnummer niet toegewezen zodat SCIM het kan claimen. Zie [Number Management gebruiken voor het beheren van Telefoonnummers](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) en [Telefoonnummers beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212). | | `zoomPhoneExtNumber` (alleen specifieke waarden) | Een toestelnummer van 3–6 cijfers, dat nog niet in gebruik is. Niet vereist bij het verzenden van `0`, waarmee de toewijzing aan Zoom wordt gedelegeerd. | [Beheerdercentrum](https://zoom.com/account) → Productconfiguratie → Telefoonsysteem → [Gebruikers & Ruimten](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → Selecteer het object met het toestelnummer → **Profiel** → **toestelnummer** → **Bewerken**. Zie [Telefoongebruikerinstellingen wijzigen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338). | | `zoomPhoneCallingPlan` | Het belabonnement, gekocht en met beschikbare Capaciteit, waarnaar wordt verwezen met de exacte plancode. | Koop vooraf. Zie [Kopen en toewijzen van Zoom Phone-licenties](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) en [Telefoongebruikers beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Plancodes staan vermeld in de [Zoom Phone-belabonnementreferentie](https://developers.zoom.us/docs/api/references/phone-calling-plans/), of geretourneerd als `type` door de [Belabonnementen weergeven](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API samen met beschikbare stoelenaantallen. | | `zoomPhoneCallingPlanSubscription` (alleen voor accounts met meerdere abonnementen) | Het specifieke abonnement waaruit het plan moet putten, wanneer het account meer dan één abonnement voor hetzelfde plan heeft. | Plannen en Facturering → abonnementbeheer. | **De extensiepool wordt gedeeld tussen objecttypen, niet alleen tussen gebruikers.** Wachtrijen voor bellen, automatische receptionist(en), groepen met gedeelde lijnen en telefoons in gemeenschappelijke ruimtes gebruiken allemaal extensies uit hetzelfde bereik. Dit is de meest voorkomende oorzaak van fouten met "extensie al in gebruik", omdat de extensie vrij lijkt wanneer een beheerder alleen de gebruikerslijst controleert. **Een geporteerd nummer kan niet worden toegewezen totdat Porteren is voltooid.** Het nummer moet zowel presenteren in het account als niet-toegewezen zijn; het starten van Porteren voldoet aan geen van beide voorwaarden. **Locaties zijn de meest voorkomende blokkade** omdat het aanmaken ervan eigen vereisten heeft. Locatieadressen worden gevalideerd aan de hand van een echte adresdatabase, omdat ze de basis vormen voor noodoproepdiensten — verzonnen combinaties van adres en postcode worden met een validatiefout geweigerd. Wanneer locaties in bulk worden geïmporteerd, verwacht de kolom 'automatische receptionist' de waarde `Ja` in plaats van de labeltekst die in de interface wordt weergegeven, en naam beller-ID is voornamelijk van toepassing op de VS en Canada en kan leeg worden gelaten als dit een validatiefout veroorzaakt. #### Zoom contactcenter Contactcenter-provisioning is Rol- en sjabloongestuurd. Afzonderlijke attributen moeten verwijzen naar bestaande contactcenter-objecten, en de sjabloon bevat de Instellingen waarvoor geen eigen SCIM-attribuut bestaat. | Attribuut | Wat al moet bestaan | Hoe het aan te maken | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `zoomContactCenterPackage` | Het Pakket — `Essentials`, `Premium`, of `Elite` — gekocht met ongebruikte zitplaatsen. | Kopen vooraf; Premium vereist mogelijk eerst contact opnemen met Zoom-ondersteuning om extra pakketten te Kopen. Zie [Wijzigen van de Instellingen van de Zoom contactcenter-gebruiker](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874). | | `zoomContactCenterAddonsPlan` | Het Add-on(s)-abonnement, aangeschaft en met Capaciteit. | Kopen vooraf; accountplan en Factureringsgegevens. | | `zoomContactCenterRole` | De Rol, Standaard of aangepast, exact benoemd. Als u dit weglaat, wordt de Standaard Agent Rol toegewezen, die Standaard bestaat. | [Beheerdercentrum](https://zoom.com/account) → CX-beheer → contactcenter → [Rollen](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Toevoegen** → Configureer machtigingen → **Opslaan**. Zie [Zoom contactcenter-rollen beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941). | | `zoomContactCenterRegion` | De regio. Als u deze weglaat, wordt de hoofdregio van het account toegewezen, die geconfigureerd moet zijn. | [Beheerdercentrum](https://zoom.com/account) → CX-beheer → contactcenter → [Voorkeuren](https://zoom.com/cci/index/admin#/admin-preferences) → Regio's → **Regio toevoegen** → een naam Invoeren en Selecteer een SIP-zone → **Toevoegen**. Zie [Zoom contactcenter-regio's beheren](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668). | | `zoomContactCenterUserTemplate` | De gebruikerssjabloon, exact met die naam. Sjablonen van het type Toevoegen zijn van toepassing bij het aanmaken van gebruikers; sjablonen van het type Bijwerken zijn van toepassing bij het bijwerken. | [Beheerdercentrum](https://zoom.com/account) → CX-beheer → contactcenter → Gebruikers → [Sjablonen](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Sjabloon Toevoegen** → Kies **Toevoegen** → Configureer rollen, pakketten, wachtrijen en vaardigheden → **Toevoegen**. Zie [Sjabloon voor het beheren van Zoom contactcenter-gebruiker Instellingen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). | {% hint style="danger" %} **Waarschuwing** De Functie(s) voor contactcenterregio's moet door Zoom-ondersteuning worden ingeschakeld voordat regio's kunnen worden gemaakt, en elke gebruiker hoort bij precies één regio. Omdat het een verzoek om ondersteuning is en geen zelfbedieningsschakelaar, moet je dit vroeg indienen als een implementatie met meerdere regio's gepland is. {% endhint %} **Postvakken, wachtrijen en vaardigheden hebben geen SCIM-attribuut.** Om ze te provisioneren, maak ze vooraf aan in [Beheerdercentrum](https://zoom.com/account) → CX-beheer → contactcenter, koppel ze aan een sjabloon voor een gebruiker, en Toewijzen dat sjabloon via `zoomContactCenterUserTemplate`. Ze worden daarom voorwaarden voor het *sjabloon* in plaats van die van de individuele gebruiker — wat de sjabloon ook het enige object maakt dat moet worden onderhouden naarmate die vereisten Wijzigen.
ObjectHoe het aan te maken
WachtrijBeheerdercentrum → CX-beheer → contactcenter → Wachtrijen → Toevoegen wachtrij → naam, kanaal, agenten → Opslaan. Zie Zoom contactcenterwachtrijen beheren.
VaardigheidBeheerdercentrum → CX-beheer → contactcenter → Vaardigheden → Selecteer een categorie → Vaardigheid Toevoegen → naam → Toevoegen. Zie Vaardigheden en vaardigheidscategorieën beheren.
Postvak INBeheerdercentrum → CX-beheer → contactcenter → Postvak IN → Inbox toevoegen. Zie Zoom contactcenter-inboxen beheren.
**Wanneer zowel een sjabloon als afzonderlijke attributen worden opgegeven, hebben de afzonderlijke waarden voorrang.** Een sjabloon mee verzenden `zoomContactCenterRole` betekent dat het Rol-attribuut de Rol-instelling van het sjabloon overschrijft, dus zowel de verwijzende Rol als het sjabloon moeten bestaan. #### Zoom Revenue Accelerator | Attribuut | Wat al moet bestaan | Hoe het aan te maken | | -------------------------------------------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `zoomRevenueAcceleratorPlan` en `zoomRevenueAcceleratorSubscription` | Het aangeschafte ZRA-plan of abonnement met een beschikbare plek. | Kopen vooraf; accountplan en Factureringsgegevens. | | `zoomRevenueAcceleratorRol` | De Rol, Standaard of aangepast — bijvoorbeeld `Verkoopmanager` — exact benoemd. | [Beheerdercentrum](https://zoom.com/account) → Gebruikers → [Rollen](https://zoom.com/role#/) → **Revenue Accelerator** Tabblad → **+ Toevoegen Rol** → naam en beschrijving → **Toevoegen** → Configureer machtigingen → **Wijzigingen opslaan**. Zie [Gebruik van Zoom Revenue Accelerator Rollenbeheer](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). | | `zoomRevenueAcceleratorSegment` | Het segment waartoe de gebruiker behoort. | Instellingen van de beheerder van Revenue Accelerator. | | `zoomRevenueAcceleratorRegion` | De regio — bijvoorbeeld, `US`. | Instellingen van de beheerder van Revenue Accelerator. | #### Zoom Workplace-licenties en accountrollen Naast de drie bovenstaande producten bevat de standaard gebruiker opnemen Rol- en licentiereferenties die dezelfde regel volgen. | Attribuut | Wat al moet bestaan | Hoe het aan te maken | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `rollen[]` (`waarde` / `weergeven`) | Het account Rol, exact benoemd. Rollen worden door SCIM gerefereerd, nooit door SCIM aangemaakt. | [Beheerdercentrum](https://zoom.com/account) → Gebruikers → [Rollen](https://zoom.com/role#/) → **Toevoegen Rol** → naam en beschrijving → Configureer machtigingen. Zie [Rollenbeheer gebruiken](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). | | `zoomWorkplace` en andere licentie- of Add-on(s)-kenmerken — whiteboard, Scheduler, Clips Plus, vertaalde ondertiteling, Workforce Management, kwaliteitsbeheer, nalevingsbeheer, CX Insights, AI Verkoop Assist en hun `...Abonnement` tegenhangers | De bijbehorende bundel of Add-on(s), aangeschaft met ongebruikte licentieplaatsen. | Plannen en Facturering → Planbeheer → bewerk het plan → verhoog het aantal licenties. Zie [Je account en Toevoegen-ons upgraden](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375). | | `inlogType` (`sso` / `werkE-mail`), onder `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser` | SSO geconfigureerd op het account, voor het SSO-inlogtype. | [Beheerdercentrum](https://zoom.com/account) → Beveiliging en vertrouwen → [Single Sign-On](https://zoom.com/account/sso/saml). | Voor een licentie- of Add-on(s)-kenmerk is er geen object dat een naam moet krijgen, maar de voorwaarde vooraf heeft hetzelfde effect: zonder een beschikbare seat in die specifieke pool mislukt de toewijzing. #### Attributen zonder voorwaarde Elk basis toewijzingsattribuut komt in aanmerking, zoals behandeld onder **Basis mapping: profielinformatie** — Zoom slaat die waarden letterlijk op en valideert ze nooit aan de hand van een bestaand object. Twee attributen onder de Zoom-extensie gedragen zich op dezelfde manier: * **Automatisch gedelegeerde waarden** — `zoomPhoneExtNumber` verzonden als `0`, waar Zoom de extensie zelf toewijst. * **Aangepaste accountattributen** — de `{customAttribute}` veld, dat elke tekenreeks bevat die je verstuurt. **Standaard ingestelde verwijzingen** zijn een tussengeval: het weglaten van `zoomPhoneLocatie`, `zoomContactCenterRole`, of `zoomContactCenterRegion` valt terug op de hoofdlocatie, de Standaard Agent Rol en de hoofdregio, respectievelijk. Die Standaardwaarden moeten zelf bestaan, en dat doen ze standaard. **Groepen zijn een gedeeltelijke uitzondering.** Waar Groep-provisioning is ingeschakeld, maakt SCIM een Zoom Groep aan die nog niet bestaat, met exact de naam van de bron-Groep zoals die is getypt. Er wordt geen productconfiguratie op die Groep toegepast — de Groep verschijnt met leden en verder niets. Zoom Phone-beleid, belmachtigingen en andere Instellingen op Groep-niveau moeten nog steeds worden geconfigureerd onder [Beheerdercentrum](https://zoom.com/account) → Gebruikers → [Groepen](https://zoom.com/account/group#/) nadat de Groep verschijnt. {% hint style="info" %} **Aanbeveling** Beschouw de uitrol aan de Zoom-kant als een verplichte voorbereidende fase met een eigen goedkeuring, afgerond en geverifieerd voordat het werk aan attributentoewijzing begint. Locaties, nummers, abonnementen, Rollen en sjablonen zijn vaak eigendom van een ander team dan de configuratie van de identiteitsprovider, en het ontdekken van een ontbrekend object tijdens provisioningtests kost aanzienlijk meer dan het vooraf bevestigen van het bestaan ervan. {% endhint %} ### **Uw directorygegevens voorbereiden** SCIM verzendt wat de bron bevat. Het valideert, normaliseert of corrigeert niet. Voordat u een attribuut mapt, bevestig drie dingen over de beoogde bron: * **Het is ingevuld voor elke gebruiker binnen de scope.** Een niet-ingevuld veld verzendt niets, of verzendt de geconfigureerde Standaardwaarde. * **De waarden zijn consistent in opmaak en hoofdlettergebruik.** De vergelijkingslogica in beide identiteitsproviders is exact. * **De waarden komen exact overeen met de verwachte waarden van Zoom.** Zoom maakt geen fuzzy-match op locatienamen, Rolnamen of planwaarden. Waar een bestaand veld niet aan alle drie de voorwaarden kan voldoen, is een Speciaal gebouwd attribuut dat bewust voor deze Integratie(s) is ingevuld duurzamer dan het hergebruiken van een veld waar ook andere systemen naar schrijven. {% hint style="info" %} **Aanbeveling** Bepaal de bron van waarheid voordat u de configuratie van de identiteitsprovider aanraakt. De meeste mislukte SCIM-implementaties zijn problemen met directorygegevens die als provisioningproblemen worden gepresenteerd. {% endhint %} ### **Referentiescenario's** Er worden in deze handleiding vier scenario's gebruikt. Hun Zakelijke vereisten en vereisten aan de Zoom-zijde zijn identiek, ongeacht de identiteitsprovider, dus worden ze hier één keer gedefinieerd. Elke sectie per identiteitsprovider eindigt met een uitleg over hoe u ze alle vier in dat Platform implementeert. #### Scenario 0: Afdeling, als een eerste Basis-mapping De afdeling van een gebruiker moet op hun Zoom-profiel verschijnen, afkomstig uit de directory. Dit is de Basis-mapping die eerder werd aanbevolen als een eerste end-to-endtest, en deze is hier opgenomen zodat de procedure in beide secties van de identiteitsprovider wordt doorlopen. **Voorvereiste aan de Zoom-kant.** Geen. Zoom slaat de waarde exact op zoals verzonden en valideert deze nooit aan de hand van een bestaand object. **Attribuut.** Merk op dat het bovenliggende item verschilt van de drie onderstaande scenario's — `department` bevindt zich onder de onderneming-extensie, niet onder de Zoom-extensie. | Attribuut | Type | Notities | | --------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:afdeling` | tekenreeks | Vrije tekst. Beide identiteitsproviders bevatten al een `department` veld op het profiel van de gebruiker, dus is geen nieuw bronattribuut nodig. | **Waarom hier beginnen.** Dat een afdelingswaarde correct op een Zoom-profiel verschijnt, bewijst de schemadefinitie, de toewijzing, de reikwijdte en je vermogen om de provisioninglogs te lezen — zonder een licentie of een telefoonconfiguratie in gevaar te brengen. Elk geavanceerd scenario hieronder verschilt alleen in waarnaar het kenmerk verwijst. **Controleer eerst of het al is toegewezen.** Standaardtoewijzingen verschillen tussen Entra ID en Okta, en zij Wijzigen naarmate beide leveranciers hun Zoom-integraties bijwerken. Bekijk de bestaande lijst onder **Provisionering** → **Toewijzingen** in Entra, of **Zoom-attribuuttoewijzingen** met **Weergeven van niet-gemapte kenmerken** ingeschakeld in Okta. Als `department` al is toegewezen, verifieer het in plaats van het als duplicaat te verklaren — en als u in plaats daarvan een attribuut helemaal opnieuw wilt Configureer, `kostenplaats`, `Organisatie`, en `employeeNumber` zitten onder dezelfde bovenliggende entiteit en gedragen zich identiek. #### Scenario 1: Zoom Phone-locatie en automatische toewijzing van toestelnummers Gebruikers moeten op basis van hun kantoor in de juiste Zoom Phone-locatie worden geplaatst en een toestelnummer ontvangen zonder administratieve tussenkomst. **Vereiste aan de Zoom-kant** De locaties moeten al bestaan. Maak ze aan onder [**Beheerdercentrum**](https://zoom.com/account) → **Productconfiguratie** → **Telefoonsysteem** → [**Bedrijfsinformatie**](https://zoom.com/pbx/page/telephone/settings#/settings) → **Locatie Toevoegen**, of in bulk via **Importeren**. Locatieadressen worden gevalideerd aan de hand van een echte adresdatabase omdat ze noodoproepdiensten ondersteunen, dus fictieve combinaties van adressen en postcodes slagen niet bij de validatie. **Attributen.** Beide nemen de naamruimte `urn:ietf:params:scim:schemas:extension:Zoom:1.0:gebruiker:` gevolgd door de naam. | Attribuut | Type | Notities | | -------------------- | ---------- | ---------------------------------------------------------- | | `zoomPhoneLocatie` | tekenreeks | Moet teken voor teken overeenkomen met de Zoom-locatienaam | | `zoomPhoneExtNumber` | tekenreeks | `0` activeert automatische toewijzing | **Waarom de waarde `0` belangrijk is.** Zoom is het enige systeem dat weet welke extensies al in gebruik zijn — inclusief extensies die zijn toegewezen aan wachtrijen voor bellen en automatische receptionisten in plaats van aan gebruikers. Door de toewijzing aan Zoom over te laten, wordt een hele categorie provisioningfouten weggenomen. Extensies uit de directory halen is tijdens een migratie daarentegen passend, wanneer het behouden van bestaande extensienummers belangrijk is, maar de koppeling moet overschakelen naar `0` zodra de migratie is voltooid, zodat toekomstige gebruikers niet afhankelijk zijn van het onbeperkt onderhouden van directorygegevens. {% hint style="info" %} **Opmerking** De Standaard-locatie op een Zoom Phone-account heet doorgaans precies `Hoofdlocatie`, zichtbaar onder [**Beheerdercentrum**](https://zoom.com/account) → **Productconfiguratie** → **Telefoonsysteem** → [**Bedrijfsinformatie**](https://zoom.com/pbx/page/telephone/settings#/settings). Controleer de naam op het specifieke account voordat je erop vertrouwt, aangezien deze kan worden hernoemd. {% endhint %} #### Scenario 2: Zoom Phone-belabonnement dat per land verschilt Een multinationale Organisatie heeft afzonderlijke Zoom Phone-belabonnementen aangeschaft en moet ervoor zorgen dat elke gebruiker het belabonnement ontvangt dat bij zijn land past. **Voorvereiste aan de Zoom-kant.** De belabonnementen moeten al zijn aangeschaft en Beschikbaar zijn op het account. De waarden van het belabonnement zijn gedocumenteerd in de [Zoom Phone-belabonnementreferentie](https://developers.zoom.us/docs/api/references/phone-calling-plans/). **Attribuut.** `zoomPhoneCallingPlan` (string). **Hoe je de juiste plancode krijgt.** `zoomPhoneCallingPlan` neemt de numerieke plancode, niet een plannaam. De meest betrouwbare manier om die te verkrijgen is de [Belabonnementen weergeven](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API, die van elk plan de `naam`, zijn `type` — de code die je moet Toewijzen — en zijn `geabonneerd` en `Beschikbaar` aantallen zitplaatsen. Eén aanroep (bellen) bevestigt daarom dat het plan bestaat, geeft je de waarde om te verzenden en controleert of er Capaciteit is om het te Toewijzen. De Zoom-webportal toont alleen weergeven namen, nooit codes, dus een beheerder die alleen vanuit de portal werkt, moet de weergeven naam vertalen met behulp van de [Zoom Phone-belabonnementreferentie](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — waar bijvoorbeeld, `UNLIMITED_PLAN_US_CA` is `200` en `UNLIMITED_PLAN_GB_IE` is `202`. De referentie vermeldt constante namen in plaats van de formulering van het portaal, dus bevestig de overeenkomst op basis van plankenmerken — regio en gemeten versus onbeperkt — in plaats van op de exacte tekst. Afzonderlijk toont de SCIM2 API-referentie van Zoom een factureringsplannaam zoals `phone_calling_usca_monthly_unlimited` in de voorbeeld-payload. Die Identificatie wordt gebruikt om *Kopen* een abonnement te kopen, niet om een plan toe te wijzen aan een gebruiker. Als u moet aangeven op welk abonnement een plan steunt, hoort dat in `zoomPhoneCallingPlanSubscription`. **Waarom `-1` wordt gebruikt als terugvaloptie.** De SCIM2-referentiedocumenten `-1` als de waarde waarmee alle belplannen worden verwijderd. Het gebruiken ervan voor niet-overeenkomende gebruikers levert een deterministische, zichtbare uitkomst op — geen plan toegewezen — in plaats van de dubbelzinnigheid van helemaal geen waarde verzenden. Het biedt ook een nette manier om belrechten te deprovisioneren zonder de gebruiker te verwijderen. #### Scenario 3: Zoom contactcenter Pakket, Rol en regio contactcenteragents moeten op het moment van Onboarding worden voorzien van het juiste ZCC Pakket en de juiste Rol, in plaats van achteraf handmatig te worden geconfigureerd. Dit scenario laat zien dat de methode productonafhankelijk is — aan de procedure verandert niets, alleen de kenmerknamen en toegestane waarden. | Attribuut | Type | Toegestane waarden | | -------------------------- | ---------- | --------------------------------------------------------------------------------------- | | `zoomContactCenterPackage` | tekenreeks | `Essentials`, `Premium`, `Elite` | | `zoomContactCenterRole` | tekenreeks | Elke ZCC Rolnaam. Standaard ingesteld op `Medewerker` indien weggelaten. | | `zoomContactCenterRegion` | tekenreeks | Elke geconfigureerde ZCC-regio. Standaard ingesteld op de hoofdregio indien weggelaten. | **Bij het bewust weglaten van attributen.** verlaten `zoomContactCenterRegion` niet toegewezen in implementaties met één regio, waar de gedocumenteerde Standaard van Zoom al correct is. Een attribuut weglaten waarvan de Standaard juist is, heeft de voorkeur boven het mappen ervan — elke mapping is een onderhoudsverplichting. **Operationele noot.** De SCIM2-referentie documenteert ook `zoomContactCenterUserTemplate`, die een vooraf gebouwde ZCC-sjabloon toepast. Toevoegen-type sjablonen worden toegepast bij het aanmaken van een gebruiker en update-type sjablonen bij een update; wanneer zowel een sjabloon als individuele attribuutwaarden in dezelfde aanvraag worden opgegeven, krijgen de individuele waarden voorrang. Sjablonen zijn het overwegen waard wanneer de ZCC-configuratie complex genoeg is dat het onderhoud ervan over veel afzonderlijke attribuuttoewijzingen omslachtig wordt. ### **Verificatie aan Zoom-zijde en veelvoorkomende fouten** Elke identiteitsprovider heeft zijn eigen logboek, behandeld in stap 6 van elke identiteitsprovider. Het Zoom-zijdelogboek hieronder is identiek voor beide en is het definitieve opnemen van wat Zoom daadwerkelijk heeft ontvangen. #### De bellenlogboeken van Zoom App Marketplace Weergeven de volledige uitwisseling van verzoek en antwoord 1. Aanmelden bij het Zoom-webportal als de accounteigenaar. 2. Ga naar de [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Beheren** → **Apps op het account**. 3. Selecteer de applicatie die de verbinding met de identiteitsprovider vertegenwoordigt. Voor Entra is dit doorgaans genoemd **Azure Identity** of vergelijkbaar. 4. Open de **Bellenlogboeken** Tabblad. 5. Gebruik **Zoeken op Eindpunt**, of de filters voor datumbereik, methode en status, om het relevante bellen te vinden. 6. Selecteer de rij om deze uit te vouwen. 7. Bekijk `requestBody` om precies te zien wat er is verzonden, en `reactie` om precies te zien wat Zoom heeft geretourneerd, inclusief de gegenereerde Zoom-gebruiker-ID, `httpStatus`en de resulterende attribuutset. Zoom bewaart de meest recente 100 API-aanvraaglogboeken, dus onderzoek een storing snel in plaats van pas nadat verdere provisioning-activiteiten deze hebben verdrongen. #### Veelvoorkomende provisioningfouten en hun oorzaken
CodeBerichtOorzaak en oplossing
400Het account heeft Single Sign-On niet ingeschakeld.SSO is een vereiste voor SCIM. Inschakelen en Configureer SSO eerst op het Zoom-account.
400Gebruiker is inactief of vergrendeld.De doel-Zoom-gebruiker kan niet worden bijgewerkt in de huidige status. Los de accountstatus op in het Zoom-webportal.
403Het verzoek is geweigerd wegens onvoldoende machtigingen: "Gebruiker:Edit".De referenties achter de SCIM-verbinding hebben niet de vereiste scope. Autoriseer de verbinding opnieuw met een Eigenaar- of beheerderaccount.
404Gebruiker bestaat niet.De identiteitsprovider heeft de gebruiker niet gekoppeld aan een bestaande Zoom-gebruiker. Controleer het overeenkomende kenmerk en de Gebruikersnaam-indeling.
409Het E-maildomein komt niet overeen met het gekoppelde domein van het account.Het E-maildomein van de gebruiker is niet gekoppeld aan het Zoom-account. Koppel en verifieer het domein vóór de provisioning.
409Toevoegen van betaalde gebruikers is niet mogelijk.Er is geen licentie van het gevraagde type Beschikbaar. Maak Capaciteit vrij op het account, of provisioneer de gebruiker als Basis.
409Er kunnen geen extra gebruikers met [bundle name] worden aangemaakt.De betreffende bundel heeft geen resterende plaatsen. Van toepassing op Workplace Zakelijk Plus, Onderneming Premier, Pro Plus en de Onderwijs-equivalenten.
429Te veel verzoeken.Provisioning heeft de snelheidslimieten van Zoom overschreden. Onderzoek of dit zich over cycli heen blijft voordoen.
#### Eén faalmodus produceert helemaal geen fout. Een waarde die Zoom accepteert maar die nergens mee overeenkomt — een naam van een locatie met een spatie aan het einde, of een Rolnaam die sinds de hernoeming in Zoom zo heet — kan syntactisch worden geaccepteerd en op niets worden toegepast. Geen logvermelding markeert dit optreden. Platform-specifieke varianten van hetzelfde probleem worden behandeld in Stap 6. {% hint style="info" %} **Opmerking** Wanneer Zoom en de identiteitsprovider het oneens zijn over de configuratie van een gebruiker, beschouw de identiteitsprovider dan als gezaghebbend en corrigeer de waarde daar. Rechtstreeks bewerken in het Zoom-webportal levert een status op die wordt overschreven door het volgende provisioning-evenement, waardoor het onderliggende probleem moeilijker te diagnosticeren is. {% endhint %} ## **SCIM configureren met Entra ID** #### Aanvullende vereisten voor Entra ID * Entra ID-beheerdersrechten met Access tot Ondernemingstoepassingen * Het E-maildomein dat door uw gebruikers wordt gebruikt, geverifieerd als een aangepast domein in de Entra ID-tenant #### Aanvullende beperkingen in Entra ID * Attribuuttoewijzingen zijn uitsluitend afkomstig van Entra *gebruikerobject* attributen. BeveiligingsGroepen kunnen niet rechtstreeks een waarde aan een Zoom-attribuut toekennen; het lidmaatschap van de Groep bepaalt de scope, niet de waarde. * Incrementele provisioningcycli worden ongeveer elke 40 minuten uitgevoerd. Wijzigingen zijn niet direct zodra provisioning is ingeschakeld. * De `Samenwerking` waarde van `gebruikerstype` wordt niet ondersteund met Entra ID vanwege een Microsoft-specifieke beperking. {% hint style="info" %} **Opmerking** Standaard provisioningconfiguratie kan worden uitgevoerd vanuit een van beide `entra.microsoft.com` of `portal.azure.com`. De schema-editor die in stap 1 wordt gebruikt, is echter alleen bereikbaar via de Azure Portal-URL met de `forceSchemaEditorEnabled` parameter toegevoegd. Deze vlag heeft geen effect op `entra.microsoft.com`. Gebruik de Azure Portal-link in stap 1 voor alle stappen in dit deel om te voorkomen dat u midden in de configuratie van portal wisselt. {% endhint %} ### Stap 1: Declareer het kenmerk in het Zoom applicatie-schema Het declareren van een kenmerk is een eenmalige actie per kenmerk. Declareer elk kenmerk dat u wilt gebruiken voordat u configuraties toewijst, zodat alle doelitems beschikbaar zijn bij stap 2. 1. Aanmelden bij de Azure Portal met behulp van de URL van de schema-editor: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home` 2. Onder **Azure-services**, selecteer **Microsoft Entra ID**. 3. Klik in het linkernavigatiemenu onder **Beheren**, klik **Ondernemingstoepassingen**. 4. Klik in de lijst met toepassingen op uw Zoom-applicatie.\ **Opmerking**: De applicatienaam wordt door de Entra-beheerder gedefinieerd wanneer de applicatie wordt gemaakt. Deze heeft vaak de naam **Zoom** of **Zoom SSO**, maar kan afwijken in uw tenant. 5. Klik in het linkernavigatiemenu onder **Beheren**, klik **Provisionering**.\ **Opmerking**: Azure presenteert momenteel een van de twee indelingen. Selecteer in de klassieke ervaring **Attributentoewijzingen bewerken** onder **Provisioning beheren**. In de nieuwere ervaring wordt de pagina geopend op een **Overzicht** Tabblad; Selecteer **Provisionering** opnieuw vanuit het linkermenu. Beide routes komen uit op dezelfde bestemming. 6. Klik op de **Toewijzingen** dropdown, klik vervolgens **Microsoft Entra ID-gebruikers provisioneren**.\ **Opmerking**: In tenants die nog verouderde naamgeving weergeven, wordt deze optie weergegeven als **Azure Active Directory-gebruikers inrichten**. 7. In de linkerbenedenhoek, Selecteer de **Geavanceerde opties Weergeven** selectievakje. 8. Klik op **Attribuutlijst bewerken voor Zoom**. 9. Scrol naar de eerste lege rij en vul het volgende in: * **Naam**: Invoeren van de volledige attribuutreeks, bijvoorbeeld `urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSite` * **Type**: Selecteer **String** of **Boolean**, overeenkomend met het gegevenstype dat is gedocumenteerd in de SCIM2 API-referentie. 10. Herhaal stap 9 voor elk extra attribuut. 11. Klik linksboven op **Opslaan**. {% hint style="warning" %} **Let op** Attribuutnamen zijn hoofdlettergevoelig en moeten exact overeenkomen met de API-referentie. `zoomPhoneLocatie` is geldig; `zoomphonesite` en `ZoomPhoneSite` zijn dat niet. Een attribuut met onjuiste hoofdletters wordt door de schema-editor zonder fout geaccepteerd en mislukt stilzwijgend bij de Zoom API. Voor attributen die zijn gedocumenteerd als `boolean`, **String** is ook geldig, mits de gekoppelde bron de letterlijke tekst levert `waar` of `false`. Selecteren **String** is vaak praktischer wanneer de bron een Entra-extensieattribuut is, dat tekst opslaat. {% endhint %} ### Stap 2: Koppel een directorybron aan het attribuut Entra ID biedt drie toewijzingstypen, en de keuze tussen deze is de meest ingrijpende beslissing in de configuratie.
Type toewijzingGebruik wanneerGedrag
DirectEen Entra-veld bevat al de exacte waarde die Zoom verwacht.Geeft de bronwaarde ongewijzigd door.
ConstanteElke gebruiker binnen het bereik moet dezelfde waarde krijgen.Stuurt een vaste waarde naar elke geprovisionde gebruiker.
ExpressieDe waarde moet worden afgeleid, vertaald of variëren op basis van een attribuut van de gebruiker.Evalueert een expressie tegen bronvelden en stuurt het resultaat.
**Om de toewijzing te maken:** 1. Terug naar **Provisionering** → **Toewijzingen** → **Microsoft Entra ID-gebruikers provisioneren**. 2. Klik linksonder op **Toevoegen nieuwe toewijzing**. 3. Configureer de toewijzing volgens het geselecteerde type — zie de richtlijnen hieronder. 4. Klik op de **Doelattribuut** keuzelijst en Selecteer het attribuut dat in Stap 1 is opgegeven. 5. Klik op de **Objecten koppelen met dit attribuut** keuzelijst en Selecteer **Nee**.\ **Opmerking**: Aangepaste Zoom-attributen zijn configuratiewaarden, geen sleutels voor identiteitskoppeling. Alleen het attribuut dat Entra-gebruikers met Zoom-gebruikers correleert — doorgaans `Gebruikersnaam` — moet worden ingesteld op **Ja**. 6. Klik op de **Pas deze toewijzing toe** keuzelijst en Selecteer **Altijd**, zodat de waarde zowel bij het aanmaken als bij latere updates wordt toegepast. 7. Klik op **OK**. 8. Herhaal dit voor elk attribuut en klik vervolgens op **Opslaan** bovenaan de **Attribuuttoewijzing** pagina. #### Directe toewijzing geeft een bestaand veld door zonder transformatie * **Type toewijzing**: **Direct** * **Bronattribuut**: Een Entra-veld waarvan de waarde al exact overeenkomt met wat Zoom verwacht, teken voor teken * **Standaardwaarde indien null (Optioneel)**: Een terugvaloptie die wordt toegepast wanneer het bronveld leeg is Directe mapping is de minst kwetsbare optie en moet de voorkeur krijgen waar de directorygegevens dit ondersteunen. Als `physicalDeliveryOfficeName` — weergegeven als **Kantoorlocatie** op het Entra-gebruikersprofiel — bevat al waarden die exact overeenkomen met de locatienamen van Zoom Phone; het rechtstreeks mappen ervan vereist helemaal geen logica. {% hint style="info" icon="lightbulb" %} **Tip** Invullen **Standaardwaarde indien null** wanneer een ontbrekende bronwaarde een fout of een onbedoelde uitkomst zou veroorzaken. Een standaard van `Hoofdlocatie` in een locatiemapping zorgt ervoor dat gebruikers zonder kantoorlocatie nog steeds succesvol worden ingericht in plaats van in een ongedefinieerde toestand terecht te komen. {% endhint %} #### Constante mapping past één waarde toe op de volledige populatie binnen het bereik * **Type toewijzing**: **Constante** * **Constante waarde**: De vaste waarde om te verzenden Constante mapping is geschikt voor implementaties met één configuratie en is ook het mechanisme achter verschillende Zoom-specifieke gedragingen. Het instellen van `zoomPhoneExtNumber` op een constante van `0` instrueert Zoom om de Volgende Beschikbare extensie binnen de locatie van de gebruiker toe te wijzen, waardoor extensieconflicten volledig worden geëlimineerd. #### Expressiemapping vertaalt of leidt een waarde af tijdens het inrichten * **Type toewijzing**: **Expressie** * **Expressie**: Een genest `IIF()` instructie die een of meer bronattributen evalueert Expressiemapping is vereist wanneer de directorywaarde en de Zoom-waarde niet dezelfde tekenreeks zijn: ``` IIF([officeLocation]="London","LON-01", IIF([officeLocation]="Manchester","MAN-01", "Hoofdlocatie")) ``` {% hint style="danger" %} **Waarschuwing** Expressies vergelijken tekst exact zoals getypt, inclusief hoofdlettergebruik. `GB` en `gb` zijn verschillende waarden, net als `Verenigd Koninkrijk` en `verenigd koninkrijk`. Een vergelijking die mislukt, genereert geen fout — deze valt door naar de standaardtak, en de gebruiker wordt stilzwijgend met de verkeerde configuratie ingericht. {% endhint %} Omsluit bronwaarden in `ToUpper()` en vergelijk met letters in hoofdletters om inconsistentie in hoofdlettergebruik te neutraliseren: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", "-1")) ``` #### De indeling van het bronveld varieert afhankelijk van hoe de Entra-gebruiker is gemaakt Dit is de meest voorkomende oorzaak van expressiemappings die correct lijken maar zich inconsistent gedragen binnen een populatie. * **Locatie voor gebruik** wordt door Microsoft afgedwongen om altijd een geldige ISO 3166-1 alpha-2-code te bevatten, zoals `GB`, omdat het de beschikbaarheid van licentie en Functie(s) regelt. Dit veld is betrouwbaar. * **Land/regio** kent geen dergelijke afdwinging, en de inhoud is afhankelijk van de aanmaakmethode. Gebruikers die via de GUI van het Entra-beheerportal zijn gemaakt, Selecteer doorgaans uit een vervolgkeuzelijst met volledige landnamen, dus het veld slaat doorgaans `Verenigd Koninkrijk`. Gebruikers die via CSV-import of PowerShell zijn gemaakt, worden doorgaans ingevuld met `GB` — volgens conventie, niet op basis van afdwinging. In elke tenant waar gebruikers via meer dan één methode zijn gemaakt, `land` zal geen consistent formaat hebben. Standaardiseer het veld voordat u de expressie opbouwt, of test expliciet op beide formaten zoals hierboven getoond. ### Stap 3: Neem gebruikers en groepen op in het provisioneringsbereik Toewijzing bepaalt welke gebruikers de configuratie raakt. Gebruikers buiten het toewijzingsbereik van de applicatie worden nooit beïnvloed door enige toewijzing, waardoor toewijzing de primaire veiligheidscontrole is tijdens de uitrol. 1. Navigeer naar **Microsoft Entra ID** → **Ondernemingstoepassingen** → uw Zoom-applicatie → **Gebruikers en groepen**. 2. Klik op **Gebruiker/groep toevoegen**. 3. Onder **Gebruikers en groepen**, selecteer de gewenste gebruiker of beveiligingsgroep. 4. Onder **Selecteer een rol**, kies de juiste rol. 5. Klik op **Toewijzen**. In de praktijk zijn slechts twee rolwaarden van belang. Andere opties zoals **Corp** en **Pro** zijn ofwel verouderde benamingen die geleidelijk verdwijnen, of bedoeld voor ongebruikelijke scenario's.
RolEffect
BasisVoorziet de gebruiker zonder betaalde vergaderlicentie. Selecteer dit wanneer een aangepast kenmerk — zoals een Zoom Phone-belabonnement — verantwoordelijk is voor het toewijzen van het betaalde recht.
Met licentieWijst het Standaard licentieplan van het Zoom-account toe, bijvoorbeeld Zoom Workplace Onderneming Plus. Op dit scherm kan geen specifieke bundel worden gekozen; de Standaard wordt aan Zoom-zijde geconfigureerd.
Deze rolkeuze geldt eenmaal per gebruiker of groep die aan de applicatie is toegevoegd, ongeacht hoeveel aangepaste kenmerken worden geprovisioneerd. **Om Entra-groepen als Zoom-groepen te provisioneren**, die standaard is uitgeschakeld: 1. Navigeer naar **Provisionering** → **Toewijzingen** en Selecteer **Microsoft Entra ID-groepen provisioneren**. 2. In-/uitschakelen **Ingeschakeld** naar **Ja**. 3. Controleer of de standaardtoewijzingen aanwezig zijn: `weergavenaam` → `weergavenaam`, en `leden` → `leden`. 4. Klik op **Opslaan**. 5. Terug naar **Gebruikers en groepen** en bevestig dat de groep zelf aan de applicatie is toegewezen, niet alleen de afzonderlijke leden. Groepsprovisionering verwerkt alleen direct toegewezen groepen. {% hint style="warning" %} **Let op: wat SCIM wel en niet doet met groepen** Als er nog geen Zoom-groep met een overeenkomende naam bestaat, maakt SCIM er een aan met de `weergavenaam` exact zoals getypt. De groep wordt gemaakt met leden maar **zonder enige productconfiguratie**. Een beheerder moet nog steeds [**Beheerdercentrum**](https://zoom.com/account) → **Gebruikers** → [**Groepen**](https://zoom.com/account/group#/) aanmelden bij het Zoom-webportal en de gewenste instellingen toepassen — Zoom Phone-beleidsregels op groepsniveau, belmachtigingen of andere productconfiguratie. SCIM provisioneert het bestaan en lidmaatschap van een groep; het definieert niet wat die groep binnen Zoom doet. {% endhint %} ### Stap 4: Valideer met Provision on Demand **Provision on Demand** draait onafhankelijk van de **Provisioneringsstatus** In-/uitschakelen-schakelaar, en precies daarom is het het juiste hulpmiddel voor validatie. Elke stap tot nu toe — inclusief deze — kan worden voltooid terwijl provisioning uitgeschakeld blijft. 1. Navigeer naar **Provisionering** → **Provisioneringsoverzicht**. 2. Klik op **Provision on Demand**. 3. Zoek en selecteer één testgebruiker en klik vervolgens op **Provisioneren**. 4. Controleer het resultaat. Entra rapporteert de vier fasen die het uitvoert voor elk provisioneringsgebeurtenis — **Importeren**, **Bepaal of binnen bereik**, **Matchen**, en **Provisioneren** — elk afzonderlijk uitklapbaar. 5. Controleer of de weergegeven kenmerkwaarden overeenkomen met uw bedoeling. 6. Aanmelden bij het Zoom-webportal en bevestig dat de configuratie is toegepast. {% hint style="info" %} **Aanbeveling** Valideer met een gebruiker die de *moeilijkste* geval in uw populatie — een gebruiker in het buitenland, een gebruiker die op een andere manier is aangemaakt, of een gebruiker waarvan het bronveld leeg is. Een test die alleen het eenvoudige geval bestrijkt, zal de in Stap 2 beschreven faalmodi niet aan het licht brengen. {% endhint %} ### Stap 5: Inschakelen van doorlopende provisioning Het inschakelen van provisioning zet de configuratie live in werking voor elke gebruiker binnen de scope. Voltooi en verifieer eerst Stap 1 tot en met 4. 1. Navigeer naar **Microsoft Entra ID** → **Ondernemingstoepassingen** → uw Zoom-applicatie → **Provisionering** → **Provisionering**. 2. In-/uitschakelen **Provisioneringsstatus** naar **Aan**. 3. Klik op **Opslaan**. De eerste cyclus kan ongeveer 40 minuten duren. Volgende incrementele cycli lopen met intervallen van ongeveer 40 minuten. Nieuwe aanmeldingen, wijziging van kenmerken en deactiveringen synchroniseren volgens die Planning in plaats van onmiddellijk. ### Stap 6: Verifiëren met Entra provisioninglogboeken 1. Navigeer naar **Microsoft Entra ID** → **Ondernemingstoepassingen** → uw Zoom-applicatie → **Monitoren** → **Provisioninglogboeken**. 2. Zoek of filter op de testgebruiker en selecteer vervolgens het relevante Evenement. De detailweergave wordt geopend met vier tabs: **Stappen**, **Problemen oplossen & Aanbevelingen**, **Gewijzigde eigenschappen**, en **Samenvatting**. 3. Bekijk de **Samenvatting** om te bevestigen of de actie is geslaagd of mislukt. 4. Als het is mislukt, open **Problemen oplossen & Aanbevelingen**, waarin de uitgevoerde actie, de betrokken gebruikers-principalnaam en — onder **Details** — de foutcode en de volledige foutmelding die door Zoom's API is geretourneerd. Dit is betrouwbaarder dan het inspecteren van het mappingscherm, omdat het de letterlijke waarden toont die zijn verzonden in plaats van wat de mapping bedoeld was te produceren. Als het Entra-logboek geen uitsluitsel geeft, ga dan verder naar de Zoom App Marketplace-bellenlogboeken, beschreven onder **Verificatie aan Zoom-zijde en veelvoorkomende fouten**, die de ruwe request- en response-uitwisseling tonen. #### Onboarding- en offboardinggedrag in Entra ID * Bereik is de belangrijkste veiligheidscontrole. Gebruikers buiten het toewijzingsbereik van de applicatie worden in deze configuratie nooit gewijzigd door een mapping. * Het deactiveren van een gebruiker in Entra, of het verwijderen van die gebruiker uit het bereik, draait provisioning automatisch terug en sluit de offboardinglus. * Elke fout levert een overeenkomstige logvermelding op — met de hierboven genoemde kanttekening over stille fouten. ### Stap 7: Pas de referentiescenario's toe in Entra ID De scenario's, vereisten en attribuutdefinities staan in de [**Referentiescenario's**](#reference-scenarios) sectie. Alleen de Entra-mappings worden hier gegeven. **Scenario 0 — Afdeling.** Bij Stap 1, definieer `urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:afdeling` als **String**, waarbij u ervoor zorgt dat u de naamruimte van Onderneming gebruikt in plaats van die van Zoom. Koppel het toe als **Direct** uit de Entra `department` veld. Geen **Standaardwaarde indien null** is nodig — een leeg bronveld verzendt simpelweg niets, en er hoeft geen object aan de Zoom-zijde te bestaan. **Scenario 1 — Zoom Phone-locatie en automatische extensie.** Koppel `zoomPhoneLocatie` als **Direct** van `physicalDeliveryOfficeName`, met **Standaardwaarde indien null** ingesteld op `Hoofdlocatie`. Koppel `zoomPhoneExtNumber` als **Constante** met een waarde van `0` tenzij u een bestaande configuratie van extensies migreert. Wanneer waarden voor kantoorlocatie niet exact overeenkomen met de Zoom-locatienamen, vervang dan een **Expressie** mapping in de vorm zoals getoond in Stap 2. **Scenario 2 — Belabonnement dat per land varieert.** Omdat Entra geen waarde uit een Groep kan ophalen, is een expressie vereist. Breid deze uit met extra `IIF()` lagen per land, en account voor zowel de alpha-2- als de volledige tekstformaten zoals beschreven in Stap 2: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", IIF(ToUpper([country])="US","200", IIF(ToUpper([country])="UNITED STATES","200", "-1")))) ``` Waar het belabonnementkenmerk de betaalde rechten toewijst, Selecteer **Basis** in plaats van **Met licentie** bij Stap 3. Selecteren **Met licentie** past daarnaast de Standaard licentie van het account toe, wat mogelijk niet het beoogde commerciële resultaat is. **Scenario 3 — contactcenter Pakket, Rol en regio.** Koppel `zoomContactCenterPackage` met een **Expressie** gestuurd door een directoryveld dat agentniveaus onderscheidt, en `zoomContactCenterRole` als **Direct** uit een veld met de rolnaam. verlaten `zoomContactCenterRegion` niet gekoppeld in implementaties met één regio. ## **SCIM configureren met Okta** #### Aanvullende vereisten voor Okta * Okta-beheerderrechten met toegang tot de Profile Editor #### Aanvullende beperkingen in Okta * Wanneer een gebruiker tot meerdere Groepen behoort die conflicterende waarden voor hetzelfde attribuut leveren, wordt alleen de waarde van de Groep met de hoogste prioriteit verzonden. Zie stap 5. {% hint style="warning" %} **Let op: Twee profielen, twee doeleinden** Okta onderhoudt hier twee verschillende profielen die van belang zijn, en het begrijpen van het onderscheid voorkomt de meeste verwarring in het begin. De **Okta-gebruikerprofiel** is waar een waarde wordt *opgeslagen* bij een persoon in de directory. De **Zoom-gebruikersapplicatieprofiel** is waar een waarde wordt *verzonden* naar Zoom, en de attributen ervan dragen de SCIM externe naam en namespace. Een configuratie per gebruiker heeft beide nodig, plus een Verbinden ertussen. Een configuratie op Groep-niveau heeft alleen het attribuut van het applicatieprofiel nodig, met de waarde ingesteld op de Groepstoewijzing. {% endhint %} ### Stap 1: Definieer het attribuut op het Zoom-applicatiegebruikersprofiel Dit is het attribuut dat daadwerkelijk een waarde naar Zoom verzendt. Het declareren ervan is een eenmalige actie per attribuut. 1. Aanmelden bij de Okta Beheerdersconsole. 2. Klik in het linkernavigatiemenu op **Toepassingen**, klik vervolgens op **Toepassingen**. 3. Onder **STATUS**, klik **Actief**. 4. Klik op de **Zoom** applicatie.\ **Opmerking**: De applicatienaam wordt gedefinieerd door de Okta-beheerder wanneer de applicatie wordt gemaakt. Deze heet vaak **Zoom**, maar kan afwijken in uw tenant. 5. Klik op de **Provisionering** Tabblad. 6. Onder **Zoom-attribuuttoewijzingen**, klik **Ga naar Profile Editor**. 7. Onder **Attributen**, klik **+ Attribuut toevoegen**. 8. Vul het volgende in: * **Gegevenstype**: Selecteer **tekenreeks** of **boolean**, in overeenstemming met de SCIM2 API-referentie. * **Weergavenaam**: Invoeren van de attribuutnaam, bijvoorbeeld `zoomPhoneLocatie`. * **Variabelenaam**: Invoeren van dezelfde naam. * **Externe naam**: Invoeren van de attribuutnaam precies zoals door Zoom gedocumenteerd, bijvoorbeeld `zoomPhoneLocatie`. * **Externe namespace**: Invoeren `urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSite` * **Beschrijving** (Optioneel): Opnemen waarom het attribuut bestaat en waar de waarden vandaan komen. * **Attribuuttype**: Selecteer **Persoonlijk** voor een waarde per gebruiker, of **Groep** voor een waarde die is overgenomen via lidmaatschap van een Groep. 9. Klik op **Opslaan**, of **Opslaan en nog een toevoegen**. {% hint style="danger" %} **Waarschuwing** De Externe naam en Externe namespace moeten beide correct zijn. De gepubliceerde richtlijnen van Zoom specificeren de Externe namespace als de volledige URN *inclusief* de attribuutnaam — bijvoorbeeld `urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomRevenueAcceleratorRole` — in plaats van alleen de naamruimte. Dit verschilt van de algemene SCIM-conventie. Volg het bovenstaande formaat, omdat het de configuratie weerspiegelt die Zoom documenteert als werkend. Attribuutnamen zijn overal hoofdlettergevoelig. Een attribuut met onjuiste hoofdletters wordt zonder fout geaccepteerd door de Profieleditor en mislukt stilzwijgend bij de Zoom API. {% endhint %} ### Stap 2: Maak een bronattribuut aan in het Okta-gebruikersprofiel Voltooi deze stap waar de waarde per gebruiker wordt opgeslagen. Sla deze over als de waarde voor elke gebruiker identiek is, of als deze in plaats daarvan op Groep-niveau wordt aangeleverd. 1. Klik in het linkernavigatiemenu op **Map**, klik vervolgens op **Profieleditor**. 2. Klik op de **Gebruikers** Tabblad. 3. In het **Gebruikers** vak, onder **Filters**, klik **Alle**. 4. Rechts van **Okta**, klik op de **Gebruiker** profiel. 5. Onder **Attributen**, klik **+ Attribuut toevoegen**. 6. Vul het volgende in: * **Gegevenstype**: Komt overeen met het Zoom-attribuut dat in Stap 1 is opgegeven. * **Weergavenaam** en **Variabelenaam**: Invoeren van een naam, bijvoorbeeld `zoomPhoneLocatie`. * **Enum** (Optioneel): Selecteer **Definieer een opgesomde lijst met waarden** waar het Zoom-attribuut alleen een vaste set waarden accepteert. * **Attribuut vereist** (Optioneel): Selecteer **Ja** waar elke gebruiker binnen het bereik een waarde moet hebben. 7. Klik op **Opslaan**. {% hint style="info" icon="lightbulb" %} **Tip** Gebruik dezelfde naam voor het Okta-gebruikerprofielattribuut en het Zoom-applicatieprofielattribuut. Okta vereist dit niet, maar overeenkomende namen maken de mappinglijst zelfdocumenterend en verkorten de probleemoplossingstijd aanzienlijk naarmate het aantal attributen groeit. {% endhint %} Gebruik de **Enum** optie overal waar Zoom een vaste waardenset documenteert — contactcenterpakketten, Workplace-bundelcodes, planwaarden voor Revenue Accelerator. Het beperken van het veld bij invoer voorkomt dat een typfout een stille provisioningfout wordt die weken later aan het licht komt als een ontbrekend recht. ### Stap 3: Koppel het bronattribuut aan het Zoom-attribuut 1. Navigeer naar **Toepassingen** → **Toepassingen** → **Actief** → de **Zoom** applicatie. 2. Klik op de **Provisionering** Tabblad. 3. Onder **Zoom-attribuuttoewijzingen**, zoek het attribuut dat in Stap 1 is gedefinieerd en klik op het bewerkpictogram rechts ervan.\ **Opmerking**: Als het attribuut niet zichtbaar is, klik op **Weergeven van niet-gemapte kenmerken**. 4. Klik op de **Attribuutwaarde** keuzelijst en Selecteer **Koppel vanuit Okta-profiel**. 5. Klik op de bronkeuzelijst — die wordt weergegeven als `login | tekenreeks` Standaard — en Selecteer het Okta-gebruikerprofielattribuut dat in Stap 2 is gemaakt. 6. Selecteer **Maak aan en werk bij**.\ **Opmerking**: **Alleen maken** past de waarde toe wanneer de Zoom gebruiker voor het eerst wordt ingericht en nooit meer. Selecteer deze bewust, voor waarden die na de eerste toewijzing niet mogen worden overschreven; Selecteer **Maak aan en werk bij** in alle andere gevallen, zodat wijzigingen in de directory worden doorgegeven. 7. Klik op **Opslaan**. 8. Herhaal dit voor elk attribuut. {% hint style="warning" %} **Let op: een waarde afleiden of vertalen** Wanneer de Okta-waarde en de Zoom-waarde niet dezelfde tekenreeks zijn, accepteert het **Attribuutwaarde** veld ook Okta Expression Taal, die voorwaardelijke logica en tekenreeksfuncties ondersteunt. De expressiesyntaxis en Beschikbaar functies verschillen per Okta-release; valideer elke expressie bij één testgebruiker met behulp van **Voorbeeld** voordat u deze breder toepast, en raadpleeg de actuele documentatie van Okta over Expression Taal voor ondersteunde functies. Wanneer de vertaling eenvoudig is en de waardenset klein, is het doorgaans beter onderhoudbaar om de Zoom-waarde rechtstreeks op het Okta-attribuut als een opgesomde lijst te definiëren — of een attribuut op Groep-niveau te gebruiken, zoals in stap 5 — dan een expressie te gebruiken. {% endhint %} ### Stap 4: Inschakelen van provisioning voor de applicatie Attribuuttoewijzingen hebben geen effect totdat de overeenkomstige provisioningbewerkingen zijn ingeschakeld. Schakel ze in voordat u waarden toewijst in stap 5. 1. Navigeer naar **Toepassingen** → **Toepassingen** → **Actief** → de **Zoom** applicatie. 2. Klik op de **Provisionering** Tabblad. 3. Onder **Provisioning naar app**, klik **Bewerken**. 4. Inschakelen van de hieronder beschreven Instellingen, klik vervolgens op **Opslaan**. | Instelling | Effect | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Gebruikers maken** | Maakt een gebruiker in Zoom aan of koppelt een gebruiker eraan wanneer de applicatie wordt toegewezen aan een gebruiker in Okta. | | **Gebruikerskenmerken bijwerken** | Werkt de kenmerken van een gebruiker in Zoom bij wanneer de applicatie wordt toegewezen. Latere wijzigingen in het Okta-gebruikersprofiel overschrijven automatisch de overeenkomstige waarde in Zoom. | | **Gebruikers deactiveren** | Deactiveert het Zoom-account wanneer de applicatie in Okta niet meer is toegewezen, of wanneer het Okta-account wordt gedeactiveerd. Accounts kunnen opnieuw worden geactiveerd door de applicatie opnieuw toe te wijzen. | {% hint style="danger" %} **Waarschuwing** **Gebruikerskenmerken bijwerken** is wat ervoor zorgt dat aangepaste attribuutkoppelingen effect hebben op bestaande gebruikers. Zonder dit zijn koppelingen alleen van toepassing op het moment van het aanmaken van de gebruiker, en elke daaropvolgende wijziging in Okta bereikt Zoom niet. {% endhint %} ### Stap 5: Waarden Toewijzen aan gebruikers of groepen **Een waarde Toewijzen aan een individuele gebruiker:** 1. Navigeer naar **Map** → **Personen** en klik op de naam van de gebruiker. 2. Klik op de **Profiel** Tabblad, klik vervolgens op **Bewerken**. 3. Vul het attribuut dat in Stap 2 is gemaakt in met de waarde die Zoom verwacht. 4. Klik op **Opslaan**. De waarde wordt snel verzonden. Bevestig het resultaat in het Zoom-webportal voordat u dezelfde wijziging breder toepast. **Een waarde Toewijzen aan een Groep** — het schaalbaardere patroon waarbij de configuratie de organisatiestructuur volgt: 1. Controleer of het attribuut in Stap 1 is gedeclareerd met **Attribuuttype: Groep**. Als het was gedeclareerd als **Persoonlijk**, declareer dan een equivalent op Groep-niveau door Stap 1 te herhalen voor de **Zoom-gebruiker** profiel onder **Map** → **Profieleditor** → **Gebruikers** → **Alle**, en selecteer **Groep** als het attribuuttype. 2. Navigeer naar **Map** → **Groepen** → de **Alle** Tabblad, klik vervolgens op **Groep Toevoegen**. 3. Voer een **Naam** en Optioneel **Beschrijving**, klik vervolgens op **Opslaan**. 4. Open de Groep en klik op de **Toepassingen** Tabblad. 5. Klik op **Applicatie Toewijzen**, klik vervolgens op **Toewijzen** rechts van de **Zoom** applicatie. 6. Vul de attributen op Groep-niveau in met de waarden die op elk Lid/leden van toepassing moeten zijn. 7. Klik op **Opslaan en teruggaan**, klik vervolgens op **Gereed**. 8. Klik op het tabblad van de Groep **Personen** Tabblad, klik vervolgens op **Personen Toewijzen**. 9. Zoek naar gebruikers op voornaam, primair E-mailadres of Gebruikersnaam, en klik op de knop Toevoegen naast elk van hen. 10. Klik op **Gereed**. Leden erven automatisch de attribuutwaarden van de Groep. Gebruikers die later worden Toegevoegd, erven deze bij toetreding, waardoor dit patroon duurzaam is voor doorlopende Onboarding in plaats van een eenmalige migratie. #### Groepsprioriteit lost conflicterende waarden op wanneer een gebruiker tot meerdere groepen behoort Wanneer een gebruiker Lid/leden is van meer dan één Groep die een waarde voor hetzelfde attribuut levert, verzendt Okta de waarde van de Groep met de hoogste prioriteit. 1. Navigeer naar **Toepassingen** → **Toepassingen** → **Actief** → de **Zoom** applicatie. 2. Klik op de **Toewijzingen** Tabblad. 3. Onder **Filters**, klik **Groepen**. 4. Sleep de groepen in de beoogde volgorde. {% hint style="info" %} **Aanbeveling** Rangschik groepen van meest specifiek naar meest algemeen, zodat een groep met een smalle scope — een bepaalde locatie of Rol — voorrang krijgt op een brede allesomvattende optie. Het omkeren van deze volgorde zorgt ervoor dat de algemene Groep elke specifieke overschrijft, wat zich doorgaans uit als een hele populatie die dezelfde onbedoelde configuratie krijgt. {% endhint %} ### Stap 6: Verifiëren met behulp van het Okta-systeemlogboek 1. Navigeer naar **Rapporten** → **Systeemlogboek**. 2. Filter op de doelgebruiker of op de Zoom-applicatie, en beperk het tijdsbereik tot de provisioningpoging. 3. Open het relevante Evenement en bekijk de details, waaronder de uitkomst en eventuele fout die is geretourneerd door de downstream-applicatie. Niet-opgeloste provisioningfouten verschijnen ook op het tabblad van de Zoom-applicatie. **Provisionering** Tabblad. Waar het Okta-logboek geen uitsluitsel geeft, ga naar de Zoom App Marketplace-gesprekslogboeken die worden beschreven onder **Verificatie aan Zoom-zijde en veelvoorkomende fouten**, die de ruwe request- en response-uitwisseling tonen. {% hint style="warning" %} **Opgelet: de stilzwijgende fout specifiek voor Okta** Een attribuut dat is gedeclareerd op het Zoom-gebruikersprofiel maar nooit is gekoppeld, of is gekoppeld zonder **Gebruikerskenmerken bijwerken** ingeschakeld in Stap 4, verzendt niets terwijl het zichtbaar blijft in de lijst met toewijzingen. Er wordt geen fout gegenereerd. Als een waarde Zoom niet bereikt en het Systeemlogboek helemaal geen overeenkomstig Evenement laat zien, controleer dan de koppeling en de provisioninginstellingen voordat u verder onderzoekt. {% endhint %} #### Onboarding- en offboardinggedrag in Okta * Bereik is de primaire veiligheidscontrole. Gebruikers aan wie de Zoom-applicatie in Okta niet is toegewezen, worden door geen enkele toewijzing in deze configuratie gewijzigd. * Met **Gebruikers deactiveren** ingeschakeld, deactiveert het onttoewijzen van de applicatie of het deactiveren van het Okta-account het Zoom-account automatisch. * Het opnieuw Toewijzen van de applicatie activeert een eerder gedeactiveerd Zoom-account opnieuw, waardoor groepslidmaatschap een haalbaar mechanisme wordt voor het beheren van vertrekkers en terugkeerders. ### Stap 7: Pas de referentiescenario's toe in Okta De scenario's, vereisten en attribuutdefinities staan in de [**Referentiescenario's**](#reference-scenarios) sectie. Alleen de Okta-configuratie wordt hier gegeven. **Scenario 0 — Afdeling.** Declareer het attribuut in Stap 1 met **Weergavenaam** en **Variabelenaam** `department`, **Externe naam** `department`, en **Externe namespace** `urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker`. Gebruik **Attribuuttype: Persoonlijk**. Okta's basisgebruikersprofiel bevat al een `department` attribuut, dus stap 2 kan worden overgeslagen — koppel het rechtstreeks in stap 3, door te selecteren **Maak aan en werk bij**. {% hint style="warning" %} **Let op: Namespace-indeling voor attributen van de Onderneming-extensie** De WAARSCHUWING bij stap 1 beschrijft de conventie van Zoom om de attribuutnaam toe te voegen aan de externe namespace. Die richtlijn is gedocumenteerd voor attributen onder de Zoom-extensie. `department` behoort tot de Standaard SCIM-ondernemingsextensie, waar Okta's normale gedrag is om de namespace en de externe naam in afzonderlijke velden te houden, zoals hierboven getoond. Als de waarde Zoom niet bereikt, probeer dan de toegevoegde vorm — `urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:afdeling` — en bevestig welke vorm succesvol was in het Marketplace-oproeplogboek. {% endhint %} **Alternatieven als `department` al is toegewezen.** Elk van de volgende opties gedraagt zich identiek, staat onder dezelfde bovenliggende en heeft geen voorwaarden — vervang de attribuutnaam in zowel de **Externe naam** en de namespace, en gebruik Toevoegen om een overeenkomend bronattribuut in stap 2 toe te voegen als het Okta-profiel er nog geen bevat: | Attribuut | Notities | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `kostenplaats` | Zakelijk veld, varieert tussen gebruikers zodat een onjuiste waarde zichtbaar is | | `Organisatie` | Vaak identiek voor alle gebruikers, waardoor een fout moeilijker op te sporen is | | `employeeNumber` | Vaak al gemapt als een identiteitsveld — controleer dit voordat u het declareert | | `voornaamwoorden` | Bevindt zich onder de **Zoom** extensie in plaats van de Onderneming-extensie, dus gebruikt het dezelfde namespace als elk ander scenario in deze handleiding en omzeilt het de bovenstaande formatvraag volledig | **Scenario 1 — Zoom Phone-locatie en automatische extensie.** Definieer `zoomPhoneLocatie` met **Attribuuttype: Groep** en stel de waarde ervan in op de Okta-Groep van elke locatie, zodat lidmaatschap van de Groep de locatie rechtstreeks bepaalt en er geen vertaallogica nodig is. Definieer `zoomPhoneExtNumber` als een persoonlijk attribuut met een Standaardwaarde van `0` tenzij u een reeds bestaande configuratie van extensies migreert. **Scenario 2 — Belabonnement dat per land varieert.** Definieer `zoomPhoneCallingPlan` met **Attribuuttype: Groep** en maak voor elke regio van het belabonnement één Groep aan, en stel de planwaarde in op de Zoom-applicatietoewijzing van elke Groep. Gebruikers erven het juiste plan via lidmaatschap, en de waarde die in Okta is opgeslagen is exact de waarde die Zoom verwacht. Dit maakt de configuratie ook zichtbaar en controleerbaar vanuit het **Toewijzingen** Tabblad, en het overleeft inconsistenties in hoe de onderliggende directorygegevens zijn gevuld. Een Groep met `-1` biedt een nette manier om belabonnementrechten in te trekken zonder de gebruiker te verwijderen. **Scenario 3 — contactcenter Pakket, Rol en regio.** Definieer `zoomContactCenterPackage` als een opgesomd attribuut dat beperkt is tot de drie toegestane waarden, zodat een ongeldig Pakket nooit kan worden ingevoerd. Definieer `zoomContactCenterRole` als een attribuut op Groep-niveau, omdat Rol doorgaans de teamsstructuur volgt. verlaten `zoomContactCenterRegion` niet gekoppeld in implementaties met één regio. ## Probleemoplossing ### Fouten #### Gebruiker bestaat niet of behoort niet tot dit account Deze fout treedt op wanneer het E-mailadres van een beoogde gebruiker niet kan worden geprovisioned vanwege een al bestaand account. Zoom-beheerders worden aangemoedigd om rechtstreeks contact op te nemen met de gebruiker en de gebruiker handmatig uit te nodigen voor het account.

Voorbeeld van een provisioningfout.

#### Toevoegen van betaalde gebruikers is niet mogelijk Deze fout treedt op wanneer SCIM probeert een gebruiker te provisionen terwijl er onvoldoende licenties op het account zijn. Om de fout op te lossen, moet de gebruiker als Basisgebruiker worden geprovisioned, of moet er een licentie Beschikbaar worden gemaakt voor provisioning.

Voorbeeld van een provisioningfout.

### SCIM-logboeken gebruiken om problemen met gebruikersprovisioning op te lossen Zoom biedt de meest recente 100 API-verzoeklogboeken in de [Zoom Marketplace](https://marketplace.zoom.us/). Een Zoom-beheerder kan deze logs gebruiken om te bevestigen welke informatie wordt verzonden en ontvangen via provisioning-API's. Meld u aan bij Zoom Marketplace als Zoom-beheerder en klik op om toegang te krijgen tot de logs **Beheren**. Op de volgende pagina, Selecteer **Bellenlogboeken** onder **Persoonlijk app-beheer**. Vanaf daar klikt u op een item om de API-logboeken uit te vouwen en de inhoud te bekijken. De volgende afbeelding toont een voorbeeld van een SCIM-aanvraag voor gebruikersprovisioning, met de identiteit en licentieattributen van de gebruiker gemarkeerd ter referentie.

Voorbeeld van een SCIM-gebruikerprovisioningverzoek.

Net als bij responsmapping kan Zoom alleen informatie toepassen die in het inrichtingsverzoek vanuit de identiteitsprovider wordt ingediend. Gebruik deze logboeken om te bevestigen dat gebruikersidentiteit- en licentieattributen vanuit de identiteitsprovider worden ingediend. Als verwachte informatie ontbreekt in deze verklaringen, neem contactpersoon op met uw identiteitsprovider voor ondersteuning. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://library.zoom.com/technical-library/nl/beheerdershoek/account-and-endpoint-management/scim-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.