In diesem Artikel
dropdown icon
Einmalige Anmeldung und Control Hub
    Profile
    NameID Format
Control Hub mit Microsoft Entra ID integrieren
Herunterladen der Webex-Metadaten auf Ihr lokales System
Konfigurieren Sie die SSO-Anwendungseinstellungen in Entra ID.
Importieren der IdP-Metadaten und Aktivieren einmaliges Anmelden nach einem Test
Fehlerbehebung bei der Entra ID-Integration
Einzelanmeldung in Control Hub mit Microsoft Entra ID konfigurieren
list-menuIn diesem Artikel
list-menuFeedback?

Sie können eine Single Sign-On (SSO)-Integration zwischen einer Control Hub-Kundenorganisation und einer Bereitstellung konfigurieren, die Microsoft Entra ID als Identitätsanbieter (IdP) verwendet.

Einmalige Anmeldung und Control Hub

Die einmalige Anmeldung ist ein Sitzungs- oder Benutzerauthentifizierungsvorgang, bei dem ein Benutzer für den Zugriff auf eine oder mehrere Anwendungen Anmeldeinformationen angeben kann. Bei dem Vorgang werden Benutzer für alle Anwendungen authentifiziert, für die sie über Berechtigungen verfügen. Dadurch werden weitere Eingabeaufforderungen vermieden, wenn Benutzer während einer bestimmten Sitzung zwischen Anwendungen wechseln.

Das Security Assertion Markup Language (SAML 2.0) Federation-Protokoll wird für die SSO-Authentifizierung zwischen der Webex-Cloud und Ihrem Identitätsanbieter (IdP) eingesetzt.

Profile

Die Webex-App unterstützt nur den Webbrowser SSO Profil. Im Webbrowser- und SSO unterstützt Webex App die folgenden Bindungen:

  • SP initiierte POST -> POST-Bindung

  • SP initiierte REDIRECT -> POST-Bindung

NameID Format

Das SAML 2.0-Protokoll unterstützt mehrere NameID-Formate für die Kommunikation über einen bestimmten Benutzer. Die Webex-App unterstützt die folgenden NameID-Formate.

  • urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

  • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

In den von Ihrem IdP geladenen Metadaten ist der erste Eintrag für die Verwendung in Webex konfiguriert.

Control Hub mit Microsoft Entra ID integrieren

Webex unterstützt nur einen Identitätsanbieter (IdP) pro Authentifizierungsanfrage. Der Authentifizierungsablauf ist wie folgt: Benutzer > Webex-Authentifizierung > IdP 1 > Webex-Authentifizierung > Benutzer. Dies bedeutet, dass sich zwar verschiedene Benutzer mit unterschiedlichen Identitätsanbietern authentifizieren können, ein Benutzer aber während eines einzigen Authentifizierungsprozesses nicht zwischen mehreren Identitätsanbietern wechseln kann. Zusätzliche Schritte wie beispielsweise die Multi-Faktor-Authentifizierung (MFA) müssen in den einzelnen Identitätsanbieter (IdP) integriert werden, der für die jeweilige Anfrage verwendet wird.

Die Konfigurationsanweisungen zeigen ein konkretes Beispiel einer SSO-Integration, aber keine umfassende Konfiguration für alle Möglichkeiten. Beispielsweise sind die Integrationsschritte für nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient dokumentiert. Andere Formate wie urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress funktionieren zwar für die SSO-Integration, fallen aber nicht in den Geltungsbereich unserer Dokumentation.

Richten Sie diese Integration für Benutzer in Ihrer Webex-Organisation ein (einschließlich webex App, Webex Meetingsund andere Dienste, die im Control Hub verwaltet werden). Wenn Ihre Webex-Site in Control Hubintegriert ist, erbt die Webex-Site die Benutzerverwaltung. Wenn Sie auf diese Weise nicht auf Webex Meetings zugreifen können und dies nicht in Control Hubverwaltet wird, müssen Sie eine separate Integration tun, um SSO-Benutzer Webex Meetings .

Vorbereitungen

Für SSO und Control Hub müssen die IdPs der SAML 2.0-Spezifikation entsprechen. Außerdem müssen die IdPs folgendermaßen konfiguriert werden:

  • In Entra ID wird die Bereitstellung nur im manuellen Modus unterstützt. In diesem Dokument wird nur die SSO-Integration behandelt.
  • Bestehende Webex-Kunden mit früheren Verbundkonfigurationen könnten aufgrund von Änderungen an den SAML-Attributen auf Probleme mit der Standard-Entra-ID-Webex-Vorlage stoßen. Wir empfehlen, zur Lösung dieses Problems eine benutzerdefinierte Entra-ID-Föderation unter Verwendung Ihrer bisherigen SAML-Einstellungen einzurichten. Stellen Sie sicher, dass Sie den Control Hub SSO-Test durchführen, um die Kompatibilität zu gewährleisten und etwaige Diskrepanzen zu beheben.

