SCIM-veldgids voor Entra ID en Okta
Een gids voor het maken van aangepaste SCIM-toewijzingen tussen Entra ID of Okta en Zoom
Overzicht
Zoom's SCIM2 API biedt toegang tot een uitgebreide catalogus van gebruikerattributen die licenties, productentitlements, rollen, regio's en configuratie per service aansturen. De standaard provisioningintegraties voor zowel Microsoft Entra ID als Okta mappen slechts een klein deel hiervan — genoeg om gebruikers te maken, bij te werken en te deactiveren, maar niet genoeg om Zoom Phone-locaties, contactcenterpakketten, rollen in Revenue Accelerator of een van de tientallen andere attributen die Zoom ondersteunt te provisionen.
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, wordt het onderliggende model uitgelegd, zodat beheerders een attribuut kunnen opzoeken in de SCIM2 API-referentie van Zoom en dit zelfstandig kunnen Configureer, zonder te wachten tot er een productspecifiek artikel wordt gepubliceerd.
Hoe u deze handleiding gebruikt
Lees de Inleiding, beginnend met SCIM-attributen begrijpen eerst, samen met de secties die erop volgen — voorwaarden, directorygegevens, referentiescenario's en Verificatie aan Zoom-zijde. Deze zijn van toepassing ongeacht welke identity provider (IdP) u gebruikt. Doorloop vervolgens de sectie Microsoft Entra ID of Okta, afhankelijk van welke u gebruikt. Elk van die delen is compleet vanaf de eerste configuratiestap tot en met Verificatie en uitgewerkte voorbeelden; u hoeft niet tussen beide te schakelen.
Raadpleeg voor de fundamentele SSO- en SCIM-concepten die ten grondslag liggen aan deze handleiding de SSO-veldgids, de Zoom SSO- en provisioningartikel voor Entra ID, en de Zoom SSO-artikel voor Okta.
Waarschuwing
Verkeerd geconfigureerde provisioning heeft invloed op bestaande gebruikers, inclusief het verwijderen van licenties die al in gebruik zijn. Valideer elke Wijzigen tegen een enkele gebruiker in een testomgeving voordat u deze toepast op een live populatie.
Vereisten voor het gebruik van SCIM
Alles in dit onderdeel is van toepassing, ongeacht de identiteitsprovider. Lees dit voordat u verdergaat naar uw identiteitsprovider-specifieke instructies.
Vereisten die gemeenschappelijk zijn voor beide identiteitsproviders
Zakelijk, Onderwijs of Onderneming Zoom-account met een goedgekeurde vanity-URL
Zoom-account Eigenaar- of beheerderrechten
Single Sign-On ingeschakeld op het Zoom-account
A geverifieerd gekoppeld domein 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
De Zoom licentie, plan, Add-on(s) of configuratieobject dat wordt toegewezen, moet al bestaan en Beschikbaar zijn op de Zoom-account
Identiteitsprovider-specifieke vereisten staan aan het begin van elke betreffende sectie vermeld.
Beperkingen die voor beide identiteitsproviders gelden
SCIM wijst alleen bestaande rechten toe; het kan de objecten waarnaar het verwijst niet aanmaken. Zie de sectie Voordat u geavanceerde mapping probeert, moeten objecten aan de Zoom-kant bestaan voordat SCIM ernaar kan verwijzen hieronder.
Sommige attributen accepteren slechts één waarde per gebruiker. Een Zoom Phone belabonnement is één voorbeeld — add-on pakketten zoals de Customer Engagement Pack kunnen niet worden ingericht via SCIM.
De
gebruikerstypeattribuut is door Zoom gedocumenteerd als gepland voor uitfasering.
Inleiding
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 configureren dat dat recept beschrijft. Dit gedeelte behandelt de opbouw. Het toewijzen van een attribuut aan een gegevensbron komt later, in de secties over de identiteitsprovider.
Elk attribuut heeft een naamruimte, een naam, een gegevenstype en een toegestane waarde
Laten we beginnen met een volledig, werkend voorbeeld. Hier is de Identificatie voor het toewijzen van een gebruiker aan een Zoom Phone-locatie:
Vier eigenschappen van dit attribuut spelen een rol. Twee daarvan zijn zichtbaar in de regel hierboven. De andere twee komen uit de API-referentie en worden later ergens anders ingevoerd in je identiteitsprovider. Voor onze onmiddellijke doeleinden richten we ons op twee: de Naamruimte en de Naam.
Naamruimte
urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker
Vertelt Zoom tot welk schema de instelling behoort, en fungeert als de gedeelde basis voor bijna elk Zoom-product en elk licentieattribuut. Aan Zoom doorgegeven als de eerste helft van de Identificatie.
Naam
zoomPhoneLocatie
Identificeert 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.
Gegevenstype
tekenreeks
Vertelt uw identiteitsprovider 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 waarde
LON-01, een naam van een Zoom Phone-locatie
De instelling die daadwerkelijk op de gebruiker wordt toegepast. Vrije tekst voor sommige kenmerken, een vaste set voor andere — Essentials, Premium, of Elite voor Zoom contactcenter bijvoorbeeld. Doorgegeven aan Zoom op het moment van provisioning, geleverd door de mapping in plaats van de Identificatie.
Waarschuwing
Zoom publiceert meer dan één naamruimte voor gebruiker-extensies. Productconfiguratie- en licentieattributen gebruiken urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker, die de naamruimte is die deze gids overal gebruikt. Standaard Onderneming-velden zoals department, manager, en kostenplaats gebruiken urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker. Een derde, urn:us:Zoom:scim:schemas:extension:1.0:Zoomgebruiker, bevat informatie over het aanmeldingstype die wordt teruggegeven in API-responses in plaats van geconfigureerd tijdens provisioning. Een attribuut dat op de verkeerde namespace is opgebouwd, wordt door uw identiteitsprovider geaccepteerd en stilzwijgend genegeerd door Zoom.
Zoek het attribuut dat u nodig hebt in de SCIM2 API-referentie
De SCIM2 API-referentie 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. Aanmaken gebeurt één keer per persoon, maar attribuutwijzigingen (Wijzigen) gebeuren continu — een verhuizing van kantoor, een planwijziging (Wijzigen), een rolwijziging (Rol), een vertrekkende medewerker — dus het meeste 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 heeft geen reden om op te nemen, zoals bij het instellen zoomPhoneCallingPlan om -1 om alle belabonnementen 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 request-body het
urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruikerobject. Elk attribuut dat in deze gids wordt behandeld, staat daarin vermeld.Zoek je attribuut op naam en opnemen zijn gegevenstype en zijn toegestane waarden.
Lees de beschrijving ernaast. Beschrijvingen bevatten gedrag dat u niet kunt afleiden uit de attribuutnaam —
zoomPhoneExtNumberingesteld op0triggert automatische extensietoewijzing,zoomPhoneCallingPlaningesteld op-1verwijdert alle belplannen, enzoomPhoneNumbermoet verwijzen naar een nummer dat al niet is toegewezen in het Zoom-account.
Het samenstellen van de Identificatie: ouder, dubbele punt, kind
Alles vermeld daarin 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 bovenliggende benoemen, een dubbele punt toevoegen en vervolgens de onderliggende toevoegen:
Dat is de hele constructie. Er is geen opzoektabel om van Zoom op te vragen en niets om te genereren — de Identificatie is twee dingen die je al hebt, samengevoegd met een dubbelepunt.
De bovenliggende blijft hetzelfde; alleen de onderliggende verandert
Omdat de bovenliggende vaststaat, is het configureren van een tweede, vijfde of vijftiende attribuut dezelfde handeling met een ander onderliggend element eraan toegevoegd:
Dezelfde bovenliggende omvat elk ander Zoom-product. Niets aan de constructie verandert wanneer het product dat wel doet:
U leert dus de ouder één keer. Vanaf dat moment betekent het configureren van een nieuw attribuut dat u in de API-referentie alleen nog drie dingen opzoekt: de naam van het kind, het gegevenstype en de toegestane waarden.
Als u een parent en een child kunt samenstellen, ligt het moeilijkste deel van deze configuratie al achter u. Wat overblijft, is uw identity provider te vertellen waar elke waarde vandaan moet komen — behandeld in de volgende secties over Entra ID en Okta — en te bepalen welke attributen u als eerste aanpakt, wat daarna wordt behandeld.
Twee soorten mapping: Basis en geavanceerd
Niet elk attribuut brengt hetzelfde risico met zich mee, en het is de moeite waard om ze te sorteren voordat u iets configureert.
Deze gids hanteert de termen Basis en geavanceerde van de SSO-veldgids, die voor SAML-responsmappeling dezelfde scheidslijn trekt. De termen beschrijven wat Zoom met de waarde doet bij aankomst, niet hoe moeilijk het attribuut is om te Configureer. Mechanisch zijn de twee identiek: beide worden gedocumenteerd in dezelfde Werk een gebruiker bij request body, beide zijn opgebouwd met dezelfde parent-colon-child-constructie, en beide worden gedeclareerd en gemapt via dezelfde stappen in Entra ID en Okta.
Basis mappeling schrijft tekst naar het profiel van een gebruiker. Zoom slaat de waarde exact op zoals verzonden en controleert die nooit tegen iets.
Geavanceerde mappeling legt een claim op het account. Zoom neemt de waarde en zoekt naar een overeenkomend object, of naar een vrije plek in een aangeschaft abonnement — en die opzoeking kan mislukken.
Wat de waarde is
Tekst opgeslagen op het profiel van de gebruiker
Een verwijzing naar een object in Zoom, of een claim op een gekochte stoel
Voorbeelden
department, titel, kostenplaats
zoomPhoneLocatie, zoomContactCenterRole, zoomWorkplace
Ouder
Op het hoogste niveau, of de Onderneming-extensie
De Zoom-extensie
Voorwaarden vooraf in Zoom
Geen
Het object moet bestaan, of de stoel moet vrij zijn
Als de waarde onjuist is
Onjuiste tekst verschijnt op een profiel
Het attribuut wordt geweigerd of stilzwijgend genegeerd
Het onderscheid stuurt twee praktische beslissingen aan. Het bepaalt wat u eerst in Zoom moet opzetten — niets voor Basis-mapping, mogelijk heel veel voor geavanceerd — en het bepaalt wat een fout kost. Een onjuist departement is een cosmetische fout op een profiel. Een onjuiste locatie naam of een niet-beschikbare licentieplek laat een gebruiker achter zonder werkende telefoon of zonder het product dat hij of zij was 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 precies op zoals verzonden en valideert die nooit tegen een bestaand object, dus er hoeft vooraf niets in Zoom te worden aangemaakt en er kan niets stukgaan als een waarde onjuist is.
Kernidentiteitsvelden zijn meestal al gemapt. Gebruikersnaam, name.givenName, name.familyName, displayName, en emails staan op het hoogste niveau van de request body zonder bovenliggende waarde, 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 zijn ook op het hoogste niveau, maar moeten mogelijk worden toegevoegd.
Velden van de Onderneming gebruiken een tweede bovenliggend element. De constructie Wijzigen niet — alleen de ouder doet dat:
Het invullen van Afdeling en Kostenplaats via SCIM vereist geen SAML-mapping meer.
Geavanceerde toewijzing: productconfiguratie en rechten
Geavanceerde toewijzing wijst de zaken 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 kenmerken bevinden zich onder de bovenliggende Zoom-extensie die in deze handleiding overal wordt gebruikt.
Het relevante verschil 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 seat die Beschikbaar is. Waar basiskoppeling tekst op een profiel schrijft, doet geavanceerde koppeling een aanspraak op de configuratie en inventaris van het account, en die aanspraak kan mislukken.
Daarom wijdt deze handleiding een volledige sectie aan voorwaarden. Elk geavanceerd attribuut is afhankelijk van iets dat eerst is gebouwd of aangeschaft in het Zoom-webportal, en de foutmodi 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 elk bedieningselement verschilt.
1. Declareren
Vertel de identiteitsprovider dat het attribuut bestaat in de Zoom-applicatie, zodat het Beschikbaar wordt als toewijzingsdoel.
Stap 1
Stap 1
2. Koppelen
Bepaal waar de waarde vandaan komt.
Stap 2
Stappen 2–3
3. Bereik
Bepaal op welke gebruiker de configuratie van toepassing is en wanneer deze wordt uitgevoerd.
Stappen 3–5
Stappen 4–5
Zodra dit patroon wordt begrepen, 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 architectonische verschil met de meeste gevolgen tussen de twee trajecten, en het verklaart waarom dezelfde Zakelijk-gerelateerde vereiste verschillende configuraties oplevert tussen Entra en Okta.
Entra ID haalt waarden alleen uit attributen van het gebruiker-object. Een waarde moet afkomstig zijn uit een veld op de gebruiker — een bestaand directoryveld of een Speciaal gebouwd uitbreidingsattribuut. 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 ofwel het gebruikersprofiel of een Groep-toewijzing. Een attribuut declareren met Attribuuttype: Groep maakt het mogelijk de waarde één keer op een Groep in te stellen en door elk Lid/leden te laten erven. Wanneer configuratie de organisatiestructuur volgt, vervalt daarmee de noodzaak voor vertaallogica volledig.
Geen van beide benaderingen is universeel beter, maar ze leiden tot verschillende configuraties.
Zoom-zijde Voorconfiguratievereisten
Voordat u geavanceerde mapping probeert, moeten objecten aan de Zoom-kant bestaan voordat SCIM ernaar kan verwijzen
SCIM is een toewijzingsmechanisme, geen creatiemechanisme — het verbindt een gebruiker met configuratie die al bestaat op het Zoom-account, en het kan niet die configuratie namens de gebruiker opbouwen.
Een groot deel van de geavanceerde toewijzingsattributen is verwijzingen: van de verzonden waarde wordt verwacht dat deze wordt omgezet naar een object dat al bestaat in Zoom — een Locatie, een Rol, een sjabloon, een aangeschaft abonnement, een specifiek nummer of extensie. Eén regel geldt voor allemaal:
Als een attribuut een object benoemt, moet dat object al bestaan, precies gespeld zijn zoals verzonden, en — wanneer het uit een eindige voorraad put — moet het ongebruikte Capaciteit hebben.
Wanneer een verwezen object niet bestaat, maakt SCIM het noch aan, noch zet het de aanvraag in de wachtrij. Het attribuut mislukt dan direct, met de fout teruggegeven in het provisioninglog, of wordt stilzwijgend genegeerd — Zoom accepteert de payload, past niets toe en rapporteert succes.
De onderstaande secties splitsen de voorwaarden per product op, met het navigatiepad en het artikel voor ondersteuning voor het bouwen van elk daarvan. Lees eerst de notities op accountniveau en daarna de sectie voor elk product dat u wilt provisioneren.
Voorwaarden op accountniveau gelden voordat elk product wordt geprovisioneerd
De accountvereisten die aan het begin van deze handleiding worden genoemd — vanity-URL, SSO, SCIM-autorisatie en een geverifieerde Gekoppelde domeinen — zijn voorwaarden voor elk attribuut dat volgt. Alle vier worden geconfigureerd onder Geavanceerd → Beveiliging / Single Sign-On / Gekoppelde domeinen; zie Zoom + Microsoft Entra ID SSO/SCIM-configuratie.
Nog twee punten verdienen het om expliciet te worden vermeld:
Het kopen van een seat is niet hetzelfde als deze toewijzen. SCIM voert de toewijzing uit, maar de seat moet eerst bestaan. Zie Zoom-licenties toewijzen aan of verwijderen van gebruikers.
Seats moeten behoren tot het exacte aangevraagde abonnement. Het verzenden van een licentiekenmerk wanneer dat specifieke abonnement geen vrije seats heeft, mislukt zelfs als een ander abonnement in het account reserve-Capaciteit toont.
Zoom Phone
Zoom Phone bevat de grootste set referentiekenmerken omdat een Telefoongebruiker wordt samengesteld uit verschillende onderdelen van vooraf gekochte of vooraf gebouwde infrastructuur.
De Zoom Phone-licentie zelf
Een beschikbare Zoom Phone-seat — het vereiste recht voordat iets hieronder kan worden gekoppeld.
Koop vooraf. Zie Zoom Phone-licenties kopen en toewijzen.
zoomPhoneLocatie
De locatie, met exact dezelfde naam als de verzonden waarde. Als u het kenmerk weglaat, wordt de hoofdlocatie van het account toegewezen, die standaard bestaat zodra Meerdere sites zijn ingeschakeld.
Beheercentrum → Productconfiguratie → Telefoonsysteem → Bedrijfsinformatie → Locatie toevoegen, of Importeren voor het in bulk maken. Zie Meerdere sites beheren.
zoomPhoneNumber
Het nummer, gekocht of naar het account geporteerd en momenteel niet toegewezen. Een nummer dat al in bezit is van een andere gebruiker, oproepwachtrij of automatische receptionist kan niet opnieuw worden gebruikt.
Beheercentrum → Productconfiguratie → Nummers → Telefoonnummers. Koop of porteer hier en laat het doelnummer niet toegewezen zodat SCIM het kan claimen. Zie Nummerbeheer gebruiken voor het beheren van Telefoonnummers en Telefoonnummers beheren.
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.
Beheercentrum → Productconfiguratie → Telefoonsysteem → Gebruikers en ruimtes → Selecteer het object met het toestelnummer → Profiel → toestelnummer → Bewerken. Zie Instellingen voor Telefoongebruiker wijzigen.
zoomPhoneCallingPlan
Het belabonnement, gekocht en met beschikbare Capaciteit, waarnaar wordt verwezen met de exacte abonnementscode.
Koop vooraf. Zie Zoom Phone-licenties kopen en toewijzen en Telefoongebruikers beheren. Abonnementscodes staan vermeld in de Referentie voor Zoom Phone-belabonnementen, of geretourneerd als type door de Belabonnementen weergeven API naast beschikbare seat-aantallen.
zoomPhoneCallingPlanSubscription (alleen accounts met meerdere abonnementen)
Het specifieke abonnement waaruit het belabonnement moet putten, wanneer het account meer dan één abonnement voor hetzelfde belabonnement heeft.
Abonnementen en Facturering → abonnementenbeheer.
De pool met toestelnummers wordt gedeeld tussen objecttypen, niet alleen tussen gebruikers. Oproepwachtrijen, automatische receptionisten, groepen met gedeelde lijnen en telefoons in gemeenschappelijke ruimten gebruiken allemaal toestelnummers uit hetzelfde bereik. Dit is de meest voorkomende oorzaak van fouten met "toestelnummer al in gebruik", omdat het toestelnummer vrij lijkt wanneer een beheerder alleen de gebruikerslijst controleert.
Een geporteerd nummer kan pas worden toegewezen wanneer het porteren is voltooid. Het nummer moet zowel presenteren in het account als niet toegewezen zijn; het starten van een portering voldoet aan geen van beide voorwaarden.
Sites zijn de meest voorkomende blokkade omdat het maken ervan eigen vereisten met zich meebrengt. Locatie-adressen worden gevalideerd aan de hand van een echte adresdatabase, omdat ze de basis vormen voor noodoproepdiensten — verzonnen combinaties van adres en postcode worden afgewezen met een validatiefout. 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 vooral van toepassing op de VS en Canada en kan leeg worden gelaten als dit een validatiefout veroorzaakt.
Zoom contactcenter
contactcenter-provisioning is Rol- en template-gestuurd. Individuele attributen moeten verwijzen naar bestaande contactcenterobjecten, en de template bevat de Instellingen die geen eigen SCIM-attribuut hebben.
zoomContactcenterpakket
Het Pakket — Essentials, Premium, of Elite — gekocht met ongebruikte zitplaatsen.
Kopen vooraf; Premium vereist mogelijk dat u eerst contact opneemt met Zoom-ondersteuning om extra pakketten te Kopen. Zie Zoom contactcenter gebruiker Instellingen wijzigen.
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 deze weglaat, wordt de Standaard Agent Rol toegewezen, die Standaard bestaat.
contactcenterbeheer → Rollen → Toevoegen → Configureer machtigingen → Opslaan. Zie Beheren van Zoom contactcenterrollen.
ZoomContactCenterRegio
De regio. Als u deze weglaat, wordt de hoofdregio van het account toegewezen, die moet worden geconfigureerd.
Beheer van contactcenter → Voorkeuren → Regio's → Toevoegen Regio → Invoeren van een naam en Selecteer een SIP-zone → Toevoegen. Zie Zoom contactcenterregio's beheren.
ZoomContactCentergebruikerTemplate
Het gebruikerssjabloon, exact zo genoemd. Sjablonen van het type Toevoegen worden toegepast bij het aanmaken van een gebruiker; sjablonen van het type Update worden toegepast bij een update.
Beheer van contactcenter → gebruiker → Sjablonen → Toevoegen Sjabloon → Kies Toevoegen → Configureer rollen, pakketten, wachtrijen en vaardigheden → Toevoegen. Zie Sjabloon voor het beheren van de Instellingen van Zoom Contactcenter-gebruikers.
Waarschuwing
De Functie(s) voor Contactcenterregio's moet door Zoom-ondersteuning worden ingeschakeld voordat regio's kunnen worden gemaakt, en elke gebruiker behoort tot precies één regio. Omdat dit een ondersteuningsverzoek is in plaats van zelfbediening via In-/uitschakelen, moet dit vroeg worden aangekaart als een implementatie in meerdere regio's is gepland.
Postvakken, wachtrijen en vaardigheden hebben geen SCIM-kenmerk. Om deze in te richten, bouwt u ze vooraf in Contactcenterbeheer, koppelt u ze aan een sjabloon voor een gebruiker en wijst u dat sjabloon toe via ZoomContactCentergebruikerTemplateZe worden daarom voorwaarden voor het sjabloon in plaats van voor de afzonderlijke gebruiker — waardoor het sjabloon ook het enige object wordt dat moet worden onderhouden wanneer die vereisten veranderen via Wijzigen.
Wachtrij
contactcenterbeheer → wachtrijen → Toevoegen wachtrij → naam, kanaal, agenten → Opslaan. Zie Zoom contactcenterwachtrijen beheren.
Vaardigheid
contactcenterbeheer → vaardigheden → Selecteer een categorie → Toevoegen vaardigheid → naam → Toevoegen. Zie Vaardigheden en vaardigheidscategorieën beheren.
Postvak IN
Contactcenterbeheer → Inbox → Inbox toevoegen. Zie Beheren van Zoom contactcenter-inboxen.
Wanneer zowel een sjabloon als afzonderlijke kenmerken worden opgegeven, krijgen de afzonderlijke waarden voorrang. Een sjabloon meesturen naast zoomContactCenterRole betekent dat het Rol-attribuut de Rol-instelling van het sjabloon overschrijft, dus zowel de gerefereerde Rol als het sjabloon moeten bestaan.
Zoom Revenue Accelerator
zoomRevenueAcceleratorPlan en zoomRevenueAcceleratorSubscription
Het aangeschafte ZRA-plan of -abonnement met een Beschikbaar zitje.
Kopen vooraf; accountplan en Factureringsgegevens.
zoomRevenueAcceleratorRol
De Rol, Standaard of aangepast — bijvoorbeeld Verkoopmanager — exact benoemd.
Gebruikersbeheer → Rol → Omzetversneller Tabblad → + Toevoegen Rol → naam en beschrijving → Toevoegen → Configureer machtigingen → Wijzigingen opslaan. Zie Gebruik van Zoom Revenue Accelerator Rollenbeheer.
zoomRevenueAcceleratorSegment
Het segment waartoe de gebruiker behoort.
Instellingen voor de beheerder van Revenue Accelerator.
zoomRevenueAcceleratorRegion
De regio — bijvoorbeeld, US.
Instellingen voor de beheerder van Revenue Accelerator.
Zoom Workplace-licenties en accountrollen
Naast de drie producten hierboven bevat het standaardgebruikersopnemen rol- en licentieverwijzingen die dezelfde regel volgen.
rollen[] (waarde / weergeven)
De account Rol, exact benoemd. Rollen worden door SCIM gerefereerd, nooit door SCIM aangemaakt.
Gebruikersbeheer → Rol → Toevoegen Rol → naam en beschrijving → Configureer machtigingen. Zie Rollenbeheer gebruiken.
zoomWorkplace en andere licentie- of Add-on(s)-kenmerken — whiteboard, Scheduler, Clips Plus, vertaalde ondertiteling, Workforce Management, Quality Management, naleving Management, CX Insights, AI Verkoop Assist, en hun ...Abonnement tegenhangers
De bijbehorende bundel of Add-on(s), aangekocht met ongebruikte zitplaatsen.
Plannen en Facturering → Planbeheer → bewerk het plan → verhoog het aantal licenties. Zie Je account en add-ons upgraden.
inlogtype (sso / werkE-mail), onder urn:us:Zoom:scim:schemas:extension:1.0:Zoomgebruiker
SSO geconfigureerd op het account, voor het SSO-inlogtype.
Geavanceerd → Single Sign-On.
Voor een licentie of Add-on(s)-attribuut is er geen object om te benoemen, maar de noodzakelijke voorwaarde is identiek in effect: zonder een beschikbare plek in die specifieke pool, mislukt de toewijzing.
Kenmerken zonder voorwaarde
Elk basis toewijzingskenmerk 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 kenmerken onder de Zoom-extensie gedragen zich op dezelfde manier:
Automatisch gedelegeerde waarden —
zoomPhoneExtNumberverzonden als0, waarbij Zoom de extensie zelf toewijst.Aangepaste accountkenmerken — de
{customAttribute}veld, dat elke tekenreeks bevat die je verzendt.
Standaard ingestelde verwijzingen vormen een tussengeval: weglaten zoomPhoneLocatie, zoomContactCenterRole, of ZoomContactCenterRegio valt respectievelijk terug op de hoofdlocatie, de standaard Agent Rol en de hoofdregio. Die standaardwaarden moeten zelf bestaan, en dat doen ze standaard.
Groepen vormen een gedeeltelijke uitzondering. Wanneer groepsvoorziening is ingeschakeld, maakt SCIM een Zoom Groep aan die nog niet bestaat, met de naam van de bron-Groep precies zoals getypt. Er wordt geen productconfiguratie op die Groep toegepast — de Groep wordt geleverd met leden en verder niets. Zoom Phone-beleid, belrechten en andere instellingen op Groepniveau moeten na het verschijnen van de Groep nog steeds worden geconfigureerd onder Gebruikersbeheer → Groepbeheer.
Je directorygegevens voorbereiden
SCIM verzendt precies wat de bron bevat. Het valideert, normaliseert of corrigeert niets. Controleer vóór het toewijzen van een attribuut drie dingen over de beoogde bron:
Het is ingevuld voor elke gebruiker binnen het toepassingsgebied. Een ongevuld veld verstuurt niets, of verstuurt de geconfigureerde Standaard.
De waarden zijn consistent in formaat en hoofdlettergebruik. De vergelijkingslogica in beide identiteitsproviders is exact.
De waarden komen exact overeen met de verwachte waarden van Zoom. Zoom doet geen fuzzy-match op locatienamen, Rollenamen 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 gevuld duurzamer dan het hergebruiken van een veld waar ook andere systemen naar schrijven.
Referentiescenario's
Vier scenario's worden in deze gids gebruikt. Hun zakelijke vereisten en de vereisten aan de Zoom-zijde zijn ongeacht de identiteitsprovider identiek, dus worden ze hier één keer gedefinieerd. Elk identiteitsprovider-specifiek gedeelte sluit af met een uitleg over hoe u ze alle vier in dat Platform implementeert.
Scenario 0: Afdeling, als eerste Basis-mapping
De afdeling van een gebruiker moet op zijn Zoom-profiel verschijnen, afkomstig uit de directory. Dit is de Basis-mapping die eerder als een eerste end-to-end test werd aanbevolen, en deze is hier opgenomen zodat de procedure in beide secties van de identiteitsprovider wordt doorlopen.
Voorwaarde aan de Zoom-zijde. Geen. Zoom slaat de waarde exact op zoals verzonden en valideert deze nooit tegen een bestaand object.
Attribuut. Merk op dat de bovenliggende verschilt van de drie onderstaande scenario's — department bevindt zich onder de Onderneming-extensie, niet onder de Zoom-extensie.
urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:afdeling
tekenreeks
Vrije tekst. Beide identiteitsproviders hebben al een department veld op het gebruikersprofiel, dus er is geen nieuw bronattribuut nodig.
Waarom hier beginnen. Een afdelingswaarde die correct op een Zoom-profiel verschijnt, bewijst de schemadeclaratie, de toewijzing, het bereik en uw vermogen om de provisioninglogboeken te lezen — zonder een licentie of een telefoonconfiguratie in gevaar te brengen. Elk geavanceerd scenario hieronder verschilt alleen in waarnaar het attribuut verwijst.
Controleer eerst of het al is toegewezen. Standaardtoewijzingen verschillen tussen Entra ID en Okta, en ze Wijzigen wanneer beide leveranciers hun Zoom-integraties bijwerken. Bekijk de bestaande lijst onder Provisionering → Toewijzingen in Entra, of Zoom-attribuuttoewijzingen met Weergeven niet-toegewezen kenmerken ingeschakeld in Okta. Als department al is toegewezen, controleer het in plaats van een duplicaat te declareren — en als je in plaats daarvan een attribuut vanaf nul wilt Configureer, kostenplaats, Organisatie, en personeelsnummer zitten onder dezelfde bovenliggende entiteit en zich identiek gedragen.
Scenario 1: Zoom Phone-locatie en automatische toewijzing van toestelnummer
Gebruikers moeten op basis van hun kantoor in de juiste Zoom Phone-locatie worden geplaatst en zonder tussenkomst van een beheerder een toestelnummer ontvangen.
Voorwaarde aan de Zoom-zijde De locaties moeten al bestaan. Maak ze aan onder beheerder centrum → Productconfiguratie → Telefoonsysteem → Bedrijfsinformatie → 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 adres en postcode zullen de validatie niet doorstaan.
Attributen. Beide nemen de naamruimte urn:ietf:params:scim:schemas:extension:Zoom:1.0:gebruiker: gevolgd door de naam.
zoomPhoneLocatie
tekenreeks
Moet teken voor teken overeenkomen met de naam van de Zoom-locatie
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 bellenwachtrijen en automatische receptionisten in plaats van aan gebruikers. Door de toewijzing aan Zoom te delegeren, verdwijnt een hele categorie implementatiefouten. Extensies uit de directory halen is daarentegen geschikt tijdens een migratie, wanneer het behoud van bestaande extensienummers belangrijk is, maar de toewijzing moet overschakelen naar 0 zodra de migratie is voltooid, zodat toekomstige nieuwe gebruikers niet afhankelijk zijn van directorygegevens die onbeperkt moeten worden onderhouden.
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 krijgt dat overeenkomt met hun land.
Voorwaarde aan de Zoom-zijde. De belabonnementen moeten al zijn aangeschaft en Beschikbaar zijn op het account. Planwaarden zijn gedocumenteerd in de Referentie voor Zoom Phone-belabonnementen.
Attribuut. zoomPhoneCallingPlan (string).
Hoe u de juiste plancode krijgt. zoomPhoneCallingPlan neemt de numerieke plancode, niet een plannaam. De meest betrouwbare manier om die te verkrijgen is de Belabonnementen weergeven API, die van elk belabonnement de naam, zijn type — de code die u koppelt — en zijn geabonneerd en Beschikbaar seat-aantallen. Eén bellen bevestigt dus dat het abonnement bestaat, geeft je de te verzenden waarde en verifieert dat er Capaciteit is om het toe te wijzen.
Het Zoom-webportal toont alleen weergeven namen, nooit codes, dus een beheerder die alleen vanuit het portal werkt, moet de weergeven naam vertalen met behulp van de Referentie voor Zoom Phone-belabonnementen — waar bijvoorbeeld, UNLIMITED_PLAN_US_CA is 200 en UNLIMITED_PLAN_GB_IE is 202. De referentie vermeldt constantnamen in plaats van de bewoording van het portal, dus bevestig de overeenkomst op basis van plankenmerken — regio, en gemeten versus onbeperkt — in plaats van op exacte tekst.
Afzonderlijk toont de SCIM2 API-referentie van Zoom een Facturering-plannaam zoals phone_calling_usca_monthly_unlimited in de voorbeeldpayload. Die Identificatie wordt gebruikt om Kopen een abonnement te Kopen, niet om een plan aan een gebruiker toe te wijzen. Als je moet specificeren op welk abonnement een plan is gebaseerd, hoort dat in zoomPhoneCallingPlanSubscription.
Waarom -1 wordt gebruikt als fallback. De SCIM2-referentiedocumenten -1 als de waarde die alle belplannen verwijdert. Door dit voor niet-overeenkomende gebruikers te gebruiken, ontstaat een deterministische, zichtbare uitkomst — geen plan toegewezen — in plaats van de ambiguïteit 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
Contactcenter-agenten moeten worden geprovisioneerd met het juiste ZCC Pakket en de juiste Rol op het moment van Onboarding, in plaats van achteraf handmatig te worden geconfigureerd. Dit scenario laat zien dat de methode productonafhankelijk is — niets aan de procedure verandert, alleen de attribuutnamen en toegestane waarden.
zoomContactcenterpakket
tekenreeks
Essentials, Premium, Elite
zoomContactCenterRole
tekenreeks
Elke ZCC Rolnaam. Standaard ingesteld op Agent als dit wordt weggelaten.
ZoomContactCenterRegio
tekenreeks
Elke geconfigureerde ZCC-regio. Standaard ingesteld op de hoofdregio als dit wordt weggelaten.
Over het opzettelijk weglaten van attributen. verlaten ZoomContactCenterRegio niet-toegewezen laten in implementaties met één regio, waar Zooms gedocumenteerde Standaard al correct is. Een attribuut weglaten waarvan de Standaard juist is, verdient de voorkeur boven het toewijzen ervan — elke toewijzing is een onderhoudsverplichting.
Operationele opmerking. De SCIM2-referentie documenteert ook ZoomContactCentergebruikerTemplate, dat een vooraf gebouwde ZCC-sjabloon toepast. Sjablonen van het Toevoegen-type worden toegepast bij het aanmaken van een gebruiker en sjablonen van het update-type bij een update; wanneer zowel een sjabloon als afzonderlijke attribuutwaarden in dezelfde aanvraag worden meegeleverd, hebben de afzonderlijke waarden voorrang. Sjablonen zijn het overwegen waard wanneer de ZCC-configuratie complex genoeg is dat het onderhoud ervan over veel afzonderlijke attribuuttoewijzingen onhandelbaar wordt.
Verificatie aan de Zoom-kant en veelvoorkomende fouten
Elke identiteitsprovider heeft zijn eigen log, behandeld in stap 6 van elke identiteitsprovider. De onderstaande log aan de Zoom-kant is voor beide identiek en is de definitieve registratie van wat Zoom daadwerkelijk heeft ontvangen.
De bellenlogboeken van de Zoom App Marketplace weergeven de volledige aanvraag- en reactie-uitwisseling
Aanmelden bij het Zoom-webportal als de accounteigenaar.
Navigeer naar het Zoom App Marketplace → Beheren → Apps op het account.
Selecteer de applicatie die de identiteitsproviderverbinding vertegenwoordigt. Voor Entra heet deze doorgaans Azure Identity of iets dergelijks.
Open het bellenlogboeken Tabblad.
Gebruik Zoek op Eindpunt, of gebruik de filters voor datumreeks, methode en status om de betreffende belactie te vinden.
Selecteer de rij om deze uit te vouwen.
Controleren
requestBodyom precies te zien wat er is verzonden, enresponseom precies te zien wat Zoom heeft teruggegeven, inclusief de gegenereerde Zoom-gebruikers-ID,httpStatus, en de resulterende attribuutset.
Zoom bewaart de 100 meest recente API-aanvraaglogboeken, dus onderzoek een fout meteen in plaats van pas nadat verdere provisioningactiviteit deze heeft verdrongen.
Veelvoorkomende provisioneringsfouten en hun oorzaken
400
Account heeft Single Sign-On niet ingeschakeld.
SSO is een vereiste voor SCIM. Schakel SSO eerst in en Configureer het op het Zoom-account.
400
Gebruiker is inactief of vergrendeld.
De doel-Zoom-gebruiker kan in de huidige status niet worden bijgewerkt. Los de accountstatus op in het Zoom-webportal.
403
Het verzoek is geweigerd vanwege onvoldoende machtigingen: "Gebruiker:Edit".
De inloggegevens achter de SCIM-verbinding missen het vereiste bereik. Autoriseer de verbinding opnieuw met een Eigenaar- of beheerder-account.
404
Gebruiker bestaat niet.
De identiteitsprovider heeft de gebruiker niet gekoppeld aan een bestaande Zoom-gebruiker. Controleer het overeenkomende kenmerk en de Gebruikersnaam-indeling.
409
Het 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 inrichting.
409
Kan geen betalende gebruikers Toevoegen.
Er is geen licentie van het aangevraagde type Beschikbaar. Gratis Capaciteit op het account, of richt de gebruiker in als Basis.
409
Er kunnen niet meer gebruikers met [bundelnaam] worden gemaakt.
De specifieke bundel heeft geen resterende plaatsen. Van toepassing op Workplace Zakelijk Plus, Onderneming Premier, Pro Plus en de equivalenten voor Onderwijs.
429
Te veel aanvragen.
De inrichting heeft de snelheidslimieten van Zoom overschreden. Onderzoek dit als het gedurende cycli aanhoudt.
Eén faalmodus veroorzaakt helemaal geen fout.
Een waarde die Zoom accepteert maar die met niets overeenkomt — een locatienaam met een spatie aan het einde, of een Rolnaam die sindsdien in Zoom is hernoemd — kan syntactisch worden geaccepteerd en op niets worden toegepast. Geen logboekvermelding markeert dit voorval. Platformspecifieke varianten van hetzelfde probleem worden behandeld in stap 6.
Configuratie van SCIM met Entra ID
Aanvullende vereisten voor Entra ID
Beheerdersrechten voor Entra ID 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
Attributentoewijzingen komen uitsluitend uit Entra gebruikerobject attributen. Beveiligingsgroepen kunnen niet rechtstreeks een waarde aan een Zoom-attribuut leveren; groepslidmaatschap bepaalt het bereik, niet de waarde.
Incrementele provisioningcycli worden ongeveer elke 40 minuten uitgevoerd. Wijzigingen zijn niet onmiddellijk zodra provisioning is ingeschakeld.
De
Samenwerkingwaarde vangebruikerstypewordt niet ondersteund met Entra ID vanwege een Microsoft -specifieke beperking.
Stap 1: Declareer het kenmerk in het Zoom-applicatieschema
Het declareren van een attribuut is een eenmalige actie per attribuut. Declareer elk attribuut dat u wilt gebruiken voordat u een van de toewijzingen configureert, zodat alle doelen Beschikbaar zijn bij Stap 2.
Aanmelden bij de Azure Portal met de URL van de schema-editor:
https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#homeOnder Azure-services, Selecteer Microsoft Entra ID.
In het navigatiemenu aan de linkerkant, onder Beheren, klik Onderneming-applicatie(s).
Klik in de lijst met toepassingen op uw Zoom applicatie. Opmerking: De applicatienaam wordt gedefinieerd door de Entra-beheerder wanneer de applicatie wordt gemaakt. Het wordt vaak genoemd Zoom of Zoom SSO, maar kan verschillen in uw tenant.
In het navigatiemenu aan de linkerkant, onder Beheren, klik Provisionering. Opmerking: Azure toont momenteel een van twee indelingen. In de verouderde ervaring, Selecteer Bewerk toewijzingen van kenmerken onder Provisioning beheren. In de nieuwere ervaring opent de pagina op een Overzicht Tabblad; Selecteer Provisionering opnieuw vanuit het linkermenu. Beide routes leiden naar dezelfde bestemming.
Klik op de Toewijzingen dropdown, klik vervolgens Microsoft Entra ID-gebruikers inrichten. Opmerking: Bij tenants die nog de oude naamgeving tonen, verschijnt deze optie als Azure Active Directory-gebruikers toewijzen.
Selecteer in de linkerbenedenhoek de Weergeven geavanceerde opties selectievakje.
Klik Bewerk attributenlijst voor Zoom.
Scroll naar de eerste lege rij en voltooi het volgende:
Naam: Invoeren van de volledige attribuutreeks, bijvoorbeeld
urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSiteType: Selecteer Tekenreeks of Booleaans, overeenkomend met het gegevenstype zoals gedocumenteerd in de SCIM2 API-referentie.
Herhaal stap 9 voor elk extra attribuut.
Klik in de linkerbovenhoek op Opslaan.
Opgelet
Attribuutnamen zijn hoofdlettergevoelig en moeten exact overeenkomen met de API-referentie. zoomPhoneLocatie is geldig; zoomphonesite en ZoomPhoneSite zijn dat niet. Een attribuut met onjuist hoofdlettergebruik wordt door de schema-editor zonder fout geaccepteerd en mislukt stilzwijgend bij de Zoom API.
Voor kenmerken die zijn gedocumenteerd als boolean, Tekenreeks is ook geldig, mits de toegewezen bron de letterlijke tekst levert true of false. Selecteren Tekenreeks is vaak praktischer wanneer de bron een Entra-extensieattribuut is, dat tekst opslaat.
Stap 2: Koppel een directorybron aan het attribuut
Entra ID biedt drie toewijzingstypen, en de keuze daartussen is de meest bepalende beslissing in de configuratie.
Direct
Een Entra-veld bevat al de exacte waarde die Zoom verwacht.
Geeft de bronwaarde ongewijzigd door.
Constante
Elke gebruiker binnen de scope moet dezelfde waarde ontvangen.
Verzendt een vaste waarde naar elke geprovisioneerde gebruiker.
Expressie
De waarde moet worden afgeleid, vertaald of gevarieerd op basis van een gebruikersattribuut.
Evalueert een expressie tegen bronvelden en verzendt het resultaat.
Om de toewijzing te maken:
Ga terug naar Provisionering → Toewijzingen → Microsoft Entra ID-gebruikers inrichten.
Klik linksonder op Toevoegen nieuwe toewijzing.
Configureer de toewijzing volgens het geselecteerde type — zie de richtlijnen hieronder.
Klik op de Doelattribuut dropdown en selecteer het attribuut dat in stap 1 is opgegeven.
Klik op de Objecten overeen laten komen met behulp van dit attribuut dropdown 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.Klik op de Pas deze toewijzing toe dropdown en selecteer Altijd, zodat de waarde zowel bij het aanmaken als bij latere updates wordt toegepast.
Klik OK.
Herhaal dit voor elk attribuut en klik vervolgens op Opslaan bovenaan de attribuuttoewijzing pagina.
Directe mapping geeft een bestaand veld door zonder transformatie
Toewijzingstype: Direct
Bronattribuut: Een Entra-veld waarvan de waarde al exact overeenkomt met wat Zoom verwacht, teken voor teken
Standaardwaarde als null (Optioneel): Een terugvaloptie die wordt toegepast wanneer het bronveld leeg is
Directe mapping is de minst kwetsbare optie en verdient de voorkeur waar de directorygegevens dit ondersteunen. Als physicalDeliveryOfficeName — weergegeven als Office Locatie op het Entra-gebruikersprofiel — bevat al waarden die exact overeenkomen met de namen van Zoom Phone-locaties, dus directe toewijzing vereist helemaal geen logica.
Constante mapping past één waarde toe op de volledige populatie binnen scope
Toewijzingstype: Constante
Constante waarde: De vaste waarde die moet worden verzonden
Constante mapping is geschikt voor implementaties met één configuratie en vormt 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 op het moment van provisioning
Toewijzingstype: Expressie
Expressie: Een genestelde
IIF()instructie die een of meer bronattributen evalueert
Expressiemapping is vereist telkens wanneer de directorywaarde en de Zoom-waarde niet dezelfde tekenreeks zijn:
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, veroorzaakt geen fout — deze valt door naar de Standaardtak en de gebruiker wordt stilzwijgend met de verkeerde configuratie ingericht.
Zet bronwaarden tussen ToUpper() en vergelijk ze met hoofdletters om inconsistentie in hoofdlettergebruik te neutraliseren:
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.
Gebruiks locatie wordt door Microsoft afgedwongen om altijd een geldige ISO 3166-1 alpha-2-code te bevatten, zoals
GB, omdat het de beschikbaarheid van licenties en Functie(s) bepaalt. Dit veld is betrouwbaar.Land of regio kent geen dergelijke afdwinging, en de inhoud hangt af van de aanmaakmethode. Gebruikers die via de Entra beheerportal-GUI zijn gemaakt, selecteren uit een vervolgkeuzelijst met volledige landnamen, dus het veld slaat doorgaans
Verenigd Koninkrijk. Gebruikers die via CSV-import of PowerShell zijn gemaakt, worden doorgaans gevuld metGB— uit gewoonte, niet door afdwinging.
In elke tenant waar gebruikers via meer dan één methode zijn gemaakt, land zal geen consistente indeling hebben. Standaardiseer het veld voordat u de expressie bouwt, of test expliciet op beide indelingen zoals hierboven weergegeven.
Stap 3: Breng gebruikers en Groepen binnen de provisioning-scope
Toewijzing bepaalt welke gebruikers de configuratie raakt. Gebruikers buiten de toewijzingsscope van de applicatie worden nooit door een mapping beïnvloed, waardoor Toewijzing de primaire veiligheidscontrole is tijdens de uitrol.
Navigeer naar Microsoft Entra ID → Onderneming-applicatie(s) → uw Zoom-applicatie → Gebruikers en Groepen.
Klik Gebruiker/Groep Toevoegen.
Onder Gebruikers en Groepen, selecteer de beoogde gebruiker of beveiligingsgroep.
Onder Selecteer een Rol, kies de juiste Rol.
Klik Toewijzen.
In de praktijk zijn slechts twee Rolwaarden van belang. Andere opties zoals Corp en Pro zijn ofwel verouderde naamgeving die wordt uitgefaseerd, of bedoeld voor ongebruikelijke scenario's.
Basis
Voorziet de gebruiker zonder betaalde vergadering licentie. Selecteer deze wanneer een aangepast kenmerk — zoals een Zoom Phone belabonnement — verantwoordelijk is voor het Toewijzen van de betaalde entitlement.
Met licentie
Wijst het Zoom-account's Standaard licentieplan toe, bijvoorbeeld Zoom Workplace Onderneming Plus. Dit Scherm staat niet toe dat een specifieke bundel wordt gekozen; de Standaard is aan de Zoom-kant geconfigureerd.
Deze Rolselectie wordt eenmaal toegepast per gebruiker of Groep die aan de applicatie wordt toegevoegd, ongeacht hoeveel aangepaste kenmerken worden ingericht.
Om Entra-groepen als Zoom-groepen in te richten, die Standaard uitgeschakeld is:
Navigeer naar Provisionering → Toewijzingen en Selecteer Inrichten van Microsoft Entra ID-Groepen.
In-/uitschakelen Ingeschakeld om Ja.
Bevestig dat de Standaardtoewijzingen aanwezig zijn:
displayName→displayName, enleden→leden.Klik Opslaan.
Ga terug naar Gebruikers en Groepen en bevestig dat de Groep zelf aan de applicatie is toegewezen, en niet alleen de afzonderlijke leden. Groepsinrichting verwerkt alleen rechtstreeks toegewezen Groepen.
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 naam van de Entra-Groep displayName exact zoals getypt. De Groep wordt gemaakt met leden, maar zonder enige productconfiguratie. Een beheerder moet nog steeds openen Gebruikersbeheer → Groepsbeheer in het Zoom-webportal en pas de beoogde Instellingen toe — beleid op Groep-niveau voor Zoom Phone, belmachtigingen of andere productconfiguratie. SCIM richt het bestaan en lidmaatschap van een Groep in; het bepaalt niet wat die Groep binnen Zoom doet.
Stap 4: Valideren met Inrichting op aanvraag
Inrichting op aanvraag werkt onafhankelijk van de inrichtingsstatus In-/uitschakelen-schakelaar, wat precies de reden is dat het het juiste hulpmiddel voor validatie is. Elke stap tot nu toe — inclusief deze — kan worden voltooid terwijl provisioning uitgeschakeld blijft.
Navigeer naar Provisionering → Inrichtingsoverzicht.
Klik Inrichting op aanvraag.
Zoek naar een enkele testgebruiker en Inrichten.
Controleer het resultaat. Entra rapporteert de vier fasen die het uitvoert voor elk inrichtings-Evenement — Importeren, Bepaal of het binnen bereik valt, Komt overeen, en Inrichten — elk afzonderlijk uit te vouwen.
Bevestig dat de weergegeven kenmerkwaarden overeenkomen met je bedoeling.
Meld je aan bij het Zoom-webportal en bevestig dat de configuratie is toegepast.
Stap 5: Inschakelen van doorlopende provisioning
Door provisioning in te schakelen wordt de configuratie live actief voor elke gebruiker binnen bereik. Voltooi en verifieer eerst stappen 1 tot en met 4.
Navigeer naar Microsoft Entra ID → Onderneming-applicatie(s) → uw Zoom-applicatie → Provisionering → Provisionering.
In-/uitschakelen inrichtingsstatus om Aan.
Klik Opslaan.
De eerste cyclus kan ongeveer 40 minuten duren. De daaropvolgende incrementele cycli lopen ongeveer om de 40 minuten. Nieuwe toetreders, wijzigingen in kenmerken en deactiveringen worden volgens die Planning gesynchroniseerd in plaats van onmiddellijk.
Stap 6: Verifiëren met Entra-inrichtingslogboeken
Navigeer naar Microsoft Entra ID → Onderneming-applicatie(s) → uw Zoom-applicatie → Monitoren → Inrichtingslogboeken.
Zoek of filter op de testgebruiker en Selecteer vervolgens het relevante Evenement. De detailweergave wordt geopend met vier tabbladen: Stappen, Probleemoplossing en aanbevelingen, Gewijzigde eigenschappen, en Samenvatting.
Controleer de Samenvatting om te bevestigen of de actie is geslaagd of mislukt.
Als het is mislukt, open Probleemoplossing en aanbevelingen, die de uitgevoerde actie, de betrokken hoofdnaam van de gebruiker en — onder Details — de foutcode en volledige foutmelding weergeeft die door de API van Zoom zijn geretourneerd.
Dit is betrouwbaarder dan het toewijzings-Scherm te inspecteren, omdat het de letterlijke verzonden waarden weergeeft in plaats van wat de toewijzing zou moeten opleveren. Wanneer het Entra-logboek geen uitsluitsel geeft, gaat u verder met de bellenlogboeken van Zoom App Marketplace die worden beschreven onder Verificatie aan de Zoom-kant en veelvoorkomende fouten, die de onbewerkte uitwisseling van verzoeken en antwoorden weergeven.
Onboarding- en offboardinggedrag in Entra ID
Bereik is de primaire veiligheidsmaatregel. Gebruikers buiten het toewijzingsbereik van de applicatie worden nooit gewijzigd door een toewijzing in deze configuratie.
Het deactiveren van een gebruiker in Entra, of het verwijderen ervan uit het bereik, draait de inrichting automatisch terug en sluit de offboardingcyclus af.
Elke fout veroorzaakt een overeenkomstige logboekvermelding — met de hierboven vermelde waarschuwing over stille fouten.
Stap 7: Pas de referentiescenario's toe in Entra ID
De scenario's, vereisten en attribuutdefinities staan in de Referentiescenario's sectie. Alleen de Entra-toewijzingen worden hier gegeven.
Scenario 0 — Afdeling. Declareer bij stap 1 urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker:afdeling als Tekenreeks, waarbij u erop let dat u de Ondernemingsnaamruimte gebruikt in plaats van die van Zoom. Wijs dit toe als Direct uit het Entra- department veld. Geen Standaardwaarde als null is nodig — een leeg bronveld verzendt eenvoudigweg niets en er hoeft geen object aan de Zoom-zijde te bestaan.
Scenario 1 — Zoom Phone-locatie en automatische extensie. Wijs zoomPhoneLocatie als Direct toe vanuit physicalDeliveryOfficeName, met Standaardwaarde als null ingesteld op Hoofdlocatie. Wijs zoomPhoneExtNumber als Constante toe met een waarde van 0 tenzij u een reeds bestaande configuratie van extensies migreert. Wanneer waarden voor de kantoor-Locatie niet exact overeenkomen met Zoom-locatienamen, vervangt u deze door een Expressie toewijzing in de vorm die in stap 2 wordt weergegeven.
Scenario 2 — Belabonnement dat per land varieert. Omdat Entra geen waarde uit een Groep kan ophalen, is een expressie vereist. Breid deze uit met aanvullende IIF() lagen per land en houd rekening met zowel de alfa-2- als volledige tekstindelingen zoals beschreven in stap 2:
Wanneer het belabonnementattribuut de betaalde aanspraak toewijst, Selecteer Basis in plaats van Met licentie bij stap 3. Door te selecteren Met licentie wordt bovendien de Standaardlicentie van het account toegepast, wat mogelijk niet het beoogde commerciële resultaat is.
Scenario 3 — Contactcenter Pakket, Rol en regio. Wijs zoomContactcenterpakket met een Expressie gestuurd door een directoryveld dat agentniveaus onderscheidt, en zoomContactCenterRole als Direct uit een veld dat de naam van de Rol bevat. verlaten ZoomContactCenterRegio niet toegewezen in implementaties met één regio.
SCIM configureren met Okta
Aanvullende vereisten voor Okta
Beheerderrechten voor Okta met Access tot de Profieleditor
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.
Let op: twee profielen, twee doelen
Okta onderhoudt twee afzonderlijke profielen die hier van belang zijn, en begrip van de scheiding voorkomt de meeste aanvankelijke verwarring. Het Okta-gebruikersprofiel is waar een waarde wordt opgeslagen tegen een persoon in de directory. De Zoom gebruiker applicatieprofiel is waar een waarde wordt verzonden naar Zoom, en de attributen dragen de SCIM-externe naam en naamruimte. Een configuratie per gebruiker heeft beide nodig, plus een mapping om ze te Verbinden. Een configuratie op Groep-niveau heeft alleen het attribuut van het applicatieprofiel nodig, met de waarde ingesteld op de Groep-toewijzing.
Stap 1: Declareer het attribuut op het Zoom applicatie-gebruikerprofiel
Dit is het attribuut dat daadwerkelijk een waarde naar Zoom verzendt. Het declareren ervan is een eenmalige actie per attribuut.
Aanmelden bij de Okta Beheerdersconsole.
Klik in het linkernavigatiemenu op Applicaties, klik vervolgens op Applicaties.
Onder STATUS, klik Actief.
Klik op de Zoom applicatie. Opmerking: De naam van de applicatie wordt gedefinieerd door de Okta-beheerder wanneer de applicatie wordt gemaakt. Deze krijgt vaak de naam Zoom, maar kan verschillen in uw tenant.
Klik op de Provisionering Tabblad.
Onder Zoom-attribuuttoewijzingen, klik Ga naar Profile Editor.
Onder Attributen, klik + Attribuut Toevoegen.
Voltooi het volgende:
Gegevenstype: Selecteer tekenreeks of boolean, overeenkomstig de SCIM2 API-referentie.
weergeven naam: Invoeren de attribuutnaam, bijvoorbeeld
zoomPhoneLocatie.Variabelenaam: Invoeren dezelfde naam.
Externe naam: Invoeren de attribuutnaam precies zoals gedocumenteerd door Zoom, bijvoorbeeld
zoomPhoneLocatie.Externe namespace: Invoeren
urn:ietf:params:scim:schemas:extension:zoom:1.0:gebruiker:zoomPhoneSiteBeschrijving (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 wordt geërfd via lidmaatschap van een Groep.
Klik Opslaan, of Opslaan en nog een Toevoegen.
Waarschuwing
De Externe naam en Externe naamruimte moeten allebei correct zijn. De gepubliceerde richtlijnen van Zoom geven de Externe naamruimte op 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 wijkt af van de algemene SCIM-conventie. Volg de bovenstaande notatie, omdat deze de configuratie weerspiegelt die Zoom als werkend documenteert.
Attributnamen zijn overal hoofdlettergevoelig. Een attribuut met onjuiste hoofdletters wordt door de Profieleditor zonder fout geaccepteerd en mislukt stilzwijgend bij de Zoom API.
Stap 2: Maak een bronattribuut aan op het Okta-gebruikersprofiel
Voltooi deze stap wanneer de waarde per gebruiker wordt opgeslagen. Sla deze over als de waarde voor elke gebruiker identiek is, of als deze in plaats daarvan op Groepniveau wordt geleverd.
Klik in het linkernavigatiemenu op Directory, klik vervolgens op Profieleditor.
Klik op de Gebruikers Tabblad.
In het Gebruikers vak, onder Filters, klik Alles.
Rechts van Okta, klik op de gebruiker profiel.
Onder Attributen, klik + Attribuut Toevoegen.
Voltooi het volgende:
Gegevenstype: Kom overeen met het Zoom-attribuut dat in Stap 1 is gedeclareerd.
weergeven naam en Variabelenaam: Invoeren een naam, bijvoorbeeld
zoomPhoneLocatie.Opsomming (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.
Klik Opslaan.
Gebruik de Opsomming optie overal waar Zoom een vaste waardeset documenteert — contactcenter-pakketten, Workplace-bundelcodes, planwaarden voor Revenue Accelerator. Door het veld bij invoer te beperken, voorkomt u dat een typefout een stille provisioningfout wordt die weken later aan het licht komt als een ontbrekend recht.
Stap 3: Koppel het bronattribuut aan het Zoom-attribuut
Navigeer naar Applicaties → Applicaties → Actief → de Zoom applicatie.
Klik op de Provisionering Tabblad.
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 Weergeven niet-toegewezen kenmerken.
Klik op de Attribuutwaarde dropdown en selecteer Toewijzen vanuit Okta-profiel.
Klik op de brondropdown — die weergeeft
login | stringStandaard — en Selecteer het Okta-gebruikerprofielattribuut dat is gemaakt in Stap 2.Selecteer Aanmaken en bijwerken. Opmerking: Alleen aanmaken past de waarde toe wanneer de Zoom-gebruiker voor het eerst wordt ingericht en daarna nooit meer. Selecteer dit bewust voor waarden die niet moeten worden overschreven na de eerste toewijzing; Selecteer Aanmaken en bijwerken in alle andere gevallen, zodat wijzigingen in de map worden doorgevoerd.
Klik Opslaan.
Herhaal dit voor elk attribuut.
Let op: Een waarde afleiden of vertalen
Wanneer de Okta-waarde en de Zoom-waarde niet dezelfde tekenreeks zijn, de Attribuutwaarde het veld accepteert ook Okta Expression Taal, die voorwaardelijke logica en tekenreeksfuncties ondersteunt. Expressiesyntaxis en functies die Beschikbaar zijn, variëren per Okta-release; valideer elke expressie aan de hand van één testgebruiker met behulp van Voorvertoning voordat je het breder toepast, en raadpleeg de huidige documentatie van Okta over Expression Taal voor ondersteunde functies.
Wanneer de vertaling eenvoudig is en de waardeset klein is, is het meestal beter te onderhouden dan een expressie om de Zoom-waarde rechtstreeks op het Okta-attribuut te definiëren als een opgesomde lijst — of een attribuut op Groep-niveau te gebruiken, zoals in Stap 5 —.
Stap 4: Inschakelen van provisioning voor de applicatie
Attributentoewijzingen hebben geen effect totdat de bijbehorende provisioningbewerkingen zijn ingeschakeld. Inschakelen voordat u waarden toewijst in Stap 5.
Navigeer naar Applicaties → Applicaties → Actief → de Zoom applicatie.
Klik op de Provisionering Tabblad.
Onder Provisioning naar app, klik Bewerken.
Inschakelen van de hieronder beschreven Instellingen, klik vervolgens Opslaan.
gebruiker(s) aanmaken
Maakt een gebruiker aan of koppelt deze in Zoom wanneer de applicatie wordt toegewezen aan een gebruiker in Okta.
Attributen van gebruiker bijwerken
Werkt de attributen van een gebruiker bij in Zoom wanneer de applicatie wordt toegewezen. Latere Wijzigen in het Okta-gebruikersprofiel overschrijven automatisch de overeenkomstige waarde in Zoom.
gebruiker(s) deactiveren
Deactiveert het Zoom-account wanneer de applicatie in Okta niet meer is toegewezen, of wanneer het Okta-account is gedeactiveerd. Accounts kunnen opnieuw worden geactiveerd door de applicatie opnieuw toe te wijzen.
Waarschuwing
Attributen van gebruiker bijwerken is wat aangepaste attributentoewijzingen van kracht laat worden voor bestaande gebruikers. Zonder dit worden toewijzingen alleen toegepast op het moment van het aanmaken van een gebruiker, en elke latere Wijzigen in Okta bereikt Zoom niet.
Stap 5: Waarden toewijzen aan gebruikers of groepen
Om een waarde toe te wijzen aan een individuele gebruiker:
Navigeer naar Directory → Personen en klik op de naam van de gebruiker.
Klik op de Profiel Tabblad, klik vervolgens op Bewerken.
Vul het attribuut dat in Stap 2 is gemaakt in met de waarde die Zoom verwacht.
Klik Opslaan.
De waarde wordt direct verzonden. Bevestig het resultaat in het Zoom-webportal voordat u dezelfde wijziging breder toepast.
Om een waarde toe te wijzen aan een groep — het schaalbaardere patroon waarbij configuratie de organisatiestructuur volgt:
Bevestig dat het attribuut in Stap 1 is gedeclareerd met Attribuuttype: Groep. Als het als Persoonlijkis gedeclareerd, declareer dan een equivalent op Groep-niveau door Stap 1 opnieuw uit te voeren voor het Zoom-gebruiker profiel onder Directory → Profieleditor → Gebruikers → Allesen selecteer Groep als het attribuuttype.
Navigeer naar Directory → Groepen → de Alles Tabblad, klik vervolgens op Groep toevoegen.
Voer een Naam in en optioneel Beschrijving, klik vervolgens op Opslaan.
Open de groep en klik op de Applicaties Tabblad.
Klik Applicatie toewijzen, klik vervolgens op Toewijzen rechts van de Zoom applicatie.
Vul de attributen op Groep-niveau in met de waarden die op elk lid van toepassing moeten zijn.
Klik Opslaan en teruggaan, klik vervolgens op Gereed.
Klik op de groep's Personen Tabblad, klik vervolgens op Personen toewijzen.
Zoek gebruikers op voornaam, primair E-mailadres of Gebruikersnaam en klik op de Toevoegen-knop naast elk.
Klik Gereed.
Leden erven de attribuutwaarden van de groep automatisch. Gebruikers die later worden toegevoegd, erven deze bij het toetreden, 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 is van meer dan één groep die een waarde voor hetzelfde attribuut levert, verzendt Okta de waarde van de groep met de hoogste prioriteit.
Navigeer naar Applicaties → Applicaties → Actief → de Zoom applicatie.
Klik op de Toewijzingen Tabblad.
Onder Filters, klik Groepen.
Sleep de groepen in de gewenste volgorde.
Stap 6: Controleren met het Okta-systeemlogboek
Navigeer naar Rapporten → Systeemlogboek.
Filter op de doelgebruiker of op de Zoom-applicatie en beperk het tijdsbereik tot de provisioningpoging.
Open het relevante evenement en bekijk de details, waaronder het resultaat en eventuele fouten die door de downstream-applicatie worden geretourneerd.
Niet-opgeloste provisioningfouten verschijnen ook op het Tabblad van de Zoom-applicatie Provisionering Tabblad. Als het Okta-logboek geen uitsluitsel geeft, ga dan verder met de aanroeplogs van de Zoom App Marketplace die worden beschreven onder Verificatie aan de Zoom-kant en veelvoorkomende fouten, die de onbewerkte uitwisseling van verzoeken en antwoorden weergeven.
Let op: de stille, Okta-specifieke fout
Een attribuut dat op het Zoom-gebruikersprofiel is gedeclareerd maar nooit is gekoppeld, of gekoppeld zonder Attributen van gebruiker bijwerken ingeschakeld in Stap 4, verzendt niets terwijl het zichtbaar blijft in de lijst met koppelingen. Er wordt geen fout gemeld. Als een waarde Zoom niet bereikt en het Systeemlogboek helemaal geen overeenkomstig evenement toont, controleer dan de koppeling en de provisioninginstellingen voordat u verder onderzoekt.
Gedrag van Onboarding en offboarding in Okta
Scope is de primaire veiligheidscontrole. Gebruikers aan wie de Zoom-applicatie in Okta niet is toegewezen, worden door geen enkele koppeling in deze configuratie gewijzigd.
Wanneer dit gebruiker(s) deactiveren is ingeschakeld, deactiveert het ontoewijzen 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 lidmaatschap van een groep 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 sectie. Hier wordt alleen de Okta-configuratie gegeven.
Scenario 0 — Afdeling. Bij Stap 1, declareer het attribuut met weergeven naam en Variabelenaam department, Externe naam department, en Externe namespace urn:ietf:params:scim:schemas:extension:Onderneming:2.0:gebruiker. Gebruik Attribuuttype: Persoonlijk. Het basisgebruikersprofiel van Okta bevat al een department attribuut, dus Stap 2 kan worden overgeslagen — koppel er rechtstreeks vanaf in Stap 3, waarbij je selecteert Aanmaken en bijwerken.
Let op: naamruimte-indeling voor attributen van de Onderneming-extensie
De WAARSCHUWING bij Stap 1 beschrijft Zoom's conventie om de attribuutnaam toe te voegen aan de External-naamruimte. Die richtlijn is gedocumenteerd voor attributen onder de Zoom-extensie. department behoort tot de Standaard SCIM Onderneming-extensie, waarbij het normale gedrag van Okta is om de naamruimte 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 is geslaagd in het Marketplace-oproeplogboek.
Alternatieven als department al is gemapt. Elk van de volgende werkt identiek, bevindt zich onder dezelfde bovenliggende entiteit en heeft geen voorwaarden — vervang de attribuutnaam zowel in de Externe naam als in de naamruimte, en voeg bij Stap 2 een overeenkomend bronattribuut toe als het Okta-profiel er nog geen bevat:
kostenplaats
Zakelijk veld, varieert tussen gebruikers zodat een onjuiste waarde zichtbaar is
Organisatie
Vaak identiek voor alle gebruikers, waardoor een fout moeilijker op te merken is
personeelsnummer
Vaak al toegewezen als identiteitsveld — controleer dit voordat je het declareert
voornaamwoorden
Bevindt zich onder het Zoom extensie in plaats van die van Onderneming, dus gebruikt het dezelfde naamruimte als elk ander scenario in deze handleiding en vermijdt het bovenstaande vraagstuk over de indeling volledig
Scenario 1 — Zoom Phone-locatie en automatische extensie. Declareer zoomPhoneLocatie met Attribuuttype: Groep en stel de waarde in op de Okta-Groep van elke locatie, zodat lidmaatschap van de Groep de locatie rechtstreeks bepaalt en er geen vertaallogica nodig is. Declareer 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. Declareer zoomPhoneCallingPlan met Attribuuttype: Groep en maak één Groep per belabonnementregio, waarbij u de planwaarde instelt 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 te deprovisioneren zonder de gebruiker te verwijderen.
Scenario 3 — Contactcenter Pakket, Rol en regio. Declareer zoomContactcenterpakket als een opgesomd attribuut dat is beperkt tot de drie toegestane waarden, zodat een ongeldig Pakket nooit kan worden ingevoerd. Declareer zoomContactCenterRole als een attribuut op Groepniveau, aangezien Rol doorgaans de teamstructuur volgt. verlaten ZoomContactCenterRegio niet toegewezen 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.
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.
SCIM-logboeken gebruiken om problemen met gebruikersprovisioning op te lossen
Zoom biedt de meest recente 100 API-verzoeklogboeken in de Zoom Marketplace. 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.
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.
Laatst bijgewerkt
Was dit nuttig?