- Startseite
- /
- Artikel
Einrichten der Entra ID (Azure AD) Wizard-App in Control Hub
Wenn Sie Ihre Benutzer und Gruppen in Microsoft Entra ID verwalten, verwenden Sie die Entra ID (Azure AD) Wizard-App in Control Hub, um Benutzer und Gruppen mit Webex zu synchronisieren.
Entra-ID in Control Hub aktivieren
In Webex for Government verbindet sich die Entra ID (Azure AD) Wizard-App ausschließlich mit der Entra ID Global Identity, die Verbraucher/Unternehmen und GCC Moderate Entra ID (Azure AD)-Kunden abdeckt. GCC High-Kunden müssen die Control Hub-Anwendung in der Microsoft Enterprise Gallery verwenden, um Benutzer und Gruppen für Webex bereitzustellen. Eine Assistentenversion, die GCC High unterstützt, wird in einer zukünftigen Control Hub-Version verfügbar sein.
Einige der in diesem Artikel beschriebenen Funktionen sind noch nicht für alle Kunden verfügbar.
Vorbereitungen
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. | ||||||||||
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . | ||||||||||
3 | Klicken Sie auf Einrichten , um die Konfiguration zu starten. | ||||||||||
4 | Authentifizieren Sie Ihr Entra ID-Administratorkonto. Wenn Sie kein globaler Administrator oder Administrator mit Privilegien in der Entra-ID sind, können Sie den Zugriff anfordern, um der Entra-ID-Wizard-App (Azure AD) die Berechtigung zu erteilen. Wenn Sie über volle Administratorrechte in der Entra-ID verfügen, können Sie Anfragen überprüfen und den Zugriff gewähren, indem Sie zu Aktivität die Option Administratoreinwilligungsanfragen und klicken Sie auf Cisco Webex Identitätsintegration und wählen Sie Berechtigungen prüfen und akzeptieren . Dieser Prozess gewährt der Webex-Anwendung eine allgemeine Authentifizierung. . Wählen Sie unterKlicken Sie abschließend auf die Registerkarte Alle (Vorschau) , wählen Sie Cisco Webex Identitätsintegration und klicken Sie auf Anwendung prüfen . Unter , klicken Sie auf Erteilen Sie Administratoreinwilligung für Cisco , um alle erforderlichen Berechtigungen zum Aktivieren der Entra-ID in Control Hub zu erteilen. Weitere Informationen zu diesem Prozess finden Sie unter Microsoft-Support . | ||||||||||
5 | Überprüfen Sie die Berechtigungen und klicken Sie auf Akzeptieren , um die Kontoautorisierung für den Zugriff auf Ihren Entra ID-Tenant zu erteilen. Cisco Webex Identity ist eine Entra ID-Unternehmensanwendung in Entra ID. Die Wizard-App stellt eine Verbindung zu dieser Anwendung her, um auf Entra-ID-Diagramm-APIs zuzugreifen. Die für den Zugriff erforderlichen Berechtigungen sind die minimalen Berechtigungen, die für die Unterstützung und Verwendung erforderlich sind.
| ||||||||||
6 | Für SMB-Kunden akzeptieren Sie die Standardeinstellungen, indem Sie das Kontrollkästchen Standardeinstellungen synchronisieren aktivieren und auf Fortfahren klicken. Gehen Sie für Unternehmenskunden zum nächsten Schritt und setzen Sie die Konfiguration fort. Wenn Sie die Standardeinstellungen akzeptieren, bedeutet dies, dass Sie Folgendes tun möchten:
| ||||||||||
7 | Für Enterprise-Kunden (mehr als 1000 Benutzer) oder die Kunden, die die Einstellungen manuell konfigurieren möchten, klicken Sie auf die Registerkarte Attribute und ordnen Sie die Attribute zu. Klicken Sie auf Speichern. Sie können andere Benutzerattribute von der Entra-ID zu Webex zuordnen oder vorhandene Benutzerattribute-Zuordnungen über die Seite Attribute ändern. Sie können die Zuordnung anpassen, indem Sie sicherstellen, dass Sie sie richtig konfigurieren. Der Wert, den Sie als Benutzername zuordnen, ist wichtig. Webex verwendet die E-Mail-Adresse des Benutzers als Benutzernamen. Standardmäßig wird der userPrincipalName (UPN) in der Entra-ID der E-Mail-Adresse (Benutzername) in Control Hub zugeordnet. Sie können die Zuordnung während der ersten Einrichtung nicht bearbeiten. Zu diesem Zeitpunkt ist die entsprechende Instanz nicht vollständig erstellt und es gibt keine Instanz des benutzerdefinierten Mapping-Attributs. Sie können jedoch auf Bearbeiten klicken, um es zu ändern, wenn die Einrichtung abgeschlossen ist. | ||||||||||
8 | Fügen Sie Benutzer zum Synchronisierungsbereich hinzu, indem Sie auf die Registerkarte „Benutzer“ klicken. Sie können den Benutzernamen eingeben, um den Benutzer im Synchronisierungsbereich zu suchen und hinzuzufügen. Sie können auch einen Benutzer aus dem Synchronisierungsbereich entfernen, indem Sie auf die rechte Seite Papierkorb-Symbol klicken. Klicken Sie auf Speichern. Wenn Sie alle Benutzer aus der Entra-ID auswählen möchten, wählen Sie Alle Benutzer auswählen . Wenn Sie diese Option auswählen, müssen Sie keine Gruppen im Bereich auswählen, da diese Option die Gruppen gleichzeitig synchronisiert. Wir empfehlen die Verwendung von Alle Benutzer auswählen für bedeutende Unternehmenskunden mit Hunderttausenden von Benutzern nicht, da der Initialisierungsprozess eine lange Zeit erfordert. Wenn Sie versehentlich viele Benutzer in Control Hub synchronisieren, dauert es auch länger, diese Benutzer zu löschen. Klicken Sie auf Speichern. | ||||||||||
9 | Auf der Registerkarte Gruppen können Sie nach einzelnen Gruppen suchen und sie zu Webex hinzufügen.
Klicken Sie auf Speichern. Standardmäßig werden nur die Benutzer in den ausgewählten Gruppen synchronisiert. Gehen Sie zur Registerkarte Mehr und wählen Sie Gruppenobjekte synchronisieren , wenn Sie auch die Gruppen selbst synchronisieren möchten. | ||||||||||
10 | Auf der Registerkarte Mehr können Sie einige erweiterte Synchronisierungsoptionen konfigurieren:
| ||||||||||
11 | Sie können entscheiden, ob die Synchronisierung sofort oder zu einem späteren Zeitpunkt erfolgen soll. Wenn Sie die Option „Jetzt zulassen“ auswählen , werden alle Einstellungen auf die anstehende Synchronisierung angewendet. Wenn Sie die Option Speichern und später zulassen auswählen, wird die Synchronisierung erst gestartet, wenn Sie die automatische Synchronisierung zulassen. | ||||||||||
12 | Die Anwendung kommuniziert mit der Entra-ID, um die Konfiguration einzurichten, und plant die Synchronisierung. |
- Aktiv: die Synchronisierung war erfolgreich.
- Quarantäne : der Synchronisierungsauftrag wurde nach mehreren Fehlern in der Entra-ID unter Quarantäne gestellt. Weitere Informationen finden Sie in der Dokumentation zur Entra-ID .
- NotRun : dieser Status wird erst nach der ersten Einrichtung angezeigt. Der Dienst wird nach der ersten Einrichtung noch nicht ausgeführt.
Sie können auch auf Zusammenfassung anzeigen klicken, um zusätzliche Informationen anzuzeigen, z. B. Uhrzeit und Datum der letzten Synchronisierung und die Anzahl der synchronisierten, übersprungenen oder fehlgeschlagenen Benutzer:
Benutzer
- Synchronisiert : zeigt die Anzahl der Benutzer an, die erfolgreich mit Webex synchronisiert wurden.
- Übersprungen : zeigt die Anzahl der Benutzer an, die bei der letzten Synchronisierung übersprungen wurden. Beispielsweise neue Benutzer in der Entra-ID, die nicht zum Synchronisierungsbereich der Entra-ID (Azure AD) Wizard-App hinzugefügt wurden. Diese Benutzer wurden nicht mit Webex synchronisiert; fügen Sie sie im Synchronisierungsbereich hinzu, um sie mit Webex zu synchronisieren.
- Fehler : zeigt die Anzahl der Benutzer an, die nicht synchronisiert werden konnten. Weitere Informationen dazu, warum diese Benutzer nicht synchronisiert wurden, finden Sie im Entra ID-Überwachungsprotokoll für die Anwendungsbereitstellung. Wenn Sie diese Benutzer sofort synchronisieren müssen, können Sie Benutzer auf Anfrage bereitstellen .
Gruppen
- Synchronisiert : zeigt die Anzahl der Gruppen an, die erfolgreich mit Webex synchronisiert und in Control Hub erstellt wurden.
- Zu Synchronisieren : dieser Status zeigt an, dass noch nicht alle Benutzer in einer Gruppe hinzugefügt wurden. Die Benutzer müssen zuerst erfolgreich mit Webex synchronisiert werden.
Vorhandene Konfigurationen der Cisco Webex Enterprise-App zur Entra ID (Azure AD) Wizard-App migrieren
Wenn Sie bereits eine Cisco Webex Enterprise-App in Entra ID eingerichtet haben, können Sie alle Konfigurationen automatisch in die Entra ID (Azure AD) Wizard-App migrieren. Sie können die Entra-ID in Control Hub verwalten, ohne Ihre vorherigen Konfigurationen zu verlieren.
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. | ||||||||||
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . | ||||||||||
3 | Klicken Sie auf Einrichten , um die Konfiguration zu starten. | ||||||||||
4 | Authentifizieren Sie das Entra ID-Administratorkonto mit der Entra ID-Konfiguration. Stellen Sie sicher, dass Sie ein Konto verwenden, das über die im nächsten Schritt beschriebenen Berechtigungen verfügt. | ||||||||||
5 | Überprüfen Sie die Berechtigungen und klicken Sie auf Akzeptieren , um die Kontoautorisierung für den Zugriff auf Ihren Entra ID-Tenant zu erteilen. Cisco Webex Identity Synchronization ist eine Entra ID-Unternehmensanwendung in Entra ID. Die Wizard-App stellt eine Verbindung zu dieser Anwendung her, um auf Entra-ID-Diagramm-APIs zuzugreifen. Die für den Zugriff erforderlichen Berechtigungen sind die minimalen Berechtigungen, die für die Unterstützung und Verwendung erforderlich sind.
| ||||||||||
6 | Wählen Sie Vorhandene App migrieren . | ||||||||||
7 | Nachdem Sie zusätzliche schreibgeschützte Berechtigungsanfragen akzeptiert haben, wählen Sie die vorhandene App aus, die Sie in die Wizard-App migrieren möchten, und wählen Sie dann „Fortfahren“ . Wenn die ausgewählte vorhandene App keine Benutzer im selben Control Hub bereitstellt, schlägt die Migration fehl. | ||||||||||
8 | Nach Abschluss der Migration empfehlen wir Ihnen, einen Probelauf durchzuführen , bevor Sie die automatische Synchronisierung aktivieren, um sicherzustellen, dass es keine Fehler gibt. |
Probelauf durchführen
Bevor Sie die automatische Synchronisierung aktivieren, empfehlen wir Ihnen, zuerst einen Probelauf durchzuführen, um sicherzustellen, dass es keine Fehler gibt. Nach Abschluss des Probelaufs können Sie einen Probelauf-Bericht herunterladen, um detaillierte Informationen anzuzeigen. Die verfügbaren Spalten im Bericht sind:
Spaltenname | Beschreibung |
---|---|
Objekttyp | Objekttyp in Entra ID, z. B. Benutzer oder Gruppe. |
Aktionstyp | Aktionstyp, der während einer Synchronisierung mit dem Objekt ausgeführt wird. Mögliche Aktionstypen sind:
|
Azure-ID | ID des Objekts in Entra ID. |
Azure-Name | Name des Objekts in Entra ID. |
Webex-Name | Name des Objekts in Webex. |
Grund | Grund dafür, warum während einer Synchronisierung ein Aktionstyp auftritt. |
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. |
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . |
3 | Klicken Sie auf die drei vertikalen Punkte neben der Instanz, die Sie synchronisieren möchten, und wählen Sie dann Probelauf . |
4 | Klicken Sie nach Abschluss des Probelaufs auf Zusammenfassung herunterladen , um den Bericht als CSV-Datei herunterzuladen. |
Automatische Synchronisierung aktivieren oder deaktivieren
Die Entra ID (Azure AD) Wizard-App und der entsprechende Backend-Dienst prüfen, ob die automatische Synchronisierung aktiviert ist, um festzustellen, wann Benutzer oder Gruppen von der Entra ID mit Webex synchronisiert werden sollen. Aktivieren Sie „Automatische Synchronisierung“ , um die automatische Bereitstellung von Benutzer- und Gruppensynchronisierung zu ermöglichen. Wenn Sie die automatische Synchronisierung deaktivieren , synchronisiert die Wizard-App nichts mit Webex, aber die vorhandene Konfiguration wird beibehalten.
In der Regel werden Benutzer alle 40 Minuten synchronisiert gemäß Microsoft-Richtlinie.
1 | Melden Sie sich bei Control Hub als vollständiger Organisationsadministrator an. |
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . |
3 | Schalten Sie den Umschalter nach rechts, um die automatische Synchronisierung zu aktivieren. Deaktivieren Sie sie, indem Sie die Option Auto Sync nach links umschalten. |
Konfiguration der Entra ID (Azure AD) Wizard-App bearbeiten
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. |
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . |
3 | Klicken Sie auf Konfiguration bearbeiten . |
4 | Passen Sie die Attributzuordnung an, indem Sie ein Attribut aus der linken Spalte auswählen, das von der Entra-ID stammt. Das Zielattribut in Webex Cloud befindet sich in der rechten Spalte. Weitere Informationen zur Zuordnung von Attributen finden Sie unter Zuordnung von Entra-ID (Azure AD) Wizard-App-Attributen . |
5 | Fügen Sie auf den Registerkarten Benutzer und Gruppen Benutzer und Gruppen aus dem Synchronisierungsbereich hinzu oder entfernen Sie sie. Verschachtelte Gruppen werden nicht automatisch mit der Cloud synchronisiert. Stellen Sie sicher, dass Sie alle Gruppen auswählen, die in den Gruppen verschachtelt sind, die Sie synchronisieren möchten. |
6 | Auf der Registerkarte Mehr können Sie bei Bedarf Ihre Einstellungen ändern. |
7 | Klicken Sie auf „Speichern“ , um die geänderte Konfiguration zu speichern. Ihre Aktualisierungen werden bei der nächsten Synchronisierung angewendet. Der automatische Synchronisierungsmechanismus der Entra-ID verarbeitet die Synchronisierung von Benutzern und Benutzergruppen. |
Den Namen der Webex-Instanz bearbeiten
Ändern Sie, wie der Name der Cisco Webex-Identitätsinstanz in der Entra ID-Unternehmensanwendungsliste angezeigt wird.
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. |
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . |
3 | Klicken Sie auf Instanznamen bearbeiten . |
4 | Geben Sie den Namen der neuen Instanz ein, und klicken Sie dann auf „Speichern“ . |
Konfiguration der Entra ID (Azure AD) Wizard-App löschen
Wenn Sie die Wizard-App Entra ID (Azure AD) löschen, wird die Konfiguration für die Synchronisierung der Entra-ID entfernt. Die Konfiguration wird von Webex oder Entra ID nicht beibehalten. Wenn Sie die Entra-ID-Synchronisierung in Zukunft verwenden möchten, müssen Sie eine vollständige Neukonfiguration vornehmen.
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. |
2 | Wechseln Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Bereich Verzeichnissynchronisierung . |
3 | Klicken Sie auf Instanz löschen . |
4 | Wählen Sie auf der Seite Azure AD-Instanz löschen? die Option Azure AD-Administratoreinwilligung widerrufen aus, wenn Sie die Einwilligungsvereinbarung aus Webex entfernen möchten. Wenn Sie diese Option auswählen, müssen Sie Ihre Anmeldeinformationen eingeben und die Berechtigungen erneut erteilen. |
5 | Klicken Sie auf Löschen. |
Bereitstellen eines Benutzers für Webex bei Bedarf
Sie können einen Benutzer unabhängig von einer Entra-ID-Synchronisierung sofort für Webex bereitstellen und das Ergebnis sofort überprüfen. Dies ist hilfreich bei der Behebung von Problemen während der Einrichtung.
1 | Melden Sie sich bei Control Hub mit einem vollständigen Administratorkonto an. |
2 | Gehen Sie zu Organisationseinstellungen und scrollen Sie nach unten zum Abschnitt Verzeichnissynchronisierung . |
3 | Klicken Sie auf Benutzer auf Anfrage bereitstellen . |
4 | Suchen Sie den Benutzer, den Sie bereitstellen möchten, und wählen Sie ihn aus, und klicken Sie auf Bereitstellen . |
5 | Eines der folgenden Ergebnisse wird angezeigt, wenn es abgeschlossen ist:
|
6 | Klicken Sie auf Erneut versuchen , um denselben Benutzer erneut bereitzustellen, wenn dieser übersprungen wurde oder fehlgeschlagen ist. |
7 | Klicken Sie auf Bereitstellen eines anderen Benutzers , um zur Bereitstellungsseite zurückzukehren. |
8 | Klicken Sie auf „Fertig“ , wenn Sie fertig sind. |
Importieren von Entra ID-verifizierten Domänen in Control Hub
Die Kunden können Hunderte von Domänen in Entra ID verifiziert haben. Während der Integration in Control Hub, wenn die verifizierten Domänen von der Entra-ID in Control Hub importiert werden sollen. Dies kann viele Anstrengungen im Wartungs- oder Einrichtungsprozess sparen.
1 | Navigieren Sie zur Option „Domäne festlegen“ in der Registerkarte „Organisationseinstellungen “ in Control Hub. |
2 | Klicken Sie auf Mit Entra-ID hinzufügen . |
3 | Suchen Sie auf der Seite Verifizierte Domänen hinzufügen nach den hinzuzufügenden Domänen und wählen Sie sie aus. |
4 | Klicken Sie auf Hinzufügen. Die verfizierten Domänen werden in der Liste der verifizierten Domänen angezeigt.
|
Zuordnung der Entra ID (Azure AD) Wizard-App-Attribute
Die Wizard-App Entra ID (Azure AD) kann alle Änderungen, die Sie an Ihren Attributausdrücken vornehmen, unterstützen und synchronisieren. Beispielsweise können Sie in der Entra-ID die displayName
sodass sowohl der surname
und givenName
-Attributen. Diese Änderungen werden in der Wizard-App angezeigt.
Weitere Informationen zur Zuordnung von Attributausdrücken in Entra ID finden Sie auf der Microsoft-Hilfeseite .
In der folgenden Tabelle finden Sie Informationen zu bestimmten Entra-ID-Attributen.
Die Entra-ID synchronisiert keine Null-Werte. Wenn Sie einen Attributwert in der Entra-ID auf null setzen, wird er nicht gelöscht oder mit einem Nullwert in Webex gepatcht. Weitere Informationen finden Sie in den Einschränkungen der Microsoft-Hilfeseite .
Entra-ID-Attribut (Quelle) | Webex-Benutzerattribut (Ziel) | Beschreibung |
---|---|---|
Userprincipalname |
Benutzername |
Es handelt sich um die eindeutige ID des Benutzers in Webex. Es ist eine E-Mail-formatiert. |
displayName |
displayName |
Name des Benutzers, der in der Webex-Anwendung angezeigt wird. |
Nachname |
name.familyName |
|
givenName |
name.givenName |
|
Objectid |
externe ID |
Es handelt sich um die UID des Benutzers in der Entra-ID. Im Allgemeinen handelt es sich um eine 16-Byte-Zeichenfolge. Wir empfehlen Ihnen nicht, diese Zuordnung zu ändern. |
jobTitle |
title |
|
AuslastungStandort |
adressen[type eq "work"].country |
Wir empfehlen die Verwendung der Usagelocation-Zuordnung zu Adressen [type eq "work"].country. Wenn Sie ein anderes Attribut wählen, sollten Sie sicherstellen, dass die Attributwerte den Standards entsprechen. Die USA sollten beispielsweise die USA sein. China sollte CN sein und so weiter. |
Stadt |
adressen[type eq "work"].locality |
|
streetAddress |
adressen[type eq "work"].streetAddress |
|
Staat |
adressen[type eq "work"].region |
|
postalCode |
adressen[type eq "work"].postalCode |
|
telephoneNumber |
phoneNumbers[type eq "work"].value |
|
mobile |
phoneNumbers[type eq "mobile"].value |
|
facsimileTelephoneNumber |
phoneNumbers[type eq "fax"].value |
|
Manager |
Manager |
Synchronisiert Manager-Informationen von Benutzern mit Webex, sodass Benutzer immer die richtigen Manager-Informationen auf der Kontaktkarte eines Benutzers sehen können. Wenn ein Benutzer erstellt wird, überprüft Entra ID, ob sich das Manager-Objekt des Benutzers in der Webex-Identität befindet. Wenn nein, wird das Manager-Attribut des Benutzers ignoriert. Wenn ein Manager-Attribut vorhanden ist, müssen zwei Bedingungen erfüllt sein, damit das Attribut auf der Visitenkarte des Benutzers angezeigt wird:
Diese Bedingungen überprüfen die Aktualisierung auf das Manager-Attribut des Benutzers, wenn das Authentifizierungstoken eines Benutzers abgelaufen ist. Änderungen an Manager-Attributen werden erst nach der ersten Anmeldung des Benutzers nach der Änderung auf der Kontaktkarte des Benutzers angezeigt. |
Häufig gestellte Fragen
Wie kann ich von der Cisco Directory Connector-Bereitstellung zur Entra ID (Azure AD) Wizard-App migrieren?
Während der Einrichtung erkennt die Wizard-App, ob Ihre Organisation den Directory Connector verwendet. Wenn diese Option aktiviert ist, können Sie die Entra-ID verwenden und den Verzeichniskonnektor blockieren. Klicken Sie auf „Blockieren“ , um zu bestätigen, dass Sie die Konfiguration der Entra ID (Azure AD) Wizard-App fortsetzen möchten.
Sie können den Verzeichniskonnektor auch deaktivieren, bevor Sie die Wizard-App konfigurieren. Nach der Konfiguration verwaltet die Wizard-App Benutzerprofile. Die Wizard-App verwaltet jedoch nur die Benutzer, die zum Synchronisierungsbereich hinzugefügt wurden. Sie können die Wizard-App nicht verwenden, um Benutzer zu verwalten, die vom Directory Connector synchronisiert wurden und nicht Teil des Synchronisierungsbereichs waren.
Kann ich Single Sign-On mit Microsoft Entra konfigurieren?
Sie können eine Single Sign-On (SSO)-Integration konfigurieren zwischen einer Control Hub-Kundenorganisation und einer Bereitstellung, bei der die Microsoft Entra ID als Identitätsanbieter verwendet wird.
Wann wird der Benutzer-Avatar in Webex aktualisiert?
Die Benutzer-Avatare werden mit Webex synchronisiert, wenn der Benutzer in Webex Identity erstellt wird. Diese Aktualisierung hängt davon ab, dass der Avatar des Benutzers in der Entra-ID aktualisiert wird. Die Wizard-App ruft dann den neuen Avatar aus der Entra-ID ab.