> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/de/administrationsbereich/account-and-endpoint-management/scim-guide.md). # 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**](#understanding-scim-attributes) 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](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), der [Zoom SSO- und Bereitstellungsartikel für Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), und der [Zoom-SSO-Artikel für Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256). {% hint style="danger" %} **Warnung** Falsch konfiguriertes Provisioning wirkt sich auf bestehende Benutzer aus, einschließlich der Entfernung bereits verwendeter Lizenzen. Validieren Sie jede Änderung an einem einzelnen Testbenutzer, bevor Sie sie auf eine Live-Umgebung anwenden. {% endhint %} ### **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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540) * Kontoinhaber- oder Administratorrechte für das Zoom-Konto * [Single Sign-On](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) im Zoom-Konto aktiviert * Ein [verifizierte zugehörige Domain](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) 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**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) 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 `Benutzertyp` Attribut 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: ``` urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneSite ``` 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**.
EigenschaftAus dem Beispiel extrahiertWas es macht
Namespaceurn:ietf:params:scim:schemas:extension:zoom:1.0:BenutzerTeilt 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.
NamezoomPhoneSiteIdentifiziert 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.
DatentypZeichenketteTeilt 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 WertLON-01, ein Name des Zoom Phone-StandortsDie 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.
{% hint style="danger" %} **Warnung** Zoom veröffentlicht mehr als einen Benutzererweiterungs-Namespace. Produktkonfigurations- und Lizenzierungsattribute verwenden `urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer`, der der Namensraum ist, den dieser Leitfaden durchgängig verwendet. Standard Enterprise-Felder wie `Abteilung`, `Manager`, und `Kostenstelle` verwenden `urn:ietf:params:scim:schemas:extension:Enterprise:2.0:Benutzer`. Ein drittes, `urn:us:Zoom:scim:schemas:extension:1.0:ZoomBenutzer`, enthält Informationen zum Anmeldetyp, die in API-Antworten zurückgegeben werden, statt während der Bereitstellung konfiguriert zu werden. Ein Attribut, das auf dem falschen Namespace aufgebaut ist, wird von Ihrem Identitätsanbieter akzeptiert und von Zoom stillschweigend ignoriert. {% endhint %} #### Suchen Sie in der SCIM2 API-Referenz nach dem Attribut, das Sie benötigen Der [SCIM2 API-Referenz](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) 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:Benutzer` Objekt. 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 — `zoomPhoneExtNumber` gesetzt auf `0` löst die automatische Durchwahlzuweisung aus, `zoomPhoneCallingPlan` gesetzt auf `-1` entfernt alle Anrufpläne und `zoomPhoneNumber` muss 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: ``` Elternteil urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer Doppelpunkt : Untergeordnetes Element zoomPhoneStandort Kennung urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneStandort ``` 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: ``` Basis (übergeordnetes Element) urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer Zoom Phone Standort urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneStandort Zoom Phone Nummer urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneNumber Zoom Phone Durchwahl urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneExtNumber Zoom Phone Tarif urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomPhoneCallingPlan ``` Der gleiche Elternteil trägt jedes andere Zoom-Produkt. An der Konstruktion ändert sich nichts, wenn sich das Produkt ändert: ``` Contact Center-Paket urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomContactCenterPackage Rolle „Revenue Accelerator“ urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomRevenueAcceleratorRole Arbeitsplatz-Bundle urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomWorkplace Zoom Docs urn:ietf:params:scim:schemas:extension:zoom:1.0:Benutzer:zoomDocs ``` 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](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), 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.
Basic-ZuordnungErweiterte Zuordnung
Was der Wert istText, der im Profil eines Benutzers gespeichert istEin Verweis auf ein Objekt in Zoom oder ein Anspruch auf einen gekauften Sitzplatz
BeispieleAbteilung, Titel, KostenstellezoomPhoneSite, ZoomContactCenterRole, ZoomWorkplace
ÜbergeordnetOberste Ebene oder die Enterprise-ErweiterungDie Zoom-Erweiterung
Voraussetzungen in ZoomKeineDas Objekt muss existieren oder der Sitzplatz muss frei sein
Wenn der Wert falsch istFalscher Text wird in einem Profil angezeigtDas 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: ``` Basis (Parent) urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer Abteilung urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Abteilung Kostenstelle urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Kostenstelle Mitarbeiternummer urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Mitarbeiternummer Unternehmen urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Unternehmen Manager urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Manager ``` Das Befüllen von Abteilung und Kostenstelle über SCIM erfordert keine SAML-Zuordnung mehr. {% hint style="info" %} **Empfehlung** Weisen Sie zuerst ein Basisattribut zu — `Abteilung` ist ein guter Kandidat und wird als durchgearbeitet **Szenario 0** in den Referenzszenarien — und führen Sie es vor der Konfiguration von irgendetwas in der Zoom-Erweiterung für einen einzelnen Test-Benutzer einmal vollständig aus. A `Abteilung` Der Wert, der korrekt auf einem Zoom-Profil angezeigt wird, beweist die Schemaklaration, das Mapping, den Geltungsbereich und Ihre Fähigkeit, die Bereitstellungsprotokolle zu lesen. Jedes der folgenden erweiterten Attribute unterscheidet sich nur darin, worauf es verweist, nicht darin, wie es konfiguriert ist. {% endhint %} #### 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.
EbeneZweckMicrosoft Entra IDOkta
1. DeklarierenTeilen Sie dem Identitätsanbieter mit, dass das Attribut in der Zoom-Anwendung vorhanden ist, damit es als Zuordnungsziel Verfügbar wird.Schritt 1Schritt 1
2. ZuordnenDefinieren Sie, woher der Wert stammt.Schritt 2Schritte 2–3
3. UmfangBestimmen Sie, auf welche Benutzer die Konfiguration angewendet wird und wann sie ausgeführt wird.Schritte 3–5Schritte 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**](https://zoom.com/account) → [**Sicherheit und Vertrauen**](https://zoom.com/account/setting/security), und verwalten Sie zugehörige Domänen unter [**Administrator-Center**](https://zoom.com/account) → **Konto** → [**Kontoprofil**](https://zoom.com/account); siehe [Zoom + Microsoft Entra ID SSO/SCIM-Konfiguration](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121). 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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911). * **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. | Attribut | Was bereits existieren muss | Wie man es erstellt | | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929). | | `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](https://zoom.com/account) → Produktkonfiguration → Telefonsystem → [Unternehmensinformationen](https://zoom.com/pbx/page/telephone/settings#/settings) → **Standort hinzufügen**, oder **Importieren** für die Massenanlage. Siehe [Mehrere Standorte verwalten](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716). | | `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](https://zoom.com/account) → Produktkonfiguration → Telefonnummern → [Telefonnummern](https://zoom.com/cpw/page/phoneNumbers#/number-list). Kaufen oder portieren Sie hier und lassen Sie die Zielnummer unzugewiesen, damit SCIM sie übernehmen kann. Siehe [Nummernverwaltung zum Verwalten von Telefonnummern verwenden](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) und [Telefonnummern verwalten](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212). | | `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](https://zoom.com/account) → Produktkonfiguration → Telefonsystem → [Benutzer & Räume](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → das Objekt auswählen, das die Durchwahl enthält → **Profil** → **Durchwahl** → **Bearbeiten**. Siehe [Einstellungen für Telefonbenutzer ändern](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338). | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) und [Verwaltung von Telefonbenutzern](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Tarifcodes sind in der [Zoom Phone Tarifreferenz](https://developers.zoom.us/docs/api/references/phone-calling-plans/), oder zurückgegeben als `Typ` von der [Tarife auflisten](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 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. | Attribut | Was bereits existieren muss | Wie man es erstellt | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874). | | `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](https://zoom.com/account) → CX-Management → Contact Center → [Rollen](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Hinzufügen** → Konfigurieren Berechtigungen → **Speichern**. Siehe [Verwalten von Zoom Contact Center-Rollen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941). | | `zoomKontaktzentrumRegion` | Die Region. Wenn sie weggelassen wird, wird die Hauptregion des Kontos zugewiesen, die konfiguriert sein muss. | [Administrator-Center](https://zoom.com/account) → CX-Management → Contact Center → [Einstellungen](https://zoom.com/cci/index/admin#/admin-preferences) → Regionen → **Hinzufügen Region** → einen Namen eingeben und eine SIP Zone auswählen → **Hinzufügen**. Siehe [Verwalten von Zoom Contact Center-Regionen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668). | | `zoomKontaktCenterBenutzerVorlage` | Die Benutzer-Vorlage, genau benannt. Hinzufügen-Typ-Vorlagen gelten bei der Benutzererstellung; Update-Typ-Vorlagen gelten bei der Aktualisierung. | [Administrator-Center](https://zoom.com/account) → CX-Management → Contact Center → Benutzer → [Vorlagen](https://zoom.com/cci/index/admin#/admin-agents#templates) → **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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). | {% hint style="danger" %} **Warnung** Die Funktion für Contact Center-Regionen muss von Zoom-Support aktiviert werden, bevor Regionen erstellt werden können, und jeder Benutzer gehört genau einer Region an. Da es sich um eine Support-Anfrage und nicht um eine Selbstbedienungsoption zum Umschalten handelt, sollte dies frühzeitig angefragt werden, wenn eine Bereitstellung mit mehreren Regionen geplant ist. {% endhint %} **Posteingänge, Warteschlangen und Fähigkeiten haben kein SCIM-Attribut.** Um sie bereitzustellen, erstellen Sie sie vorab in [Administrator-Center](https://zoom.com/account) → 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.
ObjektWie man es erstellt
WarteschlangeAdministrator-Center → CX-Management → Contact Center → Warteschlangen → Warteschlange Hinzufügen → Name, Kanal, Agenten → Speichern. Siehe Verwalten von Zoom Contact Center-Warteschlangen.
FähigkeitAdministrator-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.
PosteingangAdministrator-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 | Attribut | Was bereits existieren muss | Wie man es erstellt | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `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](https://zoom.com/account) → Benutzer → [Rollen](https://zoom.com/role#/) → **Revenue Accelerator** Registerkarte → **+ Rolle hinzufügen** → Name und Beschreibung → **Hinzufügen** → Konfigurieren Berechtigungen → **Änderungen speichern**. Siehe [Verwendung der Zoom Revenue Accelerator Rollenverwaltung](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). | | `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. | Attribut | Was bereits existieren muss | Wie man es erstellt | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Rollen[]` (`Wert` / `anzeigen`) | Die Konto-Rolle, genau benannt. Rollen werden von SCIM referenziert, niemals von ihm erstellt. | [Administrator-Center](https://zoom.com/account) → Benutzer → [Rollen](https://zoom.com/role#/) → **Rolle Hinzufügen** → Name und Beschreibung → Konfigurieren von Berechtigungen. Siehe [Rollenverwaltung verwenden](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375). | | `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](https://zoom.com/account) → Sicherheit und Vertrauen → [Single Sign-On](https://zoom.com/account/sso/saml). | 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** — `zoomPhoneExtNumber` gesendet als `0`, 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](https://zoom.com/account) → Benutzer → [Gruppen](https://zoom.com/account/group#/) nachdem die Gruppe erscheint. {% hint style="info" %} **Empfehlung** Betrachten Sie den Ausbau auf Zoom-Seite als eine vorausgesetzte Phase mit eigener Abnahme, die abgeschlossen und überprüft ist, bevor die Arbeit an der Attributzuordnung beginnt. Standorte, Nummern, Tarife, Rollen und Vorlagen werden häufig von einem anderen Team betreut als die Konfiguration des Identitätsanbieters, und das Auffinden eines fehlenden Objekts während der Bereitstellungstests kostet erheblich mehr als die vorherige Bestätigung seiner Existenz. {% endhint %} ### **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. {% hint style="info" %} **Empfehlung** Entscheiden Sie sich für die Quelle der Wahrheit, bevor Sie die Konfiguration des Identitätsanbieters ändern. Die meisten fehlgeschlagenen SCIM-Bereitstellungen sind Verzeichnisdatenprobleme, die als Bereitstellungsprobleme dargestellt werden. {% endhint %} ### **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. | Attribut | Typ | Notizen | | --------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | | `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**](https://zoom.com/account) → **Produktkonfiguration** → **Telefonsystem** → [**Unternehmensinformationen**](https://zoom.com/pbx/page/telephone/settings#/settings) → **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. | Attribut | Typ | Notizen | | -------------------- | ------------ | ------------------------------------------------------------------ | | `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. {% hint style="info" %} **Hinweis** Der standardmäßig konfigurierte Standort in einem Zoom Phone-Konto heißt typischerweise genau `Hauptstandort`, sichtbar unter [**Administrator-Center**](https://zoom.com/account) → **Produktkonfiguration** → **Telefonsystem** → [**Unternehmensinformationen**](https://zoom.com/pbx/page/telephone/settings#/settings). Bestätigen Sie den Namen im jeweiligen Konto, bevor Sie sich darauf verlassen, da er umbenannt werden kann. {% endhint %} #### 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](https://developers.zoom.us/docs/api/references/phone-calling-plans/). **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](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 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](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 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. | Attribut | Typ | Zulässige 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 1. Melden Sie sich im Zoom-Webportal als Kontoinhaber an. 2. Navigieren Sie zum [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Verwalten** → **Apps im Konto**. 3. 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. 4. Öffnen Sie die **Anrufprotokolle** Registerkarte aus. 5. Verwenden **Nach Endpunkt suchen**oder die Filter für den Datumsbereich, die Methode und den Status, um den relevanten Anruf zu finden. 6. Wählen Sie die Zeile aus, um sie zu erweitern. 7. Überprüfen `requestBody` um genau zu sehen, was gesendet wurde, und `Antwort` um 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
CodeMeldungUrsache und Lösung
400Das Konto hat Single Sign-On nicht aktiviert.SSO ist eine Voraussetzung für SCIM. Aktivieren und Konfigurieren Sie SSO zuerst im Zoom-Konto.
400Benutzer ist inaktiv oder gesperrt.Der Ziel-Zoom-Benutzer kann in seinem aktuellen Zustand nicht aktualisiert werden. Beheben Sie den Kontostatus im Zoom-Webportal.
403Die 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.
404Benutzer 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.
409Die 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.
409Das 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.
409Mit [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.
429Zu 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. {% hint style="info" %} **Hinweis** Wenn Zoom und der Identitätsanbieter sich bei der Konfiguration eines Benutzers nicht einig sind, behandeln Sie den Identitätsanbieter als maßgeblich und korrigieren Sie den Wert dort. Eine Bearbeitung direkt im Zoom-Webportal erzeugt einen Zustand, den das nächste Bereitstellungs-Event überschreibt, was die Diagnose des zugrunde liegenden Problems erschwert. {% endhint %} ## **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 `Zusammenarbeit` Wert von `Benutzertyp` wird aufgrund einer Microsoft-spezifischen Einschränkung mit Entra ID nicht unterstützt. {% hint style="info" %} **Hinweis** Die Standard-Bereitstellungskonfiguration kann von beiden aus durchgeführt werden `entra.microsoft.com` oder `portal.azure.com`. Der in Schritt 1 verwendete Schema-Editor ist jedoch nur über die Azure-Portal-URL mit dem `forceSchemaEditorEnabled` angehängten Parameter erreichbar. Dieser Schalter hat keinen Einfluss auf `entra.microsoft.com`. Verwenden Sie für alle Schritte in diesem Teil den Azure-Portal-Link in Schritt 1, um zu vermeiden, dass während der Konfiguration zwischen Portalen gewechselt wird. {% endhint %} ### 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. 1. Anmelden Sie sich beim Azure-Portal unter Verwendung der URL des Schema-Editors: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home` 2. Unter **Azure-Dienste**, auswählen **Microsoft Entra ID**. 3. Im linken Navigationsmenü unter **Verwalten**, klicken **Enterprise-Anwendungen**. 4. 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. 5. 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. 6. 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**. 7. In der unteren linken Ecke auswählen **Anzeigen erweiterte Optionen** Kontrollkästchen. 8. Klicken Sie auf **Attributliste für Zoom bearbeiten**. 9. 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:zoomPhoneSite` * **Typ**: auswählen **Zeichenfolge** oder **Boolesch**, entsprechend dem in der SCIM2 API-Referenz dokumentierten Datentyp. 10. Wiederholen Sie Schritt 9 für jedes weitere Attribut. 11. In der oberen linken Ecke klicken **Speichern**. {% hint style="warning" %} **Achtung** Attributnamen sind case-sensitiv und müssen genau mit der API-Referenz übereinstimmen. `zoomPhoneSite` ist gültig; `zoomphonesite` und `ZoomPhoneSite` sind es nicht. Ein falsch geschriebenes Attribut wird vom Schema-Editor ohne Fehler akzeptiert und schlägt bei der Zoom API stillschweigend fehl. Für Attribute, die als `boolesch`, **Zeichenfolge** ist ebenfalls gültig, sofern die zugeordnete Quelle den Literaltext bereitstellt `wahr` oder `false`. Auswählen **Zeichenfolge** ist oft praktischer, wenn die Quelle ein Entra-Erweiterungsattribut ist, das Text speichert. {% endhint %} ### Schritt 2: Eine Verzeichnisquelle dem Attribut zuordnen Entra ID bietet drei Zuordnungstypen, und die Wahl zwischen ihnen ist die folgenreichste Entscheidung in der Konfiguration.
ZuordnungstypVerwenden, wennVerhalten
DirektEin Entra-Feld enthält bereits den exakten Wert, den Zoom erwartet.Gibt den Quellwert unverändert weiter.
KonstantJeder Benutzer im Geltungsbereich sollte denselben Wert erhalten.Sendet jedem bereitgestellten Benutzer einen festen Wert.
AusdruckDer 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:** 1. Zurück zu **Bereitstellung** → **Zuordnungen** → **Microsoft Entra ID-Benutzer bereitstellen**. 2. Klicken Sie unten links auf **Neue Zuordnung Hinzufügen**. 3. Konfigurieren Sie die Zuordnung entsprechend dem ausgewählten Typ — siehe die Anleitung unten. 4. Klicken Sie auf die **Zielattribut** Dropdown öffnen und das in Schritt 1 angegebene Attribut auswählen. 5. 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**. 6. 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. 7. Klicken Sie auf **OK**. 8. 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. {% hint style="info" icon="lightbulb" %} **Tipp** Ausfüllen **standardmäßig, wenn null** immer dann, wenn ein fehlender Quellwert zu einem Fehler oder einem unbeabsichtigten Ergebnis führen würde. Ein standardmäßig gesetzter Wert von `Hauptstandort` auf einer Standortzuordnung stellt sicher, dass Benutzer ohne einen Standort erfolgreich bereitgestellt werden, anstatt in einem undefinierten Zustand zu landen. {% endhint %} #### 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()-Anweisung` die ein oder mehrere Quellattribute auswertet Eine Ausdruckszuordnung ist immer dann erforderlich, wenn der Verzeichniswert und der Zoom-Wert nicht dieselbe Zeichenfolge sind: ``` IIF([officeLocation]="London","LON-01", IIF([officeLocation]="Manchester","MAN-01", "Hauptstandort")) ``` {% hint style="danger" %} **Warnung** Ausdrücke vergleichen Text genau wie eingegeben, einschließlich der Groß-/Kleinschreibung. `GB` und `gb` sind unterschiedliche Werte, ebenso wie `Vereinigtes Königreich` und `vereinigtes Königreich`. Ein Vergleich, der fehlschlägt, löst keinen Fehler aus — er fällt in den standardmäßig vorgesehenen Zweig zurück, und der Benutzer wird stillschweigend mit der falschen Konfiguration bereitgestellt. {% endhint %} Quellwerte in `ToUpper()` und mit Großbuchstaben-Literalen vergleichen, um Inkonsistenzen bei der Groß-/Kleinschreibung zu neutralisieren: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="VEREINIGTES KÖNIGREICH","202", "-1")) ``` #### 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 mit `GB` — 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. 1. Navigieren Sie zu **Microsoft Entra ID** → **Enterprise-Anwendungen** → Ihre Zoom-Anwendung → **Benutzer und Gruppen**. 2. Klicken Sie auf **Benutzer/Gruppe hinzufügen**. 3. Unter **Benutzer und Gruppen**, den vorgesehenen Benutzer oder die Sicherheitsgruppe auswählen. 4. Unter **Eine Rolle auswählen**, Wählen Sie die passende Rolle. 5. 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.
RolleEffekt
BasicStellt 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.
LizenziertWeist 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: 1. Navigieren Sie zu **Bereitstellung** → **Zuordnungen** und auswählen **Microsoft Entra ID-Gruppen bereitstellen**. 2. Umschalten **Aktiviert** zu **Ja**. 3. Bestätigen Sie, dass die standardmäßig festgelegten Zuordnungen vorhanden sind: `Anzeigename` → `Anzeigename`, und `Mitglieder` → `Mitglieder`. 4. Klicken Sie auf **Speichern**. 5. 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. {% hint style="warning" %} **Hinweis: Was SCIM mit Gruppen tut und was nicht** Wenn eine Zoom-Gruppe mit einem übereinstimmenden Namen noch nicht vorhanden ist, erstellt SCIM eine mithilfe der Entra-Gruppe `Anzeigename` genau wie eingegeben. Die Gruppe wird mit Mitgliedern erstellt, aber **ohne jegliche Produktkonfiguration**. Ein Administrator muss weiterhin [**Administrator-Center**](https://zoom.com/account) → **Benutzer** → [**Gruppen**](https://zoom.com/account/group#/) im Zoom-Webportal öffnen und die beabsichtigten Einstellungen anwenden — Zoom Phone-Richtlinien auf Gruppenebene, Anrufberechtigungen oder andere Produktkonfigurationen. SCIM stellt die Existenz und Mitgliedschaft einer Gruppe bereit; es definiert nicht, was diese Gruppe innerhalb von Zoom tut. {% endhint %} ### 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. 1. Navigieren Sie zu **Bereitstellung** → **Bereitstellungsübersicht**. 2. Klicken Sie auf **Bereitstellung auf Abruf**. 3. Suchen Sie nach und wählen Sie einen einzelnen Testbenutzer aus, dann klicken Sie **Bereitstellen**. 4. Ü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. 5. Bestätigen Sie, dass die angezeigten Attributwerte Ihrer Absicht entsprechen. 6. Anmelden im Zoom-Webportal und bestätigen Sie, dass die Konfiguration angewendet wurde. {% hint style="info" %} **Empfehlung** Validieren Sie gegen einen Benutzer, der den *schwierigsten* Fall in Ihrer Benutzergruppe repräsentiert — ein Benutzer im Ausland, ein Benutzer, der über eine andere Methode erstellt wurde, oder ein Benutzer, dessen Quellfeld leer ist. Ein Test, der nur den einfachen Fall abdeckt, deckt die in Schritt 2 beschriebenen Fehlermodi nicht auf. {% endhint %} ### 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. 1. Navigieren Sie zu **Microsoft Entra ID** → **Enterprise-Anwendungen** → Ihre Zoom-Anwendung → **Bereitstellung** → **Bereitstellung**. 2. Umschalten **Bereitstellungsstatus** zu **Ein**. 3. 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 1. Navigieren Sie zu **Microsoft Entra ID** → **Enterprise-Anwendungen** → Ihre Zoom-Anwendung → **Überwachen** → **Bereitstellungsprotokolle**. 2. 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**. 3. Überprüfen Sie die **Zusammenfassung** um zu bestätigen, ob die Aktion erfolgreich war oder fehlgeschlagen ist. 4. 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 Fehler**den #### 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**](#reference-scenarios) 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 **Zeichenfolge**und 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: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="VEREINIGTES KÖNIGREICH","202", IIF(ToUpper([country])="US","200", IIF(ToUpper([country])="VEREINIGTE STAATEN","200", "-1")))) ``` 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. {% hint style="warning" %} **Achtung: Zwei Profile, zwei Zwecke** Okta verwaltet zwei unterschiedliche Profile, die hier relevant sind, und das Verständnis der Trennung verhindert die meiste anfängliche Verwirrung. Das **Okta-Benutzerprofil** ist der Ort, an dem ein Wert ist *gespeichert* gegen eine Person im Verzeichnis. Die **Zoom Benutzer Anwendung Profil** ist der Ort, an dem ein Wert ist *gesendet* zu Zoom, und seine Attribute tragen den SCIM-externen Namen und den Namespace. Eine Konfiguration pro Benutzer benötigt beides sowie eine Zuordnung zum Verbinden der beiden. Eine Konfiguration auf der Ebene der Gruppe benötigt nur das Attribut des Profils der Anwendung, wobei der Wert bei der Zuweisung an die Gruppe gesetzt wird. {% endhint %} ### 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. 1. Anmelden bei der Okta Admin-Konsole. 2. Klicken Sie im linken Navigationsmenü auf **Anwendungen**, dann klicken **Anwendungen**. 3. Unter **STATUS**, klicken **AKTIV**. 4. 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. 5. Klicken Sie auf die **Bereitstellung** Registerkarte aus. 6. Unter **Zoom-Attributzuordnungen**, klicken **Gehen Sie zum Profile Editor**. 7. Unter **Attribute**, klicken **+ Attribut Hinzufügen**. 8. 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:zoomPhoneSite` * **Beschreibung** (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. 9. Klicken Sie auf **Speichern**, oder **Speichern und Hinzufügen eines weiteren**. {% hint style="danger" %} **Warnung** Der externe Name und der externe Namespace müssen beide korrekt sein. Die veröffentlichte Anleitung von Zoom legt den externen Namespace als die vollständige URN fest *einschließlich* der Attributname — zum Beispiel `urn:ietf:params:scim:schemas:extension:Zoom:1.0:Benutzer:ZoomRevenueAcceleratorRole` — statt nur des Namespace. Dies unterscheidet sich von der allgemeinen SCIM-Konvention. Befolgen Sie das oben gezeigte Format, da es der Konfiguration entspricht, die Zoom als funktionierend dokumentiert. Attributnamen sind durchgängig groß- und kleinschreibungssensitiv. Ein falsch geschriebenes Attribut wird vom Profil-Editor ohne Fehler akzeptiert und schlägt bei der Zoom API stillschweigend fehl. {% endhint %} ### 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. 1. Klicken Sie im linken Navigationsmenü auf **Verzeichnis**, dann klicken **Profil-Editor**. 2. Klicken Sie auf die **Benutzer** Registerkarte aus. 3. Klicken Sie im Navigationsmenü von **Benutzer** Box, unter **Filter**, klicken **Alle**. 4. Rechts von **Okta**, klicken Sie auf das **Benutzer** Profil. 5. Unter **Attribute**, klicken **+ Attribut Hinzufügen**. 6. 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. 7. Klicken Sie auf **Speichern**. {% hint style="info" icon="lightbulb" %} **Tipp** Verwenden Sie denselben Namen für das Okta-Benutzerprofilattribut und das Zoom-Anwendungsprofilattribut. Okta verlangt dies nicht, aber übereinstimmende Namen machen die Zuordnungsliste selbsterklärend und reduzieren den Zeitaufwand für die Problembehebung erheblich, wenn die Anzahl der Attribute wächst. {% endhint %} 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 1. Navigieren Sie zu **Anwendungen** → **Anwendungen** → **AKTIV** → die **Zoom** Anwendung. 2. Klicken Sie auf die **Bereitstellung** Registerkarte aus. 3. 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**. 4. Klicken Sie auf die **Attributwert** Dropdown öffnen und auswählen **Zuordnung aus dem Okta-Profil**. 5. Klicken Sie auf das Quell-Dropdown — das anzeigt `Anmeldung | Zeichenfolge` standardmäßig — und das in Schritt 2 erstellte Okta-Benutzerprofilattribut auswählen. 6. 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. 7. Klicken Sie auf **Speichern**. 8. Für jedes Attribut wiederholen. {% hint style="warning" %} **Achtung: Einen Wert ableiten oder übersetzen** Wenn der Okta-Wert und der Zoom-Wert nicht dieselbe Zeichenfolge sind, **Attributwert** akzeptiert das Feld auch die Okta Expression Sprache, die bedingte Logik und Zeichenfolgenfunktionen unterstützt. Die Ausdruckssyntax und die verfügbaren Funktionen variieren je nach Okta-Version; validieren Sie jeden Ausdruck anhand eines einzelnen Testbenutzers unter Verwendung von **Vorschau** bevor Sie ihn breiter anwenden, und konsultieren Sie die aktuelle Dokumentation zur Okta Expression Sprache für unterstützte Funktionen. Wenn die Übersetzung einfach ist und der Wertebereich klein ist, ist es in der Regel wartungsfreundlicher als ein Ausdruck, den Zoom-Wert direkt im Okta-Attribut als Aufzählungsliste zu definieren — oder ein Gruppenattribut zu verwenden, wie in Schritt 5 —. {% endhint %} ### 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. 1. Navigieren Sie zu **Anwendungen** → **Anwendungen** → **AKTIV** → die **Zoom** Anwendung. 2. Klicken Sie auf die **Bereitstellung** Registerkarte aus. 3. Unter **Bereitstellung für App**, klicken **Bearbeiten**. 4. Aktivieren Sie die unten beschriebenen Einstellungen und klicken Sie dann auf **Speichern**. | Einstellung | Effekt | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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. | {% hint style="danger" %} **Warnung** **Benutzerattribute aktualisieren** ist es, was benutzerdefinierte Attributzuordnungen bei vorhandenen Benutzern wirksam macht. Ohne dies gelten Zuordnungen nur im Moment der Benutzererstellung, und jede spätere Änderung in Okta erreicht Zoom nicht. {% endhint %} ### Schritt 5: Werte Benutzern oder Gruppen zuweisen **Um einem einzelnen Benutzer einen Wert zuzuweisen:** 1. Navigieren Sie zu **Verzeichnis** → **Personen** und klicken Sie auf den Namen des Benutzers. 2. Klicken Sie auf die **Profil** Registerkarte, dann klicken Sie auf **Bearbeiten**. 3. Füllen Sie das in Schritt 2 erstellte Attribut mit dem Wert aus, den Zoom erwartet. 4. 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: 1. 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. 2. Navigieren Sie zu **Verzeichnis** → **Gruppen** → die **Alle** Registerkarte, dann klicken Sie auf **Gruppe hinzufügen**. 3. Geben Sie einen **Name** und optional **Beschreibung**, dann klicken **Speichern**. 4. Öffnen Sie die Gruppe und klicken Sie auf die **Anwendungen** Registerkarte aus. 5. Klicken Sie auf **Anwendung zuweisen**, dann klicken **Zuweisen** rechts neben dem **Zoom** Anwendung. 6. Füllen Sie die Gruppenattribute mit den Werten aus, die für jedes Mitglied gelten sollen. 7. Klicken Sie auf **Speichern und zurück**, dann klicken **Fertig**. 8. Klicken Sie auf die Gruppen- **Personen** Registerkarte, dann klicken Sie auf **Personen zuweisen**. 9. 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. 10. 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. 1. Navigieren Sie zu **Anwendungen** → **Anwendungen** → **AKTIV** → die **Zoom** Anwendung. 2. Klicken Sie auf die **Zuweisungen** Registerkarte aus. 3. Unter **Filter**, klicken **Gruppen**. 4. Ziehen Sie die Gruppen per Drag-and-drop in die gewünschte Reihenfolge. {% hint style="info" %} **Empfehlung** Ordnen Sie Gruppen von der spezifischsten bis zur allgemeinsten, damit eine eng abgegrenzte Gruppe — ein bestimmter Standort oder eine bestimmte Rolle — Vorrang vor einer allgemeinen Sammelgruppe hat. Wenn Sie diese Reihenfolge umkehren, überschreibt die allgemeine Gruppe jede spezifische, was sich typischerweise darin äußert, dass eine gesamte Population dieselbe unbeabsichtigte Konfiguration erhält. {% endhint %} ### Schritt 6: Mit dem Okta-Systemprotokoll überprüfen 1. Navigieren Sie zu **Berichte** → **Systemprotokoll**. 2. Filtern Sie nach dem Zielbenutzer oder nach der Zoom Anwendung und schränken Sie den Zeitbereich auf den Bereitstellungsversuch ein. 3. Ö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 Fehler**den {% hint style="warning" %} **Achtung: Der Okta-spezifische stille Fehler** Ein im Zoom-Benutzerprofil deklariertes Attribut, das jedoch nie zugeordnet wurde oder ohne **Benutzerattribute aktualisieren** in Schritt 4 aktiviert, überträgt nichts und bleibt dennoch in der Zuordnungsliste sichtbar. Es wird kein Fehler ausgelöst. Wenn ein Wert Zoom nicht erreicht und das Systemprotokoll überhaupt kein entsprechendes Event anzeigt, überprüfen Sie vor weiteren Untersuchungen die Zuordnung und die Bereitstellungseinstellungen. {% endhint %} #### 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**](#reference-scenarios) 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**. {% hint style="warning" %} **Achtung: Namespace-Format für Attribute der Enterprise-Erweiterung** Die WARNUNG in Schritt 1 beschreibt die Zoom-Konvention, den Attributnamen an den External-Namespace anzuhängen. Diese Anleitung ist für Attribute unter der Zoom-Erweiterung dokumentiert. `Abteilung` gehört zur standardmäßigen SCIM-Enterprise-Erweiterung, bei der Okta standardmäßig den Namespace und den externen Namen in separaten Feldern belässt, wie oben gezeigt. Wenn der Wert Zoom nicht erreicht, versuchen Sie die angehängte Form — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:department` — und bestätigen Sie, welche Form im Marketplace-Anrufprotokoll erfolgreich war. {% endhint %} **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: | Attribut | Notizen | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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.

Beispiel für einen Bereitstellungsfehler.

#### 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.

Beispiel für einen Bereitstellungsfehler.

### Mithilfe von SCIM-Protokollen zur Fehlerbehebung bei der Benutzerbereitstellung Zoom stellt die neuesten 100 API-Anforderungsprotokolle in den [Zoom Marketplace](https://marketplace.zoom.us/). 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.

Beispiel für eine SCIM-Benutzerbereitstellungsanfrage.

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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://library.zoom.com/technical-library/de/administrationsbereich/account-and-endpoint-management/scim-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.