Herunterladen der Webex-Metadaten auf Ihr lokales System

1

Melden Sie sich bei Control Hub an.

2

Gehe zu Management > Sicherheit > Authentifizierung.

3

Gehen Sie zum Tab Identitätsanbieter und klicken Sie auf SSO aktivieren.

4

Wählen Sie einen Identitätsanbieter (IdP) aus.

5

Wählen Sie den Zertifikattyp für Ihre Organisation aus:

  • Selbstsigniert von Cisco—Wir empfehlen diese Option. Unterzeichnen Sie das Zertifikat, damit Sie es nur alle fünf Jahre erneuern müssen.
  • Signiert von einer öffentlichen Zertifizierungsstelle— Sicherer, aber Sie müssen die Metadaten regelmäßig aktualisieren (es sei denn, Ihr IdP-Anbieter unterstützt Trust Anchors).

Vertrauensanker sind öffentliche Schlüssel, die als Berechtigung fungieren, das Zertifikat einer digitalen Signatur zu überprüfen. Weitere Informationen finden Sie in Ihrer IdP-Dokumentation.

6

Laden Sie die Metadatendatei herunter.

Der Name der Webex-Metadatendatei lautet idb-meta-<org-ID>-SP.xml.

Konfigurieren Sie die SSO-Anwendungseinstellungen in Entra ID.

Vorbereitungen

1

Melden Sie sich im Microsoft Entra Admin Center an.

2

Falls Sie das Symbol Microsoft Entra ID nicht sehen können, klicken Sie auf Weitere Dienste.

3

Gehen Sie zu Microsoft Entra ID für Ihre Organisation.

4

Wechseln Sie zu Unternehmensanwendungen und klicken Sie auf Hinzufügen.

5

Klicken Sie auf Anwendung aus dem Katalog hinzufügen.

6

Geben Sie in das Suchfeld Cisco Webex.

7

Wählen Sie im Ergebnisbereich die Option Cisco Webex, und klicken Sie dann auf Erstellen, um die Anwendung hinzuzufügen.

8

Um sicherzustellen, dass die Webex-Anwendung, die Sie für einmaliges Anmelden hinzugefügt haben, nicht im Benutzerportal angezeigt wird, öffnen Sie die neue Anwendung. Klicken Sie unter Verwalten auf Eigenschaften und legen Sie Für Nutzer sichtbar? auf Nein fest.

Wir unterstützen es nicht, die Webex-App für Benutzer sichtbar zu machen.

9

Konfigurieren der einmaligen Anmeldung:

  1. Klicken Sie unter Verwalten auf Single Sign-On, und wählen Sie dann unter Single-Sign-On-Methode auswählen die Option SAML.

  2. Klicken Sie auf Metadatendatei hochladen und wählen Sie dann die Metadatendatei aus, die Sie vom Control Hub heruntergeladen haben.

    Metadatendatei in Azure importieren

    Einige Felder werden automatisch für Sie ausgefüllt.

  3. Klicken Sie unter Verwalten auf Single Sign-On mit SAML einrichten und dann auf Bearbeiten, um die grundlegende SAML-Konfiguration zu öffnen.

  4. Kopieren Sie den Wert Antwort-URL , fügen Sie ihn in Anmelde-URL ein und speichern Sie dann Ihre Änderungen.

10

Gehe zu Verwalten > Benutzer und Gruppen, und wählen Sie dann die entsprechenden Benutzer und Gruppen aus, denen Sie Zugriff auf die Webex App gewähren möchten.

11

Klicken Sie auf der Seite Einmalige Anmeldung mit SAML einrichten im Abschnitt SAML Signierzertifikat auf Download, um die Federation Metadata XML herunterzuladen und sie auf Ihrem Computer zu speichern.

Importieren der IdP-Metadaten und Aktivieren einmaliges Anmelden nach einem Test

Nachdem Sie die Webex-Metadaten exportiert haben, konfigurieren Sie Ihren IdP und laden Sie die IdP-Metadaten auf Ihr lokales System herunter, nun können Sie sie aus Control Hub in Ihre Webex-Organisation importieren.

Vorbereitungen

Testen Sie die SSO-Integration nicht über die Benutzeroberfläche des Identitätsanbieters (IdP). Wir unterstützen nur Dienstleister initiierten (mit SP initiierten) strömen, daher müssen Sie den Control Hub SSO Test für diese Integration verwenden.

