SCIM für Entra ID und Okta Feldleitfaden
Ein Leitfaden zum Erstellen benutzerdefinierter SCIM-Zuordnungen zwischen Entra ID oder Okta und Zoom
Überblick
Die SCIM2-API von Zoom bietet einen umfangreichen Katalog von Benutzerattributen, mit denen Lizenzen, Produktberechtigungen, Rollen, Regionen und die Konfiguration einzelner Dienste gesteuert werden. Die sofort einsatzbereiten Provisionierungsintegrationen für Microsoft Entra ID und Okta ordnen nur eine kleine Teilmenge dieser Attribute zu – ausreichend, um Benutzer anzulegen, zu aktualisieren und zu deaktivieren, aber nicht ausreichend, um Zoom Phone-Standorte, Contact Center-Pakete, Revenue-Accelerator-Rollen oder Dutzende weiterer von Zoom unterstützter Attribute bereitzustellen.
Diese Anleitung vermittelt die wiederholbare Methode zum Hinzufügen beliebig Fügen Sie das Zoom-SCIM-Attribut zu Ihrer Bereitstellungskonfiguration hinzu. Anstatt ein Attribut isoliert zu dokumentieren, erklärt es das zugrunde liegende Modell, sodass Administratoren ein Attribut in Zooms SCIM2 API-Referenz nachschlagen und es unabhängig Konfigurieren können, ohne darauf warten zu müssen, dass ein produktspezifischer Artikel veröffentlicht wird.
So verwenden Sie diesen Leitfaden
Lesen Sie die Einleitung beginnend mit SCIM-Attribute verstehen zuerst, zusammen mit den darauffolgenden Abschnitten — Voraussetzungen, Verzeichnisdaten, Referenzszenarien und Verifizierung auf der Zoom-Seite. Diese gelten unabhängig davon, welchen Identity Provider (IdP) Sie verwenden. Arbeiten Sie dann je nach verwendeter Lösung den Abschnitt zu Microsoft Entra ID oder Okta durch. Jeder dieser Teile ist vom ersten Konfigurationsschritt bis hin zur Verifizierung und zu ausgearbeiteten Beispielen vollständig; Sie müssen nicht zwischen ihnen hin- und herwechseln.
Für die grundlegenden SSO- und SCIM-Konzepte, die diesem Leitfaden zugrunde liegen, siehe die SSO-Leitfaden, der Zoom SSO- und Bereitstellungsartikel für Entra ID, und der Zoom-SSO-Artikel für Okta.
Voraussetzungen für die Verwendung von SCIM
Alles in diesem Abschnitt gilt unabhängig vom Identitätsanbieter. Lesen Sie dies, bevor Sie mit Ihren identitätsanbieterspezifischen Anweisungen fortfahren.
Gemeinsame Anforderungen für beide Identitätsanbieter
Business-, Bildung- oder Enterprise-Zoom-Konto mit einem genehmigten Vanity-URL
Kontoinhaber- oder Administratorrechte für das Zoom-Konto
Single Sign-On im Zoom-Konto aktiviert
Ein verifizierte zugehörige Domain im Zoom-Konto, passend zur E-Mail-Domäne der bereitzustellenden Benutzer
SCIM-Bereitstellung bereits zwischen dem Identitätsanbieter und Zoom eingerichtet
Die Zoom-Lizenz, der Tarif, das Add-on oder das Konfigurationsobjekt, das zugewiesen wird, muss bereits vorhanden und im Zoom-Konto Verfügbar sein.
Die an den jeweiligen Identitätsanbieter gebundenen Anforderungen sind zu Beginn des jeweiligen Abschnitts aufgeführt.
Gemeinsame Einschränkungen für beide Identitätsanbieter
SCIM weist nur vorhandene Berechtigungen zu; es kann die Objekte, auf die es verweist, nicht erstellen. Siehe den Abschnitt Bevor Sie erweiterte Zuordnungen versuchen, müssen Objekte auf der Zoom-Seite vorhanden sein, bevor SCIM auf sie verweisen kann unten.
Einige Attribute akzeptieren nur einen Wert pro Benutzer. Ein Zoom Phone-Tarif ist ein Beispiel – Add-on-Pakete wie das Customer Engagement Pack können nicht über SCIM bereitgestellt werden.
Der
BenutzertypAttribut ist von Zoom als zur Abschaffung vorgesehen dokumentiert.
Einführung
SCIM-Attribute verstehen
Administratoren, die verstehen, wie ein Zoom-SCIM-Attribut aufgebaut ist, können jedes von Zoom unterstützte Attribut Konfigurieren. Administratoren, die einem Rezept folgen, können nur das Attribut Konfigurieren, das dieses Rezept beschreibt. Dieser Abschnitt behandelt den Aufbau. Die Zuordnung eines Attributs zu einer Datenquelle erfolgt später, in den Abschnitten zum Identitätsanbieter.
Jedes Attribut hat einen Namensraum, einen Namen, einen Datentyp und einen zulässigen Wert
Lassen Sie uns mit einem vollständigen, funktionierenden Beispiel beginnen. Hier ist die Kennung zum Zuordnen eines Benutzers zu einem Zoom Phone-Standort:
Vier Eigenschaften dieses Attributs sind im Spiel. Zwei davon sind in der Zeile oben sichtbar. Die anderen beiden stammen aus der API-Referenz und werden später an anderer Stelle in Ihrem Identity Provider eingegeben. Für unsere unmittelbaren Zwecke konzentrieren wir uns auf zwei: die Namespace und der Name.
Namespace
urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer
Teilt Zoom mit, zu welchem Schema die Einstellung gehört, und dient als gemeinsame Grundlage für nahezu jedes Zoom-Produkt und jedes Lizenzattribut. Wird an Zoom als die erste Hälfte der Kennung übergeben.
Name
zoomPhoneSite
Identifiziert die konkrete Zoom-Einstellung, die geschrieben wird — hier den Zoom Phone-Standort des Benutzers. Wird an Zoom als die zweite Hälfte der Kennung übergeben. Groß-/Kleinschreibung ist relevant.
Datentyp
Zeichenkette
Teilt Ihrem Identitätsanbieter mit, welche Art von Wert das Attribut enthält, damit es korrekt gespeichert und formatiert wird. Wird nicht als Teil der Kennung übergeben; separat deklariert als Typ in Entra ID oder Datentyp in Okta.
Zulässiger Wert
LON-01, ein Name des Zoom Phone-Standorts
Die Einstellung, die tatsächlich auf den Benutzer angewendet wird. Freitext für einige Attribute, eine feste Menge für andere — Grundlagen, Premium, oder Elite für Zoom Contact Center beispielsweise. Wird zum Zeitpunkt der Bereitstellung an Zoom übergeben und von der Zuordnung statt von der Kennung bereitgestellt.
Suchen Sie in der SCIM2 API-Referenz nach dem Attribut, das Sie benötigen
Der SCIM2 API-Referenz ist die maßgebliche Liste aller Dinge, die Zoom während der Bereitstellung akzeptiert. Zwei Operationen sind wichtig: Benutzer erstellen und Benutzer aktualisieren.
Arbeite hauptsächlich von Benutzer aktualisieren. Die Erstellung passiert nur einmal pro Person, aber Attribut Ändern passieren kontinuierlich — ein Büroumzug, eine Plan Ändern, eine Rolle Ändern, ein Austritt — daher sind die meisten Dinge, die Provisioning im Laufe der Zeit tatsächlich tut, Aktualisierungen. Benutzer aktualisieren dokumentiert auch die Entfernungswerte, die Benutzer erstellen keinen Grund hat einzuschließen, wie etwa das Festlegen zoomPhoneCallingPlan zu -1 um alle Anrufpläne von einem Benutzer zu entfernen.
Um ein Attribut zu finden:
Öffne die SCIM2 API-Referenz und gehe zu Benutzer aktualisieren.
Im Anforderungskörper suche das
urn:ietf:params:scim:schemas:extension:zoom:1.0:BenutzerObjekt. Jedes Attribut, das in diesem Leitfaden behandelt wird, ist darin aufgeführt.Finden Sie Ihr Attribut anhand des Namens und zeichnen Sie sein Datentyp und seine zulässigen Werte.
Lesen Sie die Beschreibung daneben. Beschreibungen enthalten Verhaltensweisen, die Sie nicht aus dem Attributnamen ableiten können —
zoomPhoneExtNumbergesetzt auf0löst die automatische Durchwahlzuweisung aus,zoomPhoneCallingPlangesetzt auf-1entfernt alle Anrufpläne undzoomPhoneNumbermuss auf eine Nummer verweisen, die im Zoom-Konto bereits nicht zugewiesen ist.
Zusammensetzen der Kennung: Elternteil, Doppelpunkt, Kind
Alles, was darin aufgelistet ist urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer Objekt ist ein untergeordnetes Element davon. Das Objekt selbst ist das übergeordnete Element. Das Erstellen einer Kennung bedeutet, den Elternteil zu benennen, einen Doppelpunkt hinzuzufügen und dann das Kind hinzuzufügen:
Das ist die gesamte Konstruktion. Es gibt keine Nachschlagetabelle, die bei Zoom angefordert werden muss, und nichts zu generieren – die Kennung besteht aus zwei Dingen, die Sie bereits haben, verbunden durch einen Doppelpunkt.
Das übergeordnete Element bleibt gleich; nur das untergeordnete Element ändert sich
Da das übergeordnete Element festgelegt ist, ist die Konfiguration eines zweiten, fünften oder fünfzehnten Attributs dieselbe Aktion, bei der ein anderes untergeordnetes Element angehängt wird:
Der gleiche Elternteil trägt jedes andere Zoom-Produkt. An der Konstruktion ändert sich nichts, wenn sich das Produkt ändert:
Sie lernen also das übergeordnete Element nur einmal. Von da an bedeutet das Konfigurieren eines neuen Attributs, dass man in der API-Referenz nur drei Dinge nachschlägt: den Namen des untergeordneten Elements, seinen Datentyp und seine zulässigen Werte.
Wenn Sie einen übergeordneten und einen untergeordneten Eintrag zusammenstellen können, liegt der schwierigste Teil dieser Konfiguration bereits hinter Ihnen. Was noch bleibt, ist Ihrem Identitätsanbieter mitzuteilen, woher jeder Wert stammen soll — behandelt in den folgenden Abschnitten zu Entra ID und Okta — und zu entscheiden, welche Attribute zuerst angegangen werden sollen, was Weiter unten behandelt wird.
Zwei Arten der Zuordnung: Basic und erweitert
Nicht jedes Attribut birgt das gleiche Risiko, und es lohnt sich, sie zu sortieren, bevor irgendetwas konfiguriert wird.
Dieser Leitfaden entlehnt die Begriffe grundlegend und Erweitert von dem SSO-Leitfaden, was die gleiche Linie für SAML-Antwortzuordnung zieht. Die Begriffe beschreiben was Zoom bei Ankunft mit dem Wert macht, nicht wie schwierig es ist, das Attribut zu Konfigurieren. Mechanisch sind die beiden identisch: Beide sind in demselben Benutzer aktualisieren Anforderungskörper, beide werden mit derselben Eltern-Doppelpunkt-Kind-Konstruktion erstellt, und beide werden durch dieselben Schritte in Entra ID und Okta deklariert und zugeordnet.
Basic-Zuordnung schreibt Text in das Profil eines Benutzers. Zoom speichert den Wert genau wie gesendet und prüft ihn nie gegen irgendetwas.
Erweiterte Zuordnung macht einen Anspruch auf das Konto geltend. Zoom nimmt den Wert und sucht nach einem passenden Objekt oder nach einem freien Platz in einem gekauften Plan — und diese Suche kann fehlschlagen.
Was der Wert ist
Text, der im Profil eines Benutzers gespeichert ist
Ein Verweis auf ein Objekt in Zoom oder ein Anspruch auf einen gekauften Sitzplatz
Beispiele
Abteilung, Titel, Kostenstelle
zoomPhoneSite, ZoomContactCenterRole, ZoomWorkplace
Übergeordnet
Oberste Ebene oder die Enterprise-Erweiterung
Die Zoom-Erweiterung
Voraussetzungen in Zoom
Keine
Das Objekt muss existieren oder der Sitzplatz muss frei sein
Wenn der Wert falsch ist
Falscher Text wird in einem Profil angezeigt
Das Attribut wird abgelehnt oder stillschweigend ignoriert
Diese Unterscheidung führt zu zwei praktischen Entscheidungen. Sie bestimmt was Sie in Zoom zuerst erstellen müssen — bei Basic-Zuordnung nichts, bei erweiterter möglicherweise sehr viel — und sie bestimmt was ein Fehler kostet. Eine falsche Abteilung ist nur ein optischer Fehler in einem Profil. Ein falscher Standortname oder ein nicht verfügbarer Lizenzplatz lässt einen Benutzer ohne funktionierendes Telefon oder ohne das Produkt zurück, für dessen Nutzung er eingestellt wurde, und kann in einer Live-Bereitstellung jemandem eine Berechtigung entziehen, der sie bereits hatte.
Dieser Unterschied in den Folgen ist der Grund, warum die beiden unten getrennt behandelt werden.
Basic-Zuordnung: Profilinformationen
Basic-Zuordnung füllt die beschreibenden Felder im Zoom-Profil eines Benutzers aus. Zoom speichert jeden Wert genau so, wie er gesendet wird, und validiert ihn niemals gegen ein vorhandenes Objekt. Daher gibt es nichts, was Sie in Zoom vorher erstellen müssten, und nichts, was bei einem falschen Wert kaputtgehen könnte.
Kern-Identitätsfelder sind normalerweise bereits zugeordnet. Benutzername, name.Vorname, name.Nachname, Anzeigename, und E-Mail-Adressen stehen ebenfalls auf der obersten Ebene, haben überhaupt kein übergeordnetes Element und werden sowohl von den Entra ID- als auch von den Okta-Integrationen standardmäßig zugeordnet. Verifizieren Sie sie, anstatt sie neu zu erstellen. Titel, Telefonnummern, und Gebietsschema sind ebenfalls auf oberster Ebene, müssen aber möglicherweise hinzugefügt werden.
Enterprise-Felder verwenden einen zweiten Parent. An der Konstruktion ist kein Ändern nötig — nur der Parent ändert sich:
Das Befüllen von Abteilung und Kostenstelle über SCIM erfordert keine SAML-Zuordnung mehr.
Erweiterte Zuordnung: Produktkonfiguration und Berechtigungen
Die erweiterte Zuordnung weist die Dinge zu, die ein Benutzer tun kann: einen Zoom Phone-Standort und Tarif, eine Contact Center-Rolle und ein Contact Center-Paket, ein Workplace-Bundle und ein Revenue Accelerator-Segment. Diese Attribute befinden sich unter dem übergeordneten Zoom-Erweiterungselement, das im gesamten Leitfaden verwendet wird.
Der entscheidende Unterschied ist, dass diese Werte nicht gespeichert werden — sie werden behoben. Zoom nimmt den von dir gesendeten Wert und sucht nach einem passenden Objekt oder einem Verfügbaren Sitzplatz. Während Basic-Mapping Text auf ein Profil schreibt, erhebt das fortgeschrittene Mapping einen Anspruch gegen die Konfiguration und den Bestand des Kontos, und dieser Anspruch kann fehlschlagen.
Deshalb widmet dieser Leitfaden den Voraussetzungen einen eigenen Abschnitt. Jedes erweiterte Attribut hängt davon ab, dass zuvor etwas im Zoom-Webportal eingerichtet oder gekauft wurde, und die Fehlermodi sind deutlich weniger nachsichtig als ein falsch geschriebener Jobtitel.
Die drei Ebenen, die jeder Konfiguration gemeinsam sind
Unabhängig davon, welches Attribut oder welcher Identitätsanbieter, die Arbeit besteht aus denselben drei Ebenen. Nur der Standort jedes Steuerelements unterscheidet sich.
1. Deklarieren
Teilen Sie dem Identitätsanbieter mit, dass das Attribut in der Zoom-Anwendung vorhanden ist, damit es als Zuordnungsziel Verfügbar wird.
Schritt 1
Schritt 1
2. Zuordnen
Definieren Sie, woher der Wert stammt.
Schritt 2
Schritte 2–3
3. Umfang
Bestimmen Sie, auf welche Benutzer die Konfiguration angewendet wird und wann sie ausgeführt wird.
Schritte 3–5
Schritte 4–5
Sobald dieses Muster verstanden ist, ist das Hinzufügen eines fünften oder fünfzehnten Attributs eine Wiederholung derselben drei Ebenen, kein neues Projekt.
Entra und Okta unterscheiden sich darin, woher ein Wert stammen kann
Dies ist der architektonische Unterschied mit der größten Tragweite zwischen den beiden Pfaden, und er erklärt, warum dieselbe Business-Anforderung bei Entra und Okta zu unterschiedlichen Konfigurationen führt.
Entra ID bezieht Werte nur aus Benutzerobjektattributen. Ein Wert muss aus einem Feld am Benutzer stammen — einem vorhandenen Verzeichnisfeld oder einem Erweiterungsattribut, das speziell entwickelt wurde. Wenn der Verzeichniswert und der Zoom-Wert nicht dieselbe Zeichenfolge sind, ist ein Ausdruck erforderlich, um zwischen ihnen zu übersetzen.
Okta kann Werte entweder aus dem Benutzerprofil oder aus einer Gruppe-Zuweisung beziehen. Deklarieren eines Attributs mit Attributtyp: Gruppe ermöglicht, dass der Wert einmal einer Gruppe zugewiesen und von jedem Mitglied übernommen wird. Wenn die Konfiguration der Organisationsstruktur folgt, entfällt die Notwendigkeit für Übersetzungslogik vollständig.
Keiner der beiden Ansätze ist universell besser, aber sie führen zu unterschiedlichen Konfigurationen.
Zoom-seitige Vorabkonfigurationsanforderungen
Bevor Sie erweiterte Zuordnungen versuchen, müssen Objekte auf der Zoom-Seite vorhanden sein, bevor SCIM auf sie verweisen kann
SCIM ist ein Zuweisungsmechanismus, kein Erstellungsmechanismus — es verbindet einen Benutzer mit Konfigurationen, die bereits im Zoom-Konto vorhanden sind, und es nicht erstellt diese Konfiguration im Namen des Benutzers.
Ein großer Teil der erweiterten Zuordnungsattribute ist Verweise: der gesendete Wert muss zu einem Objekt aufgelöst werden, das in Zoom bereits existiert — einem Standort, einer Rolle, einer Vorlage, einem gekauften Tarif, einer bestimmten Nummer oder Durchwahl. Für alle gilt eine Regel:
Wenn ein Attribut etwas benennt, muss dieses bereits existieren, exakt so geschrieben sein, wie es gesendet wurde, und — wenn es aus einem begrenzten Pool stammt — über ungenutzte Kapazität verfügen.
Wenn ein referenziertes Objekt nicht existiert, erstellt SCIM es weder noch stellt es die Anfrage in eine Warteschlange. Das Attribut schlägt entweder direkt fehl, wobei der Fehler im Bereitstellungsprotokoll zurückgegeben wird, oder es wird stillschweigend verworfen — Zoom akzeptiert die Nutzlast, wendet nichts an und meldet Erfolg.
Die folgenden Abschnitte gliedern die Voraussetzungen nach Produkt auf, mit dem Navigationspfad und dem Support-Artikel zum Erstellen der jeweiligen Komponente. Lesen Sie zuerst die Hinweise auf Kontoebene, dann den Abschnitt für jedes Produkt, das Sie bereitstellen möchten.
Voraussetzungen auf Kontoebene gelten, bevor ein Produkt bereitgestellt wird
Die zu Beginn dieses Leitfadens aufgeführten Kontoanforderungen — Vanity-URL, SSO, SCIM-Autorisierung und eine verifizierte zugehörige Domäne — sind Voraussetzungen für jedes folgende Attribut. Konfigurieren Sie Sicherheit und SSO unter Administrator-Center → Sicherheit und Vertrauen, und verwalten Sie zugehörige Domänen unter Administrator-Center → Konto → Kontoprofil; siehe Zoom + Microsoft Entra ID SSO/SCIM-Konfiguration.
Zwei weitere Punkte sind ausdrücklich zu nennen:
Einen Platz zu kaufen ist nicht dasselbe wie ihn zuzuweisen. SCIM führt die Zuweisung aus, aber der Platz muss zuerst existieren. Siehe Benutzern Zoom-Lizenzen zuweisen oder entfernen.
Die Plätze müssen zu dem exakt angeforderten Tarif gehören. Das Senden eines Lizenzattributs schlägt fehl, wenn dieser spezielle Tarif keine freien Plätze hat, selbst wenn ein anderer Tarif im Konto noch freie Kapazität aufweist.
Zoom Phone
Zoom Phone umfasst die größte Menge an Referenzattributen, weil ein Telefonbenutzer aus mehreren vorab gekauften oder vorab erstellten Infrastrukturkomponenten zusammengesetzt wird.
Die Zoom Phone-Lizenz selbst
Ein Verfügbarer Zoom Phone-Platz — die erforderliche Berechtigung, bevor sich etwas der folgenden Elemente daran anfügen kann.
Im Voraus kaufen. Siehe Zoom Phone-Lizenzen kaufen und zuweisen.
zoomPhoneSite
Der Standort, exakt so benannt wie der gesendete Wert. Wird das Attribut weggelassen, wird der Hauptstandort des Kontos zugewiesen, der standardmäßig vorhanden ist, sobald Mehrere Standorte aktiviert sind.
Administrator-Center → Produktkonfiguration → Telefonsystem → Unternehmensinformationen → Standort hinzufügen, oder Importieren für die Massenanlage. Siehe Mehrere Standorte verwalten.
zoomPhoneNumber
Die Nummer, die gekauft oder ins Konto portiert wurde und derzeit nicht zugewiesen ist. Eine Nummer, die bereits von einem anderen Benutzer, einer Warteschleife oder einer automatischen Rufannahme belegt wird, kann nicht erneut verwendet werden.
Administrator-Center → Produktkonfiguration → Telefonnummern → Telefonnummern. Kaufen oder portieren Sie hier und lassen Sie die Zielnummer unzugewiesen, damit SCIM sie übernehmen kann. Siehe Nummernverwaltung zum Verwalten von Telefonnummern verwenden und Telefonnummern verwalten.
zoomPhoneExtNumber (nur bestimmte Werte)
Eine Durchwahl mit 3–6 Ziffern, die noch nicht verwendet wird. Nicht erforderlich beim Senden von 0, wodurch die Zuweisung an Zoom delegiert wird.
Administrator-Center → Produktkonfiguration → Telefonsystem → Benutzer & Räume → das Objekt auswählen, das die Durchwahl enthält → Profil → Durchwahl → Bearbeiten. Siehe Einstellungen für Telefonbenutzer ändern.
zoomPhoneCallingPlan
Der Tarif, gekauft und mit Verfügbarer Kapazität, referenziert durch seinen exakten Tarifcode.
Im Voraus kaufen. Siehe Zoom Phone-Lizenzen kaufen und zuweisen und Verwaltung von Telefonbenutzern. Tarifcodes sind in der Zoom Phone Tarifreferenz, oder zurückgegeben als Typ von der Tarife auflisten API zusammen mit Verfügbar Sitzplatzzahlen.
zoomPhoneCallingPlanSubscription (nur für Konten mit mehreren Abonnements)
Das spezifische Abonnement, aus dem der Plan beziehen soll, wenn das Konto mehr als ein Abonnement für denselben Plan enthält.
Tarife und Abrechnung → Abonnementverwaltung.
Der Erweiterungspool wird über Objekttypen hinweg gemeinsam genutzt, nicht nur von Benutzern. Anruf-Warteschlangen, automatische Rezeptionisten, Gruppen mit gemeinsamer Leitung und Telefone im gemeinsamen Bereich verbrauchen alle Durchwahlen aus demselben Bereich. Dies ist die häufigste Ursache für Fehler vom Typ „Durchwahl bereits in Verwendung“, weil die Durchwahl frei erscheint, wenn ein Administrator nur die Benutzerliste prüft.
Eine Portieren-Nummer ist erst zuweisbar, wenn das Portieren abgeschlossen ist. Die Nummer muss sowohl im Konto präsentiert als auch nicht zugewiesen sein; das Initiieren eines Portierens erfüllt keine der beiden Bedingungen.
Sites sind der häufigste Blocker weil ihre Erstellung eigene Anforderungen mit sich bringt. Standortadressen werden gegen eine reale Adressdatenbank validiert, weil sie Notrufdienste unterstützen – erfundene Kombinationen aus Adresse und Postleitzahl werden mit einem Validierungsfehler abgelehnt. Beim Importieren von Standorten in großen Mengen erwartet die Spalte „automatische Rufannahme“ den Wert Ja anstelle des in der Benutzeroberfläche angezeigten Beschriftungstexts, und Anrufer-ID-Name gilt hauptsächlich für die USA und Kanada und kann leer gelassen werden, wenn er zu einem Validierungsfehler führt.
Zoom Contact Center
Die Bereitstellung im Contact Center wird durch Rolle und Vorlage gesteuert. Einzelne Attribute müssen vorhandenen Contact Center-Objekten zugeordnet werden, und die Vorlage enthält die Einstellungen, für die es kein eigenes SCIM-Attribut gibt.
zoomContactCenterPackage
Das Paket — Grundlagen, Premium, oder Elite — gekauft mit ungenutzten Sitzplätzen.
Im Voraus kaufen; Premium erfordert möglicherweise, dass Sie zuerst den Zoom-Support kontaktieren, um zusätzliche Pakete zu kaufen. Siehe Ändern der Zoom Contact Center-Einstellungen des Benutzers.
Zoom-Kontaktcenter-Add-ons-Plan
Der Add-on-Tarif, gekauft und mit Kapazität.
Im Voraus kaufen; Konto-Plan und Abrechnungsinformationen.
ZoomContactCenterRole
Die Rolle, Standard oder benutzerdefiniert, genau angegeben. Wenn sie weggelassen wird, wird die standardmäßig Agent-Rolle zugewiesen, die standardmäßig vorhanden ist.
Administrator-Center → CX-Management → Contact Center → Rollen → Hinzufügen → Konfigurieren Berechtigungen → Speichern. Siehe Verwalten von Zoom Contact Center-Rollen.
zoomKontaktzentrumRegion
Die Region. Wenn sie weggelassen wird, wird die Hauptregion des Kontos zugewiesen, die konfiguriert sein muss.
Administrator-Center → CX-Management → Contact Center → Einstellungen → Regionen → Hinzufügen Region → einen Namen eingeben und eine SIP Zone auswählen → Hinzufügen. Siehe Verwalten von Zoom Contact Center-Regionen.
zoomKontaktCenterBenutzerVorlage
Die Benutzer-Vorlage, genau benannt. Hinzufügen-Typ-Vorlagen gelten bei der Benutzererstellung; Update-Typ-Vorlagen gelten bei der Aktualisierung.
Administrator-Center → CX-Management → Contact Center → Benutzer → Vorlagen → Vorlage Hinzufügen → Wählen Hinzufügen → Konfigurieren Rollen, Pakete, Warteschlangen und Fähigkeiten → Hinzufügen. Siehe Vorlage für Einstellungen des Benutzers im Zoom Contact Center verwalten.
Posteingänge, Warteschlangen und Fähigkeiten haben kein SCIM-Attribut. Um sie bereitzustellen, erstellen Sie sie vorab in Administrator-Center → CX-Verwaltung → Contact Center, hängen Sie sie an eine Benutzervorlage an und Zuweisen Sie diese Vorlage über zoomKontaktCenterBenutzerVorlage. Sie werden daher zu Voraussetzungen der Vorlage statt des einzelnen Benutzer — was das Template auch zum einzigen Objekt macht, das gepflegt werden muss, wenn sich diese Anforderungen Ändern.
Warteschlange
Administrator-Center → CX-Management → Contact Center → Warteschlangen → Warteschlange Hinzufügen → Name, Kanal, Agenten → Speichern. Siehe Verwalten von Zoom Contact Center-Warteschlangen.
Fähigkeit
Administrator-Center → CX-Management → Contact Center → Fähigkeiten → eine Kategorie auswählen → Fähigkeit Hinzufügen → Name → Hinzufügen. Siehe Verwalten von Fähigkeiten und Fähigkeitskategorien.
Posteingang
Administrator-Center → CX-Management → Contact Center → Posteingang → Hinzufügen Posteingang. Siehe Verwalten von Zoom Contact Center-Posteingängen.
Wenn sowohl eine Vorlage als auch einzelne Attribute angegeben werden, haben die einzelnen Werte Vorrang. Eine Vorlage mitsenden ZoomContactCenterRole bedeutet, dass das Attribut „Rolle“ die Rolleneinstellung der Vorlage überschreibt, sodass sowohl die referenzierte Rolle als auch die Vorlage vorhanden sein müssen.
Zoom Revenue Accelerator
zoomUmsatzbeschleunigerPlan und zoomUmsatzbeschleunigerAbonnement
Der erworbene ZRA-Tarif oder das Abonnement mit einem verfügbaren Platz.
Im Voraus kaufen; Konto-Plan und Abrechnungsinformationen.
zoomUmsatzbeschleunigerRolle
Die Rolle, Standard oder benutzerdefiniert — zum Beispiel Vertriebsmanager — genau so benannt.
Administrator-Center → Benutzer → Rollen → Revenue Accelerator Registerkarte → + Rolle hinzufügen → Name und Beschreibung → Hinzufügen → Konfigurieren Berechtigungen → Änderungen speichern. Siehe Verwendung der Zoom Revenue Accelerator Rollenverwaltung.
zoomRevenueAcceleratorSegment
Der Segment, dem der Benutzer angehört.
Administrator-Einstellungen für Revenue Accelerator.
zoomRevenueAcceleratorRegion
Die Region — zum Beispiel, US.
Administrator-Einstellungen für Revenue Accelerator.
Zoom Workplace Lizenz- und Konto-Rollen
Über die drei oben genannten Produkte hinaus enthält der Standard-Benutzer-Datensatz Rollen- und Lizenzverweise, die derselben Regel folgen, und kann sie aufzeichnen.
Rollen[] (Wert / anzeigen)
Die Konto-Rolle, genau benannt. Rollen werden von SCIM referenziert, niemals von ihm erstellt.
Administrator-Center → Benutzer → Rollen → Rolle Hinzufügen → Name und Beschreibung → Konfigurieren von Berechtigungen. Siehe Rollenverwaltung verwenden.
ZoomWorkplace und weitere Lizenz- oder Add-on-Attribute — Whiteboard, Scheduler, Clips Plus, übersetzte Untertitel, Workforce Management, Quality Management, Einhaltung Management, CX Insights, AI Vertrieb Assist und ihre ...Abonnement Gegenstücke
Das entsprechende Bundle oder Add-on, das mit ungenutzten Sitzplätzen gekauft wurde.
Pläne und Abrechnung → Planverwaltung → den Plan bearbeiten → die Anzahl der Lizenzen erhöhen. Siehe Aktualisierung Ihres Kontos und Hinzufügen-ons.
Anmeldetyp (SSO / Arbeits-E-Mail), unter urn:us:Zoom:scim:schemas:extension:1.0:ZoomBenutzer
SSO auf dem Konto konfiguriert, für den SSO-Anmeldetyp.
Administrator-Center → Sicherheit und Vertrauen → Single Sign-On.
Für ein Lizenz- oder Add-on-Attribut gibt es kein Objekt, das benannt werden muss, aber die Vorbedingung ist im Ergebnis identisch: Ohne einen Verfügbar-Sitz in diesem spezifischen Pool schlägt die Zuweisung fehl.
Attribute ohne Vorbedingung
Jedes Basic-Zuordnungsattribut gilt, wie unter Basic-Zuordnung: Profilinformationen — Zoom speichert diese Werte wortwörtlich und validiert sie nie gegen ein vorhandenes Objekt. Zwei Attribute unter der Zoom-Erweiterung verhalten sich auf dieselbe Weise:
Automatisch delegierte Werte —
zoomPhoneExtNumbergesendet als0, wobei Zoom die Erweiterung selbst zuweist.Benutzerdefinierte Kontoattribute — die
{customAttribute}Feld, das den von Ihnen gesendeten beliebigen String enthält.
Standardmäßig gesetzte Verweise sind ein Mittelweg: Das Weglassen von zoomPhoneSite, ZoomContactCenterRole, oder zoomKontaktzentrumRegion fällt auf den Hauptstandort, die standardmäßige Agenten-Rolle und die Hauptregion zurück. Diese Standardwerte müssen selbst existieren, und das tun sie standardmäßig.
Gruppen sind eine teilweise Ausnahme. Wenn die Gruppenbereitstellung aktiviert ist, erstellt SCIM eine Zoom-Gruppe, die noch nicht existiert, und verwendet dabei den Namen der Quellgruppe genau so, wie er eingegeben wurde. Es wendet keine Produktkonfiguration auf diese Gruppe an — die Gruppe wird mit Mitgliedern und sonst nichts bereitgestellt. Richtlinien von Zoom Phone, Anrufberechtigungen und andere Einstellungen auf Gruppenebene müssen weiterhin unter Administrator-Center → Benutzer → Gruppen nachdem die Gruppe erscheint.
Bereiten Sie Ihre Verzeichnisdaten vor
SCIM überträgt alles, was die Quelle enthält. Es validiert, normalisiert oder korrigiert nicht. Bevor Sie ein beliebiges Attribut zuordnen, bestätigen Sie drei Dinge über die beabsichtigte Quelle:
Es ist für jeden Benutzer im Geltungsbereich befüllt. Ein nicht befülltes Feld sendet nichts oder sendet den standardmäßig konfigurierten Wert.
Seine Werte sind in Format und Groß-/Kleinschreibung konsistent. Die Vergleichslogik in beiden Identitätsanbietern ist exakt.
Seine Werte entsprechen genau den von Zoom erwarteten Werten. Zoom gleicht Namen von Standorten, Namen von Rollen oder Planwerte nicht unscharf ab.
Wenn ein vorhandenes Feld nicht alle drei Bedingungen erfüllen kann, ist ein Attribut, das speziell entwickelt wurde und absichtlich für diese Integration befüllt wird, nachhaltiger als das Umwidmen eines Feldes, in das auch andere Systeme schreiben.
Referenzszenarien
Vier Szenarien werden in diesem Leitfaden durchgehend verwendet. Ihre Business-Anforderungen und Zoom-seitigen Voraussetzungen sind unabhängig vom Identitätsanbieter identisch, daher werden sie hier einmalig definiert. Jeder identitätsanbieter-spezifische Abschnitt schließt mit der Darstellung, wie alle vier in dieser Plattform implementiert werden.
Szenario 0: Abteilung, als erste Basic-Zuordnung
Die Abteilung eines Benutzers sollte in seinem Zoom-Profil erscheinen und aus dem Verzeichnis stammen. Dies ist das zuvor als erster End-to-End-Test empfohlene Basic-Mapping, und es ist hier enthalten, damit das Verfahren in beiden Abschnitten des Identitätsanbieters durchlaufen wird.
Zoom-seitige Voraussetzung. Keine. Zoom speichert den Wert genau wie gesendet und validiert ihn niemals gegen ein vorhandenes Objekt.
Attribut. Beachten Sie, dass sich das übergeordnete Element von den drei untenstehenden Szenarien unterscheidet — Abteilung befindet sich unter der Enterprise-Erweiterung, nicht unter der Zoom-Erweiterung.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:department
Zeichenkette
Freitext. Beide Identitätsanbieter haben bereits ein Abteilung Feld im Benutzerprofil, sodass kein neues Quellattribut erforderlich ist.
Warum hier beginnen. Ein Abteilungswert, der korrekt in einem Zoom-Profil angezeigt wird, beweist die Schemadeklaration, die Zuordnung, den Geltungsbereich und Ihre Fähigkeit, die Bereitstellungsprotokolle zu lesen — ohne eine Lizenz oder eine Telefonkonfiguration zu gefährden. Jedes der folgenden fortgeschrittenen Szenarien unterscheidet sich nur darin, worauf das Attribut verweist.
Prüfen Sie zuerst, ob es bereits zugeordnet ist. Die standardmäßig festgelegten Zuordnungen unterscheiden sich zwischen Entra ID und Okta, und sie Ändern sich, wenn beide Anbieter ihre Zoom-Integrationen aktualisieren. Überprüfen Sie die vorhandene Liste unter Bereitstellung → Zuordnungen in Entra oder Zoom-Attributzuordnungen mit Nicht zugeordnete Attribute Anzeigen in Okta aktiviert. Wenn Abteilung bereits zugeordnet ist, überprüfen Sie es, anstatt es als Duplikat zu deklarieren — und wenn Sie stattdessen ein Attribut von Grund auf Konfigurieren möchten, Kostenstelle, Unternehmen, und employeeNumber unter demselben übergeordneten Element liegen und sich identisch verhalten.
Szenario 1: Zoom Phone-Standort und automatische Durchwahlzuweisung
Benutzer sollten basierend auf ihrem Büro dem richtigen Zoom Phone-Standort zugewiesen werden und eine Durchwahl ohne administrative Eingriffe erhalten.
Voraussetzung auf Zoom-Seite Die Standort-Einträge müssen bereits vorhanden sein. Erstellen Sie sie unter Administrator-Center → Produktkonfiguration → Telefonsystem → Unternehmensinformationen → Standort hinzufügen, oder in großen Mengen über Importieren. Standortadressen werden gegen eine reale Adressdatenbank validiert, weil sie Notruf-Dienste unterstützen, daher werden fiktive Kombinationen aus Adresse und Postleitzahl die Validierung nicht bestehen.
Attribute. Beide verwenden den Namensraum urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer: gefolgt vom Namen.
zoomPhoneSite
Zeichenkette
Muss Zeichen für Zeichen mit dem Zoom-Standortnamen übereinstimmen
zoomPhoneExtNumber
Zeichenkette
0 löst die automatische Zuweisung aus
Warum der Wert 0 wichtig ist. Zoom ist das einzige System, das weiß, welche Durchwahlen bereits in Gebrauch sind — einschließlich Durchwahlen, die Anruf-Warteschlangen und Auto-Rezeptionisten statt Benutzern zugewiesen sind. Die Zuweisung an Zoom zu delegieren, beseitigt eine ganze Kategorie von Bereitstellungsfehlern. Das Beziehen von Durchwahlen stattdessen aus dem Verzeichnis ist während einer Migration angemessen, wenn es darauf ankommt, vorhandene Durchwahlnummern beizubehalten, aber die Zuordnung sollte wechseln zu 0 sobald die Migration abgeschlossen ist, damit zukünftige Beitritte nicht davon abhängen, dass Verzeichnisdaten auf unbestimmte Zeit gepflegt werden.
Szenario 2: Zoom Phone-Tarif je Land unterschiedlich
Ein multinationales Unternehmen hat eigenständige Zoom Phone-Tarife gekauft und muss sicherstellen, dass jeder Benutzer den Tarif erhält, der zu seinem Land passt.
Zoom-seitige Voraussetzung. Die Tarife müssen bereits gekauft und auf dem Konto Verfügbar sein. Tarifwerte sind in der Zoom Phone Tarifreferenz.
Attribut. zoomPhoneCallingPlan (Zeichenfolge) dokumentiert.
Wie man den richtigen Tarifcode erhält. zoomPhoneCallingPlan nimmt den numerischen Tarifcode, nicht einen Tarifnamen. Der zuverlässigste Weg, ihn zu erhalten, ist die Tarife auflisten API, die jeweils den Anzeigenamen Name, seinen Typ — den Code, den Sie zuordnen — und seine abonnierten und verfügbaren Sitzplatzanzahlen. Ein Anruf bestätigt daher, dass der Tarif existiert, gibt Ihnen den zu sendenden Wert und überprüft, ob genügend Kapazität vorhanden ist, um ihn zuzuweisen.
Das Zoom-Webportal zeigt nur Anzeigenamen, niemals Codes, daher muss ein Administrator, der nur mit dem Portal arbeitet, den Anzeigenamen mithilfe der Zoom Phone Tarifreferenz API — wobei zum Beispiel UNLIMITED_PLAN_US_CA ist 200 und UNLIMITED_PLAN_GB_IE ist 202. Die Referenz listet konstante Namen statt der Formulierung des Portals auf; bestätigen Sie daher die Übereinstimmung anhand der Planmerkmale — Region sowie verbrauchsabhängig versus unbegrenzt — und nicht anhand des genauen Textes.
Separat dazu zeigt die SCIM2 API-Referenz von Zoom einen Abrechnungsplannamen wie phone_calling_usca_monthly_unlimited in ihrem Beispiel-Payload. Diese Kennung wird verwendet, um kaufen ein Abonnement, nicht um einen Plan einem Benutzer zu Zuweisen. Wenn Sie angeben müssen, auf welches Abonnement sich ein Plan stützt, gehört das in zoomPhoneCallingPlanSubscription.
Warum -1 als Fallback verwendet wird. Die SCIM2-Referenzdokumente -1 als der Wert, der alle Anrufpläne entfernt. Die Verwendung für nicht zugeordnete Benutzer führt zu einem deterministischen, sichtbaren Ergebnis — kein Plan zugewiesen — statt der Mehrdeutigkeit, überhaupt keinen Wert zu senden. Außerdem bietet es eine saubere Möglichkeit, Anrufberechtigungen zu entziehen, ohne den Benutzer zu löschen.
Szenario 3: Zoom Contact Center-Paket, Rolle und Region
Contact Center-Agenten sollten zum Zeitpunkt des Onboardings mit dem richtigen ZCC-Paket und der richtigen Rolle ausgestattet werden, statt nachträglich manuell konfiguriert zu werden. Dieses Szenario zeigt, dass die Methode produktunabhängig ist – am Verfahren selbst ändert sich nichts, nur die Attributnamen und zulässigen Werte.
zoomContactCenterPackage
Zeichenkette
Grundlagen, Premium, Elite
ZoomContactCenterRole
Zeichenkette
Beliebiger ZCC-Rolle-Name. Standardmäßig Agent falls weggelassen.
zoomKontaktzentrumRegion
Zeichenkette
Jede konfigurierte ZCC-Region. Standardmäßig die Hauptregion, falls weggelassen.
Beim absichtlichen Auslassen von Attributen. Verlassen zoomKontaktzentrumRegion nicht zugeordnet in Bereitstellungen mit einer einzelnen Region, bei denen Zooms dokumentierte Einstellung standardmäßig bereits korrekt ist. Ein Attribut wegzulassen, dessen Standardwert richtig ist, ist einer Zuordnung vorzuziehen – jede Zuordnung ist eine Wartungsverpflichtung.
Betriebshinweis. Die SCIM2-Referenz dokumentiert ebenfalls zoomKontaktCenterBenutzerVorlage, wodurch eine vorkonfigurierte ZCC-Vorlage angewendet wird. Vorlagen vom Typ Hinzufügen werden bei der Benutzererstellung angewendet, und Vorlagen vom Typ Aktualisieren bei Aktualisierungen; wenn in derselben Anfrage sowohl eine Vorlage als auch einzelne Attributwerte angegeben werden, haben die einzelnen Werte Vorrang. Vorlagen sind erwägenswert, wenn die ZCC-Konfiguration so komplex ist, dass ihre Pflege über viele einzelne Attributzuordnungen hinweg unhandlich wird.
Verifizierung auf Zoom-Seite und häufige Fehler
Jeder Identitätsanbieter verfügt über ein eigenes Protokoll, das in Schritt 6 jedes Identitätsanbieters behandelt wird. Das untenstehende Protokoll auf Zoom-Seite ist für beide identisch und der maßgebliche Nachweis dessen, was Zoom tatsächlich erhalten hat.
Anrufprotokolle im Zoom App Marketplace ermöglichen das Anzeigen des vollständigen Austauschs von Anfrage und Antwort
Melden Sie sich im Zoom-Webportal als Kontoinhaber an.
Navigieren Sie zum Zoom App Marketplace → Verwalten → Apps im Konto.
Wählen Sie die Anwendung aus, die die Verbindung zum Identitätsanbieter darstellt. Für Entra heißt sie in der Regel Azure Identity oder ähnlich.
Öffnen Sie die Anrufprotokolle Registerkarte aus.
Verwenden Nach Endpunkt suchenoder die Filter für den Datumsbereich, die Methode und den Status, um den relevanten Anruf zu finden.
Wählen Sie die Zeile aus, um sie zu erweitern.
Überprüfen
requestBodyum genau zu sehen, was gesendet wurde, undAntwortum genau zu sehen, was Zoom zurückgegeben hat, einschließlich der generierten Zoom-Benutzer-ID,HTTP-Status, und die resultierende Attributmenge.
Zoom bewahrt die 100 neuesten API-Anforderungsprotokolle auf, daher untersuchen Sie einen Fehler umgehend, statt erst nachdem weitere Bereitstellungsaktivitäten ihn verdrängt haben.
Häufige Bereitstellungsfehler und ihre Ursachen
400
Das Konto hat Single Sign-On nicht aktiviert.
SSO ist eine Voraussetzung für SCIM. Aktivieren und Konfigurieren Sie SSO zuerst im Zoom-Konto.
400
Benutzer ist inaktiv oder gesperrt.
Der Ziel-Zoom-Benutzer kann in seinem aktuellen Zustand nicht aktualisiert werden. Beheben Sie den Kontostatus im Zoom-Webportal.
403
Die Anfrage wurde aufgrund unzureichender Berechtigungen abgelehnt: "Benutzer:Edit".
Die Anmeldedaten hinter der SCIM-Verbindung verfügen nicht über den erforderlichen Geltungsbereich. Autorisieren Sie die Verbindung mit einem Inhaber- oder Administratorkonto erneut.
404
Benutzer existiert nicht.
Der Identity Provider hat den Benutzer nicht mit einem vorhandenen Zoom-Benutzer verknüpft. Überprüfen Sie das Übereinstimmungsattribut und das Format für Benutzername.
409
Die E-Mail-Domäne stimmt nicht mit der zugehörigen Domäne des Kontos überein.
Die E-Mail-Domäne des Benutzers ist nicht mit dem Zoom-Konto verknüpft. Verknüpfen und verifizieren Sie die Domäne vor der Bereitstellung.
409
Das Hinzufügen bezahlter Benutzer ist nicht möglich.
Keine Lizenz des angeforderten Typs ist verfügbar. Freie Kapazität auf dem Konto oder den Benutzer als Basic bereitstellen.
409
Mit [bundle name] können keine weiteren Benutzer erstellt werden.
Das spezifische Bundle hat keine verbleibenden Plätze. Gilt für Workplace Business Plus, Enterprise Premier, Pro Plus und die entsprechenden Bildungsversionen.
429
Zu viele Anfragen.
Die Provisionierung hat die Ratenbegrenzungen von Zoom überschritten. Untersuchen Sie, ob dies über mehrere Zyklen hinweg bestehen bleibt.
Ein Fehlermodus erzeugt überhaupt keinen Fehler
Ein von Zoom akzeptierter Wert, der jedoch auf nichts verweist — ein Standortname mit nachfolgendem Leerzeichen oder ein Rollenname, der in Zoom inzwischen umbenannt wurde — kann syntaktisch akzeptiert und auf nichts angewendet werden. Kein Protokolleintrag kennzeichnet dieses Vorkommen. Plattformspezifische Varianten desselben Problems werden in Schritt 6 behandelt.
SCIM mit Entra ID konfigurieren
Zusätzliche Anforderungen für Entra ID
Entra ID Administratorberechtigungen mit Access zu Enterprise Applications
Die E-Mail-Domäne, die von Ihren Benutzern verwendet wird, als benutzerdefinierte Domäne im Entra ID-Mandanten verifiziert
Zusätzliche Einschränkungen in Entra ID
Attributzuordnungen stammen ausschließlich von Entra Benutzerobjekt Attribute. Sicherheitsgruppen können einem Zoom-Attribut nicht direkt einen Wert zuweisen; die Gruppenmitgliedschaft steuert den Umfang, nicht den Wert.
Inkrementelle Bereitstellungszyklen laufen ungefähr alle 40 Minuten. Änderungen sind nicht sofort wirksam, sobald die Bereitstellung aktiviert ist.
Der
ZusammenarbeitWert vonBenutzertypwird aufgrund einer Microsoft-spezifischen Einschränkung mit Entra ID nicht unterstützt.
Schritt 1: Deklarieren Sie das Attribut im Zoom-Anwendungsschema
Das Deklarieren eines Attributs ist eine einmalige Aktion pro Attribut. Deklarieren Sie alle Attribute, die Sie verwenden möchten, bevor Sie irgendeine Zuordnung konfigurieren, damit alle Ziele in Schritt 2 Verfügbar sind.
Anmelden Sie sich beim Azure-Portal unter Verwendung der URL des Schema-Editors:
https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#homeUnter Azure-Dienste, auswählen Microsoft Entra ID.
Im linken Navigationsmenü unter Verwalten, klicken Enterprise-Anwendungen.
In der Liste der Anwendungen klicken Sie auf Ihre Zoom-Anwendung. Hinweis: Der Anwendungsname wird vom Entra-Administrator festgelegt, wenn die Anwendung erstellt wird. Er heißt häufig Zoom oder Zoom SSO, kann jedoch in Ihrem Mandanten abweichen.
Im linken Navigationsmenü unter Verwalten, klicken Bereitstellung. Hinweis: Azure bietet derzeit eines von zwei Layouts an. In der alten Benutzeroberfläche auswählen Attributzuordnungen bearbeiten unter Bereitstellung verwalten. In der neueren Version öffnet sich die Seite auf einem Überblick Registerkarte; auswählen Bereitstellung erneut über das linke Menü. Beide Wege führen zum selben Ziel.
Klicken Sie auf die Zuordnungen Dropdown, dann klicken Microsoft Entra ID-Benutzer bereitstellen. Hinweis: In Mandanten, die noch die alte Benennung anzeigen, erscheint diese Option als Azure Active Directory-Benutzer bereitstellen.
In der unteren linken Ecke auswählen Anzeigen erweiterte Optionen Kontrollkästchen.
Klicken Sie auf Attributliste für Zoom bearbeiten.
Scrollen Sie zur ersten leeren Zeile und füllen Sie Folgendes aus:
Name: die vollständige Attributzeichenfolge eingeben, zum Beispiel
urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneSiteTyp: auswählen Zeichenfolge oder Boolesch, entsprechend dem in der SCIM2 API-Referenz dokumentierten Datentyp.
Wiederholen Sie Schritt 9 für jedes weitere Attribut.
In der oberen linken Ecke klicken Speichern.
Schritt 2: Eine Verzeichnisquelle dem Attribut zuordnen
Entra ID bietet drei Zuordnungstypen, und die Wahl zwischen ihnen ist die folgenreichste Entscheidung in der Konfiguration.
Direkt
Ein Entra-Feld enthält bereits den exakten Wert, den Zoom erwartet.
Gibt den Quellwert unverändert weiter.
Konstant
Jeder Benutzer im Geltungsbereich sollte denselben Wert erhalten.
Sendet jedem bereitgestellten Benutzer einen festen Wert.
Ausdruck
Der Wert muss aus einem Benutzerattribut abgeleitet, übersetzt oder variiert werden.
Wertet einen Ausdruck anhand von Quellfeldern aus und sendet das Ergebnis.
Um die Zuordnung zu erstellen:
Zurück zu Bereitstellung → Zuordnungen → Microsoft Entra ID-Benutzer bereitstellen.
Klicken Sie unten links auf Neue Zuordnung Hinzufügen.
Konfigurieren Sie die Zuordnung entsprechend dem ausgewählten Typ — siehe die Anleitung unten.
Klicken Sie auf die Zielattribut Dropdown öffnen und das in Schritt 1 angegebene Attribut auswählen.
Klicken Sie auf die Objekte mithilfe dieses Attributs abgleichen Dropdown öffnen und auswählen Nein. Hinweis: Benutzerdefinierte Zoom-Attribute sind Konfigurationswerte, keine Schlüssel für den Identitätsabgleich. Nur das Attribut, das Entra-Benutzer mit Zoom-Benutzern verknüpft — normalerweise
Benutzername— sollte auf Ja.Klicken Sie auf die Diese Zuordnung anwenden Dropdown öffnen und auswählen Immer, damit der Wert sowohl bei der Erstellung als auch bei nachfolgenden Aktualisierungen angewendet wird.
Klicken Sie auf OK.
Für jedes Attribut wiederholen und dann auf Speichern oben im Attributzuordnung Seite.
Direkte Zuordnung übergibt ein vorhandenes Feld ohne Transformation
Zuordnungstyp: Direkt
Quellattribut: Ein Entra-Feld, dessen Wert bereits genau dem entspricht, was Zoom erwartet, Zeichen für Zeichen
standardmäßig, wenn null (optional): Ein Fallback, der angewendet wird, wenn das Quellfeld leer ist
Direkte Zuordnung ist die am wenigsten fehleranfällige Option und sollte bevorzugt werden, wo immer die Verzeichnisdaten dies unterstützen. Wenn physicalDeliveryOfficeName — dargestellt als Bürostandort im Entra-Benutzerprofil — bereits Werte enthält, die exakt den Namen von Zoom Phone-Standorten entsprechen, erfordert eine direkte Zuordnung keinerlei Logik.
Konstante Zuordnung wendet einen Wert auf die gesamte Population im Geltungsbereich an
Zuordnungstyp: Konstant
Konstanter Wert: Der feste Wert, der gesendet werden soll
Konstante Zuordnung eignet sich für Bereitstellungen mit nur einer Konfiguration und ist außerdem der Mechanismus hinter mehreren Zoom-spezifischen Verhaltensweisen. Das Festlegen zoomPhoneExtNumber auf einen konstanten Wert von 0 weist Zoom an, das Zuweisen der nächsten verfügbaren Durchwahl innerhalb des Standorts des Benutzers zu veranlassen und Durchwahlkonflikte vollständig zu beseitigen.
Die Ausdruckszuordnung übersetzt oder leitet zur Bereitstellungszeit einen Wert ab
Zuordnungstyp: Ausdruck
Ausdruck: Eine verschachtelte
IIF()-Anweisungdie ein oder mehrere Quellattribute auswertet
Eine Ausdruckszuordnung ist immer dann erforderlich, wenn der Verzeichniswert und der Zoom-Wert nicht dieselbe Zeichenfolge sind:
Quellwerte in ToUpper() und mit Großbuchstaben-Literalen vergleichen, um Inkonsistenzen bei der Groß-/Kleinschreibung zu neutralisieren:
Das Format des Quellfelds variiert je nachdem, wie der Entra-Benutzer erstellt wurde
Dies ist die häufigste Ursache für Ausdruckszuordnungen, die korrekt erscheinen, sich jedoch innerhalb einer Population inkonsistent verhalten.
Nutzungsstandort wird von Microsoft erzwungen, immer einen gültigen ISO 3166-1 Alpha-2-Code zu enthalten, wie zum Beispiel
GB, da sie die Lizenz- und Funktionsverfügbarkeit steuert. Dieses Feld ist zuverlässig.Land oder Region unterliegt keiner solchen Durchsetzung, und sein Inhalt hängt von der Erstellungsmethode ab. Benutzer, die über die GUI des Entra Admin-Portals erstellt werden, können aus einem Dropdown-Menü mit vollständigen Ländernamen auswählen, sodass das Feld typischerweise speichert
Vereinigtes Königreich. Benutzer, die durch CSV-Import oder PowerShell erstellt wurden, werden typischerweise mitGB— per Konvention, nicht durch Durchsetzung.
In jedem Mandanten, in dem Benutzer auf mehr als eine Methode erstellt wurden, Land wird kein einheitliches Format haben. Standardisieren Sie entweder das Feld, bevor Sie den Ausdruck erstellen, oder prüfen Sie beide Formate explizit, wie oben gezeigt.
Schritt 3: Benutzer und Gruppen in den Bereitstellungsbereich aufnehmen
Die Zuweisung bestimmt, welche Benutzer die Konfiguration betrifft. Benutzer außerhalb des Zuweisungsbereichs der Anwendung werden von keinem Mapping beeinflusst, wodurch die Zuweisung während der Einführung die primäre Sicherheitskontrolle ist.
Navigieren Sie zu Microsoft Entra ID → Enterprise-Anwendungen → Ihre Zoom-Anwendung → Benutzer und Gruppen.
Klicken Sie auf Benutzer/Gruppe hinzufügen.
Unter Benutzer und Gruppen, den vorgesehenen Benutzer oder die Sicherheitsgruppe auswählen.
Unter Eine Rolle auswählen, Wählen Sie die passende Rolle.
Klicken Sie auf Zuweisen.
In der Praxis sind nur zwei Rollenwerte relevant. Andere Optionen wie Corp und Pro sind entweder veraltete Namensgebungen, die auslaufen, oder für seltene Szenarien gedacht.
Basic
Stellt dem Benutzer eine kostenpflichtige Meeting-Lizenz bereit. Dies auswählen, wenn ein benutzerdefiniertes Attribut — wie etwa ein Zoom Phone Tarif — für die Zuweisung der bezahlten Berechtigung verantwortlich ist.
Lizenziert
Weist dem Zoom-Konto standardmäßig Lizenzplan, zum Beispiel Zoom Workplace Enterprise Plus. Dieser Bildschirm lässt die Auswahl eines bestimmten Bundles nicht zu; standardmäßig wird dies auf der Zoom-Seite konfiguriert.
Diese Rollenauswahl gilt einmal pro Benutzer oder Gruppe, die der Anwendung hinzugefügt wurde, unabhängig davon, wie viele benutzerdefinierte Attribute bereitgestellt werden.
Um Entra-Gruppen als Zoom-Gruppen bereitzustellen, die standardmäßig deaktiviert ist:
Navigieren Sie zu Bereitstellung → Zuordnungen und auswählen Microsoft Entra ID-Gruppen bereitstellen.
Umschalten Aktiviert zu Ja.
Bestätigen Sie, dass die standardmäßig festgelegten Zuordnungen vorhanden sind:
Anzeigename→Anzeigename, undMitglieder→Mitglieder.Klicken Sie auf Speichern.
Zurück zu Benutzer und Gruppen und bestätigen Sie, dass die Gruppe selbst der Anwendung zugewiesen ist, nicht nur ihre einzelnen Mitglieder. Die Bereitstellung von Gruppen verarbeitet nur direkt zugewiesene Gruppen.
Schritt 4: Mit Provision on Demand validieren
Bereitstellung auf Abruf läuft unabhängig von dem Bereitstellungsstatus Umschalten, was genau der Grund dafür ist, dass es das richtige Werkzeug für die Validierung ist. Jeder Schritt bis zu diesem Punkt — einschließlich dieses — kann abgeschlossen werden, während die Bereitstellung ausgeschaltet bleibt.
Navigieren Sie zu Bereitstellung → Bereitstellungsübersicht.
Klicken Sie auf Bereitstellung auf Abruf.
Suchen Sie nach und wählen Sie einen einzelnen Testbenutzer aus, dann klicken Sie Bereitstellen.
Überprüfen Sie das Ergebnis. Entra meldet die vier Phasen, die es für jedes Bereitstellungs-Event ausführt — Importieren, Ermitteln, ob im Geltungsbereich, Abgleichen, und Bereitstellen — jeweils einzeln aufklappbar.
Bestätigen Sie, dass die angezeigten Attributwerte Ihrer Absicht entsprechen.
Anmelden im Zoom-Webportal und bestätigen Sie, dass die Konfiguration angewendet wurde.
Schritt 5: Laufende Bereitstellung aktivieren
Das Aktivieren der Bereitstellung setzt die Konfiguration für jeden Benutzer im Bereich live in Kraft. Schließen Sie zuerst die Schritte 1 bis 4 ab und überprüfen Sie sie.
Navigieren Sie zu Microsoft Entra ID → Enterprise-Anwendungen → Ihre Zoom-Anwendung → Bereitstellung → Bereitstellung.
Umschalten Bereitstellungsstatus zu Ein.
Klicken Sie auf Speichern.
Der erste Zyklus kann bis zu etwa 40 Minuten dauern. Nachfolgende inkrementelle Zyklen laufen in etwa 40-Minuten-Intervallen. Neue Benutzer, Attributänderungen und Deaktivierungen werden nach diesem Zeitplan und nicht sofort synchronisiert.
Schritt 6: Überprüfen Sie mithilfe der Entra-Bereitstellungsprotokolle
Navigieren Sie zu Microsoft Entra ID → Enterprise-Anwendungen → Ihre Zoom-Anwendung → Überwachen → Bereitstellungsprotokolle.
Suchen oder filtern Sie nach dem Testbenutzer und wählen Sie dann das relevante Event aus. Die Detailansicht öffnet sich mit vier Registerkarten: Schritte, Fehlerbehebung & Empfehlungen, Geänderte Eigenschaften, und Zusammenfassung.
Überprüfen Sie die Zusammenfassung um zu bestätigen, ob die Aktion erfolgreich war oder fehlgeschlagen ist.
Wenn es fehlgeschlagen ist, öffnen Sie Fehlerbehebung & Empfehlungen, die die versuchte Aktion, den betroffenen Benutzerprinzipalnamen und — unter Details — den Fehlercode und die vollständige Fehlermeldung, die von der Zoom-API zurückgegeben wurden.
Dies ist zuverlässiger als das Prüfen des Zuordnungsbildschirms, da es die übertragenen Literalwerte statt dessen zeigt, was die Zuordnung erzeugen sollte. Wenn das Entra-Protokoll nicht eindeutig ist, wechseln Sie zu den unter dem Zoom App Marketplace beschriebenen Anrufprotokollen, die den Rohdatenverkehr der Anfrage und Antwort anzeigen. Verifizierung auf Zoom-Seite und häufige Fehlerden
Verhalten beim Onboarding und Offboarding in Entra ID
Der Bereich ist die primäre Sicherheitskontrolle. Benutzer außerhalb des Zuweisungsbereichs der Anwendung werden von keiner Zuordnung in dieser Konfiguration jemals geändert.
Das Deaktivieren eines Benutzers in Entra oder das Entfernen aus dem Bereich macht die Bereitstellung automatisch rückgängig und schließt die Offboarding-Schleife.
Jeder Fehler erzeugt einen entsprechenden Protokolleintrag — mit dem oben genannten Vorbehalt hinsichtlich stiller Fehler.
Schritt 7: Wenden Sie die Referenzszenarien in Entra ID an
Die Szenarien, Voraussetzungen und Attributdefinitionen befinden sich in der Referenzszenarien Sektion. Hier werden nur die Entra-Zuordnungen angegeben.
Szenario 0 — Abteilung. In Schritt 1 deklarieren Sie urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:department als Zeichenfolgeund achten Sie darauf, den Enterprise-Namensraum statt den von Zoom zu verwenden. Ordnen Sie es zu als Direkt aus dem Entra Abteilung Feld. Kein standardmäßig, wenn null ist erforderlich — ein leeres Quellfeld sendet einfach nichts, und auf der Zoom-Seite muss kein Objekt vorhanden sein.
Szenario 1 — Zoom Phone-Standort und automatische Durchwahl. Zuordnung zoomPhoneSite als Direkt von physicalDeliveryOfficeName, mit standardmäßig, wenn null gesetzt auf Hauptstandort. Zuordnen zoomPhoneExtNumber als Konstant mit einem Wert von 0 es sei denn, Sie migrieren eine bereits vorhandene Konfiguration von Erweiterungen. Wenn die Werte für den Bürostandort nicht genau mit den Zoom-Standortnamen übereinstimmen, verwenden Sie eine Ausdruck Zuordnung in der in Schritt 2 dargestellten Form.
Szenario 2 — Tarif je nach Land unterschiedlich. Da Entra keinen Wert aus einer Gruppe beziehen kann, ist ein Ausdruck erforderlich. Erweitern Sie ihn um zusätzliche IIF()-Anweisung Ebenen pro Land und berücksichtigen Sie sowohl das Alpha-2- als auch das Volltextformat, wie in Schritt 2 beschrieben:
Wenn das Attribut Tarif die bezahlte Berechtigung zuweist, auswählen Basic anstatt Lizenziert in Schritt 3. Auswählen Lizenziert wendet zusätzlich die standardmäßig zugewiesene Lizenz des Kontos an, was möglicherweise nicht das beabsichtigte kommerzielle Ergebnis ist.
Szenario 3 — Contact Center-Paket, Rolle und Region. Zuordnung zoomContactCenterPackage mit einem Ausdruck gesteuert durch ein Verzeichnisfeld, das Agentenstufen unterscheidet, und ZoomContactCenterRole als Direkt aus einem Feld, das den Namen der Rolle enthält. Verlassen zoomKontaktzentrumRegion nicht zugeordnet in Einzelregionsbereitstellungen.
SCIM mit Okta konfigurieren
Zusätzliche Anforderungen für Okta
Okta-Administratorberechtigungen mit Access zum Profile Editor
Weitere Einschränkungen in Okta
Wenn ein Benutzer mehreren Gruppen angehört, die widersprüchliche Werte für dasselbe Attribut bereitstellen, wird nur der Wert der Gruppe mit der höchsten Priorität übertragen. Siehe Schritt 5.
Schritt 1: Deklarieren Sie das Attribut im Benutzerprofil der Zoom-Anwendung
Dies ist das Attribut, das tatsächlich einen Wert an Zoom überträgt. Es zu deklarieren, ist eine einmalige Aktion pro Attribut.
Anmelden bei der Okta Admin-Konsole.
Klicken Sie im linken Navigationsmenü auf Anwendungen, dann klicken Anwendungen.
Unter STATUS, klicken AKTIV.
Klicken Sie auf die Zoom Anwendung. Hinweis: Der Anwendungsname wird vom Okta-Administrator festgelegt, wenn die Anwendung erstellt wird. Er wird häufig genannt Zoom, kann jedoch in Ihrem Mandanten abweichen.
Klicken Sie auf die Bereitstellung Registerkarte aus.
Unter Zoom-Attributzuordnungen, klicken Gehen Sie zum Profile Editor.
Unter Attribute, klicken + Attribut Hinzufügen.
Folgendes ausfüllen:
Datentyp: auswählen Zeichenkette oder boolesch, entsprechend der SCIM2 API-Referenz.
Anzeigename: den Attributnamen eingeben, zum Beispiel
zoomPhoneSite.Variablenname: Bitte denselben Namen eingeben.
Externer Name: Bitte den Attributnamen genau so eingeben, wie er von Zoom dokumentiert ist, zum Beispiel
zoomPhoneSite.Externer Namensraum: eingeben
urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneSiteBeschreibung (optional): Bitte aufzeichnen, warum das Attribut existiert und woher seine Werte stammen.
Attributtyp: auswählen Persönlich für einen Wert pro Benutzer, oder Gruppe für einen Wert, der durch die Mitgliedschaft in einer Gruppe vererbt wird.
Klicken Sie auf Speichern, oder Speichern und Hinzufügen eines weiteren.
Schritt 2: Erstellen Sie ein Quellattribut im Okta-Benutzerprofil
Schließen Sie diesen Schritt ab, wenn der Wert pro Benutzer gespeichert wird. Überspringen Sie ihn, wenn der Wert für jeden Benutzer identisch ist oder wenn er stattdessen auf Gruppenebene bereitgestellt wird.
Klicken Sie im linken Navigationsmenü auf Verzeichnis, dann klicken Profil-Editor.
Klicken Sie auf die Benutzer Registerkarte aus.
Klicken Sie im Navigationsmenü von Benutzer Box, unter Filter, klicken Alle.
Rechts von Okta, klicken Sie auf das Benutzer Profil.
Unter Attribute, klicken + Attribut Hinzufügen.
Folgendes ausfüllen:
Datentyp: Stimmen Sie das in Schritt 1 deklarierte Zoom-Attribut ab.
Anzeigename und Variablenname: Geben Sie einen Namen ein, zum Beispiel
zoomPhoneSite.Aufzählung (optional): auswählen Definieren Sie eine aufgezählte Liste von Werten wobei das Zoom-Attribut nur eine feste Menge von Werten akzeptiert.
Attribut erforderlich (optional): auswählen Ja wobei jeder Benutzer im Geltungsbereich einen Wert haben muss.
Klicken Sie auf Speichern.
Verwenden Sie die Aufzählung Option überall dort, wo Zoom einen festen Wertesatz dokumentiert — Contact Center-Pakete, Workplace-Bundle-Codes, Revenue-Accelerator-Planwerte. Die Einschränkung des Feldes bei der Eingabe verhindert, dass ein Tippfehler zu einem unbemerkten Bereitstellungsfehler wird, der sich Wochen später als fehlende Berechtigung bemerkbar macht.
Schritt 3: Ordnen Sie das Quellattribut dem Zoom-Attribut zu
Navigieren Sie zu Anwendungen → Anwendungen → AKTIV → die Zoom Anwendung.
Klicken Sie auf die Bereitstellung Registerkarte aus.
Unter Zoom-Attributzuordnungen, suchen Sie das in Schritt 1 deklarierte Attribut und klicken Sie auf das Bearbeiten-Symbol rechts daneben. Hinweis: Wenn das Attribut nicht sichtbar ist, klicken Nicht zugeordnete Attribute Anzeigen.
Klicken Sie auf die Attributwert Dropdown öffnen und auswählen Zuordnung aus dem Okta-Profil.
Klicken Sie auf das Quell-Dropdown — das anzeigt
Anmeldung | Zeichenfolgestandardmäßig — und das in Schritt 2 erstellte Okta-Benutzerprofilattribut auswählen.Auswählen Erstellen und aktualisieren. Hinweis: Nur erstellen wird der Wert angewendet, wenn der Zoom-Benutzer erstmals bereitgestellt wird und nie wieder. Wählen Sie ihn bewusst aus, für Werte, die nach der ersten Zuweisung nicht überschrieben werden sollen; auswählen Erstellen und aktualisieren in allen anderen Fällen, damit Verzeichnisänderungen weitergegeben werden.
Klicken Sie auf Speichern.
Für jedes Attribut wiederholen.
Schritt 4: Die Bereitstellung für die Anwendung aktivieren
Attributzuordnungen haben keine Wirkung, bis die entsprechenden Bereitstellungsoperationen aktiviert sind. Aktivieren Sie sie, bevor Sie in Schritt 5 Werte zuweisen.
Navigieren Sie zu Anwendungen → Anwendungen → AKTIV → die Zoom Anwendung.
Klicken Sie auf die Bereitstellung Registerkarte aus.
Unter Bereitstellung für App, klicken Bearbeiten.
Aktivieren Sie die unten beschriebenen Einstellungen und klicken Sie dann auf Speichern.
Benutzer erstellen
Erstellt oder verknüpft einen Benutzer in Zoom, wenn die Anwendung einem Benutzer in Okta zugewiesen wird.
Benutzerattribute aktualisieren
Aktualisiert die Attribute eines Benutzers in Zoom, wenn die Anwendung zugewiesen wird. Nachfolgende Änderungen am Okta-Benutzerprofil überschreiben den entsprechenden Wert in Zoom automatisch.
Benutzer deaktivieren
Deaktiviert das Zoom-Konto, wenn die Anwendung in Okta nicht zugewiesen ist oder wenn das Okta-Konto deaktiviert wird. Konten können durch erneutes Zuweisen der Anwendung reaktiviert werden.
Schritt 5: Werte Benutzern oder Gruppen zuweisen
Um einem einzelnen Benutzer einen Wert zuzuweisen:
Navigieren Sie zu Verzeichnis → Personen und klicken Sie auf den Namen des Benutzers.
Klicken Sie auf die Profil Registerkarte, dann klicken Sie auf Bearbeiten.
Füllen Sie das in Schritt 2 erstellte Attribut mit dem Wert aus, den Zoom erwartet.
Klicken Sie auf Speichern.
Der Wert wird umgehend übertragen. Bestätigen Sie das Ergebnis im Zoom-Webportal, bevor Sie dieselbe Änderung breiter anwenden.
Um einer Gruppe einen Wert zuzuweisen — das besser skalierbare Muster, bei dem die Konfiguration der Organisationsstruktur folgt:
Bestätigen Sie, dass das Attribut in Schritt 1 mit Attributtyp: Gruppe. Wenn es als Persönlich, deklarieren Sie ein gruppenbezogenes Äquivalent, indem Sie Schritt 1 gegen das Zoom-Benutzer Profil unter Verzeichnis → Profil-Editor → Benutzer → Alle, wobei Sie Gruppe als Attributtyp aus.
Navigieren Sie zu Verzeichnis → Gruppen → die Alle Registerkarte, dann klicken Sie auf Gruppe hinzufügen.
Geben Sie einen Name und optional Beschreibung, dann klicken Speichern.
Öffnen Sie die Gruppe und klicken Sie auf die Anwendungen Registerkarte aus.
Klicken Sie auf Anwendung zuweisen, dann klicken Zuweisen rechts neben dem Zoom Anwendung.
Füllen Sie die Gruppenattribute mit den Werten aus, die für jedes Mitglied gelten sollen.
Klicken Sie auf Speichern und zurück, dann klicken Fertig.
Klicken Sie auf die Gruppen- Personen Registerkarte, dann klicken Sie auf Personen zuweisen.
Suchen Sie nach Benutzern anhand des Vornamens, der primären E-Mail-Adresse oder des Benutzernamens, und klicken Sie neben jedem auf die Schaltfläche Hinzufügen.
Klicken Sie auf Fertig.
Mitglieder übernehmen die Attributwerte der Gruppe automatisch. Später hinzugefügte Benutzer übernehmen sie beim Beitritt, was dieses Muster für fortlaufendes Onboarding statt für eine einmalige Migrationsübung dauerhaft macht.
Die Gruppenpriorität löst widersprüchliche Werte auf, wenn ein Benutzer mehreren Gruppen angehört
Wenn ein Benutzer Mitglied von mehr als einer Gruppe ist, die einen Wert für dasselbe Attribut bereitstellt, überträgt Okta den Wert von der Gruppe mit der höchsten Priorität.
Navigieren Sie zu Anwendungen → Anwendungen → AKTIV → die Zoom Anwendung.
Klicken Sie auf die Zuweisungen Registerkarte aus.
Unter Filter, klicken Gruppen.
Ziehen Sie die Gruppen per Drag-and-drop in die gewünschte Reihenfolge.
Schritt 6: Mit dem Okta-Systemprotokoll überprüfen
Navigieren Sie zu Berichte → Systemprotokoll.
Filtern Sie nach dem Zielbenutzer oder nach der Zoom Anwendung und schränken Sie den Zeitbereich auf den Bereitstellungsversuch ein.
Öffnen Sie das relevante Event und prüfen Sie die Details, die das Ergebnis und alle von der nachgelagerten Anwendung zurückgegebenen Fehler enthalten.
Nicht behobene Bereitstellungsfehler werden auch auf der Registerkarte der Zoom Anwendung angezeigt Bereitstellung Registerkarte. Wenn das Okta-Protokoll keine eindeutigen Hinweise liefert, wechseln Sie zu den im Zoom App Marketplace beschriebenen Anrufprotokollen unter Verifizierung auf Zoom-Seite und häufige Fehlerden
Onboarding- und Offboarding-Verhalten in Okta
Der Geltungsbereich ist die primäre Sicherheitskontrolle. Benutzern, denen die Zoom Anwendung in Okta nicht zugewiesen ist, werden durch keine Zuordnung in dieser Konfiguration jemals geändert.
Mit Benutzer deaktivieren aktiviert, deaktiviert das Aufheben der Zuweisung der Anwendung oder das Deaktivieren des Okta-Kontos das Zoom-Konto automatisch.
Die erneute Zuweisung der Anwendung reaktiviert ein zuvor deaktiviertes Zoom-Konto, wodurch Gruppenmitgliedschaft zu einem praktikablen Mechanismus für die Verwaltung von Austritten und Rückkehrern wird.
Schritt 7: Wenden Sie die Referenzszenarien in Okta an
Die Szenarien, Voraussetzungen und Attributdefinitionen befinden sich in der Referenzszenarien Abschnitt. Hier wird nur die Okta-Konfiguration angegeben.
Szenario 0 — Abteilung. Deklarieren Sie in Schritt 1 das Attribut mit Anzeigename und Variablenname Abteilung, Externer Name Abteilung, und Externer Namensraum urn:ietf:params:scim:schemas:extension:Enterprise:2.0:Benutzer. Verwenden Sie Attributtyp: Persönlich. Das Basis-Benutzerprofil von Okta enthält bereits ein Abteilung Attribut, daher kann Schritt 2 übersprungen werden — ordnen Sie es direkt in Schritt 3 zu und wählen Sie Erstellen und aktualisieren.
Alternativen, wenn Abteilung bereits zugeordnet ist. Die folgenden verhalten sich alle identisch, liegen unter demselben übergeordneten Element und haben keine Voraussetzungen — ersetzen Sie den Attributnamen sowohl im Externer Name als auch im Namespace und fügen Sie in Schritt 2 ein passendes Quellattribut hinzu, wenn das Okta-Profil noch keines enthält:
Kostenstelle
Business-Feld, variiert zwischen Benutzern, sodass ein falscher Wert sichtbar ist
Unternehmen
Oft bei allen Benutzern identisch, wodurch ein Fehler schwerer zu erkennen ist
employeeNumber
Häufig bereits als Identitätsfeld zugeordnet — vor dem Deklarieren prüfen
Pronomen
Befindet sich unter dem Zoom Erweiterung statt unter der Enterprise-Erweiterung, sodass es denselben Namespace wie jedes andere Szenario in diesem Leitfaden verwendet und die obige Formatfrage vollständig vermeidet
Szenario 1 — Zoom Phone-Standort und automatische Durchwahl. Deklarieren Sie zoomPhoneSite mit Attributtyp: Gruppe und legen Sie seinen Wert für die Okta-Gruppe jedes Standorts fest, sodass die Gruppenmitgliedschaft den Standort direkt bestimmt und keine Übersetzungslogik erforderlich ist. Deklarieren Sie zoomPhoneExtNumber als persönliches Attribut mit einem standardmäßigen Wert von 0 es sei denn, Sie migrieren eine bereits vorhandene Konfiguration von Erweiterungen.
Szenario 2 — Tarif je nach Land unterschiedlich. Deklarieren Sie zoomPhoneCallingPlan mit Attributtyp: Gruppe und erstellen Sie eine Gruppe pro Tarifregion, wobei Sie den Tarifwert jeder Gruppen-Zoom-Anwendungszuweisung festlegen. Benutzer übernehmen den korrekten Tarif über die Mitgliedschaft, und der in Okta gespeicherte Wert ist genau der von Zoom erwartete Wert. Dadurch wird die Konfiguration auch von der Zuweisungen Registerkarte aus sichtbar und prüfbar. Eine Gruppe, die -1 bietet eine saubere Möglichkeit, Anrufberechtigungen zu entziehen, ohne den Benutzer zu löschen.
Szenario 3 — Contact Center-Paket, Rolle und Region. Deklarieren Sie zoomContactCenterPackage als aufzählbares Attribut, das auf die drei zulässigen Werte beschränkt ist, sodass nie ein ungültiges Paket eingegeben werden kann. Deklarieren Sie ZoomContactCenterRole als Attribut auf Gruppenebene, da die Rolle im Allgemeinen der Teamstruktur folgt. Verlassen zoomKontaktzentrumRegion nicht zugeordnet in Einzelregionsbereitstellungen.
Problembehebung
Fehler
Benutzer existiert nicht oder gehört nicht zu diesem Konto
Dieser Fehler tritt auf, wenn die E-Mail-Adresse eines Zielbenutzers aufgrund eines bereits vorhandenen Kontos nicht bereitgestellt werden kann. Zoom-Administratoren werden gebeten, den Benutzer direkt zu kontaktieren und den Benutzer manuell zum Konto einzuladen.
Sie können keine kostenpflichtigen Benutzer hinzufügen
Dieser Fehler tritt auf, wenn SCIM versucht, einen Benutzer bereitzustellen, obwohl auf dem Konto nicht genügend Lizenzen vorhanden sind. Um den Fehler zu beheben, muss der Benutzer als Basic-Benutzer bereitgestellt werden, oder eine Lizenz muss für die Bereitstellung verfügbar gemacht werden.
Mithilfe von SCIM-Protokollen zur Fehlerbehebung bei der Benutzerbereitstellung
Zoom stellt die neuesten 100 API-Anforderungsprotokolle in den Zoom Marketplace. Ein Zoom-Administrator kann diese Protokolle verwenden, um zu bestätigen, welche Informationen über Bereitstellungs-APIs gesendet und empfangen werden. Um auf die Protokolle zuzugreifen, melden Sie sich als Zoom-Administrator im Zoom Marketplace an und klicken Sie auf Verwalten. Auf der folgenden Seite Anrufprotokolle unter Persönliche App-Verwaltung. Klicken Sie dort auf einen Eintrag, um die API-Protokolle zu erweitern und den Inhalt zu überprüfen.
Das folgende Bild zeigt ein Beispiel für eine SCIM-Benutzerbereitstellungsanfrage, wobei die Identitäts- und Lizenzierungsattribute des Benutzers zur Referenz hervorgehoben sind.
Wie bei der Antwortzuordnung kann Zoom nur Informationen anwenden, die vom Identitätsanbieter in der Bereitstellungsanfrage übermittelt werden. Verwenden Sie diese Protokolle, um zu bestätigen, dass Benutzeridentitäts- und Lizenzierungsattribute vom Identitätsanbieter übermittelt werden. Wenn erwartete Informationen in diesen Assertions fehlen, wenden Sie sich an Ihren Identitätsanbieter, um Support zu erhalten.
Zuletzt aktualisiert
War das hilfreich?