1

Wählen Sie eine Option:

  • Kehren Sie in Ihrem Browser zur Seite „Zertifikatsauswahl“ des Control Hub zurück und klicken Sie dann auf Weiter.
  • Öffnen Sie Control Hub erneut, falls es nicht mehr in Ihrem Browser-Tab geöffnet ist. Gehen Sie in Control Hub in der Kundenansicht zu Verwaltung > Sicherheit > Authentifizierung, wählen Sie den IdP aus und wählen Sie dann Aktionen > Metadaten importieren.
2

Auf der Seite „IdP-Metadaten importieren“ können Sie die IdP-Metadatendatei entweder per Drag & Drop auf die Seite ziehen oder die Metadatendatei über die Dateiauswahl suchen und hochladen. Klicken Sie auf Weiter.

Sie sollten die Option "Sicherer" verwenden , wenn dies möglich ist. Dies ist nur möglich, wenn Ihr IdP zum Signieren seiner Metadaten eine öffentliche Zertifizierungsstelle verwendet hat.

In allen anderen Fällen müssen Sie die Option Weniger sicher verwenden. Dies beinhaltet, wenn die Metadaten nicht signiert, selbstsignierte oder von einer privaten Zertifizierungsstelle signiert sind.

Okta signieren die Metadaten nicht. Sie müssen daher für eine Okta-Integration Weniger sicher SSO auswählen.

3

Wählen Sie Test SSO setupaus und melden Sie sich beim Öffnen eines neuen Browser-Tabs beim IdP an, um sich zu authentifizieren.

Wenn Sie einen Authentifizierungsfehler erhalten, kann es ein Problem mit den Anmeldeinformationen geben. Überprüfen Sie Nutzernamen und Passwort und versuchen Sie es erneut.

Ein Fehler in der Webex-App bedeutet in der Regel ein Problem mit der SSO Einrichtung. Gehen Sie in diesem Fall erneut die Schritte durch, insbesondere die Schritte, in denen Sie die Cisco Control Hub-Metadaten kopieren und in die IdP-Einrichtung einfügen.

Um die SSO-Anmeldung direkt anzuzeigen, können Sie auch auf URL in die Zwischenablage kopieren von diesem Bildschirm aus klicken und in ein privates Browserfenster einfügen. Von dort aus können Sie sich mit SSO anmelden. Bei diesem Schritt werden die falschen Positives aufgrund eines Zugriffstokens, das sich möglicherweise in einer bestehenden Sitzung von Ihrer angemeldeten Sitzung bewegt, beendet.

4

Kehren Sie zur Registerkarte Control Hub im Browser zurück.

  • Wenn der Test erfolgreich war, wählen Sie Erfolgreicher Test aus. Aktivieren Sie SSO , und klicken Sie auf Weiter.
  • Wenn der Test nicht erfolgreich war, wählen Sie Nicht erfolgreich aus. Deaktivieren Sie SSO , und klicken Sie auf Weiter.

Die SSO-Konfiguration wird in Ihrer Organisation erst wirksam, wenn Sie die erste Option Optionsschaltfläche wählen und diese SSO.

Nächste Schritte

Verwenden Sie die in Synchronisieren von Okta-Benutzern mit Control Hub beschriebenen Verfahren, wenn Sie die Benutzerbereitstellung von Okta in die Webex-Cloud durchführen möchten.

Verwenden Sie die in Synchronisieren von Microsoft Entra ID-Benutzern mit Control Hub beschriebenen Verfahren, wenn Sie die Benutzerbereitstellung von Entra ID in die Webex-Cloud durchführen möchten.

Sie können die in Unterdrücken automatisierter E-Mails beschriebene Vorgehensweise befolgen, um E-Mails zu deaktivieren, die an neue Webex App-Benutzer in Ihrer Organisation gesendet werden. Das Dokument enthält außerdem bewährte Methoden zum Senden von Mitteilungen an Benutzer in Ihrer Organisation.

Fehlerbehebung bei der Entra ID-Integration

Stellen Sie beim SAML-Test sicher, dass Sie Mozilla Firefox verwenden und den SAML-Tracer installieren https://addons.mozilla.org/en-US/firefox/addon/saml-tracer/

Prüfen Sie die von Entra ID stammende Assertion, um sicherzustellen, dass sie das korrekte NameID-Format aufweist und ein Attribut UID besitzt, das mit einem Benutzer in der Webex-App übereinstimmt.

War dieser Artikel hilfreich für Sie?
War dieser Artikel hilfreich für Sie?