Freigeben über

Tutorial: Integration des einmaligen Anmeldens (SSO) von Microsoft Entra in EasySSO for BitBucket

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie EasySSO for Bitbucket in Microsoft Entra ID integrieren. Die Integration von EasySSO for BitBucket in Microsoft Entra ID ermöglicht Folgendes:

  • Steuern Sie in Microsoft Entra ID, wer Zugriff auf EasySSO for BitBucket hat.
  • Ermöglichen Sie es Ihren Benutzern, sich mit ihren Microsoft Entra-Konten automatisch bei EasySSO for BitBucket anzumelden.
  • Verwalten Sie Ihre Konten zentral im Azure-Portal.

Voraussetzungen

Sie benötigen Folgendes:

  • Ein Microsoft Entra-Abonnement. Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
  • Ein SSO-fähiges EasySSO for BitBucket-Abonnement.

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.

  • EasySSO for BitBucket unterstützt SP- und IdP-initiiertes einmaliges Anmelden.
  • EasySSO for BitBucket unterstützt die Just-In-Time-Benutzerbereitstellung.

Zum Konfigurieren der Integration von EasySSO for BitBucket in Microsoft Entra ID müssen Sie EasySSO for BitBucket aus dem Katalog der Liste mit den verwalteten SaaS-Apps hinzufügen.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
  3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff EasySSO for BitBucket in das Suchfeld ein.
  4. Wählen Sie in den Ergebnissen die Option EasySSO for BitBucket aus, und fügen Sie die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird.

Alternativ können Sie auch den Enterprise App Configuration Wizard verwenden. Mit diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer/Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra für EasySSO for BitBucket

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit EasySSO for BitBucket mithilfe eines Testbenutzers namens B.Simon. Damit einmaliges Anmelden funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in EasySSO for BitBucket eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra mit EasySSO for BitBucket die folgenden Schritte aus:

  1. Konfigurieren des einmaligen Anmeldens von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
    1. Erstellen Sie einen Testbenutzer in Microsoft Entra, um das einmalige Anmelden von Microsoft Entra mit B. Simon zu testen.
    2. Zuweisen der Microsoft Entra-Testbenutzerin, um B. Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
  2. Konfigurieren des einmaligen Anmeldens für EasySSO for BitBucket, um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen eines EasySSO for BitBucket-Testbenutzers, um in EasySSO for BitBucket eine Entsprechung von B.Simon zu erhalten, die mit der Benutzerdarstellung in Microsoft Entra verknüpft ist.
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Gehen Sie wie folgt vor, um das einmalige Anmelden von Microsoft Entra zu aktivieren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Navigieren Sie über Identität>Anwendungen>Unternehmensanwendungen>EasySSO for BitBucket zur Anwendungsintegrationsseite, und suchen Sie den Abschnitt Verwalten. Wählen Sie Einmaliges Anmelden aus.

  3. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

  4. Wählen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten das Stiftsymbol für Grundlegende SAML-Konfiguration aus, um die Einstellungen zu bearbeiten.

    Screenshot of Set up Single Sign-On with SAML page, with pencil icon highlighted

  5. Geben Sie im Abschnitt Grundlegende SAML-Konfiguration die Werte für die folgenden Felder ein, wenn Sie die Anwendung im IdP-initiierten Modus konfigurieren möchten:

    a. Geben Sie im Textfeld Bezeichner eine URL im folgenden Format ein: https://<server-base-url>/plugins/servlet/easysso/saml.

    b. Geben Sie im Textfeld Antwort-URL eine URL im folgenden Format ein: https://<server-base-url>/plugins/servlet/easysso/saml.

  6. Wählen Sie Zusätzliche URLs festlegen aus, und führen Sie den folgenden Schritt aus, wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten:

    • Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://<server-base-url>/login.jsp.

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Sie müssen diese Werte mit dem tatsächlichen Bezeichner, der Antwort-URL und der Anmelde-URL aktualisieren. Diese Werte erhalten Sie im Zweifelsfall vom Supportteam für EasySSO. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration ansehen.

  7. Die SAML-Assertionen werden von der EasySSO for BitBucket-Anwendung in einem bestimmten Format erwartet. Daher müssen der SAML-Tokenattributkonfiguration benutzerdefinierte Attributzuordnungen hinzugefügt werden. Der folgende Screenshot zeigt die Liste der Standardattribute.

    Screenshot of default attributes

  8. Von der EasySSO for BitBucket-Anwendung wird außerdem die Rückgabe einiger weiterer Attribute in der SAML-Antwort erwartet. Diese finden Sie in der folgenden Tabelle. Diese Attribute werden ebenfalls vorab aufgefüllt, Sie können sie jedoch nach Bedarf überarbeiten.

    Name Quellattribut
    urn:oid:0.9.2342.19200300.100.1.1 user.userprincipalname
    urn:oid:0.9.2342.19200300.100.1.3 user.mail
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 user.surname
    urn:oid:2.5.4.42 user.givenname

    Falls für Ihre Microsoft Entra-Benutzer sAMAccountName konfiguriert ist, muss urn:oid:0.9.2342.19200300.100.1.1 dem Attribut sAMAccountName zugeordnet werden.

  9. Wählen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat den Downloadlink für die Option Zertifikat (Base64) oder Verbundmetadaten-XML aus. Speichern Sie die heruntergeladenen Elemente auf Ihrem Computer. Sie benötigen sie später für die Konfiguration von BitBucket EasySSO.

    Screenshot of the SAML Signing Certificate section, with download links highlighted

    Wenn Sie EasySSO for BitBucket manuell mit einem Zertifikat konfigurieren möchten, müssen Sie außerdem die Werte für Anmelde-URL und Microsoft Entra-Bezeichner kopieren und auf Ihrem Computer speichern.

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B.Simon.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
  2. Browsen Sie zu Identität>Benutzer>Alle Benutzer.
  3. Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
  4. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
    1. Geben Sie im Feld Anzeigename den Namen B.Simon ein.
    2. Geben Sie im Feld Benutzerprinzipalname ein username@companydomain.extension. Beispiel: B.Simon@contoso.com.
    3. Aktivieren Sie das Kontrollkästchen Kennwort anzeigen, und notieren Sie sich den Wert aus dem Feld Kennwort.
    4. Klicken Sie auf Überprüfen + erstellen.
  5. Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie B. Simon die Verwendung des einmaligen Anmeldens, indem Sie ihr Zugriff auf EasySSO for BitBucket gewähren.

  1. Browsen Sie zu Identität>Anwendungen>Unternehmensanwendungen.
  2. Wählen Sie in der Anwendungsliste EasySSO for BitBucket aus.
  3. Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.
  4. Klicken Sie auf Benutzer hinzufügen. Wählen Sie im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
  5. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste Benutzer den Eintrag B. Simon aus, und wählen Sie dann im unteren Bereich des Bildschirms die Option Auswählen aus.
  6. Wenn den Benutzern eine Rolle zugewiesen werden soll, können Sie sie im Dropdownmenü Rolle auswählen auswählen. Wurde für diese App keine Rolle eingerichtet, ist die Rolle „Standardzugriff“ ausgewählt.
  7. Wählen Sie im Dialogfeld Zuweisung hinzufügen die Option Zuweisen aus.

Konfigurieren des einmaligen Anmeldens für EasySSO for BitBucket

  1. Melden Sie sich in einem anderen Webbrowserfenster bei der Zoom-Unternehmenswebsite als Administrator an.

  2. Navigieren Sie zum Abschnitt Administration (Verwaltung).

    Screenshot of BitBucket instance, with gear icon highlighted

  3. Suchen Sie nach EasySSO, und wählen Sie diese Option aus.

    Screenshot of Easy SSO option

  4. Wählen Sie SAML aus. Dadurch gelangen Sie zum Abschnitt für die SAML-Konfiguration.

    Screenshot of EasySSO Admin page, with SAML highlighted

  5. Wählen Sie die Registerkarte Certificates (Zertifikate) aus. Daraufhin wird der folgende Bildschirm angezeigt:

    Screenshot of the Certificates tab, with various options highlighted

  6. Suchen Sie nach dem Zertifikat (Base64) oder nach der Metadatendatei, das bzw. die Sie im vorherigen Abschnitt dieses Tutorials gespeichert haben. Fahren Sie mit einem der folgenden Schritte fort:

    • Verwenden Sie die Metadatendatei des App-Verbunds, die Sie als lokale Datei auf Ihren Computer heruntergeladen haben. Wählen Sie das Optionsfeld Hochladen aus, und folgen Sie dem spezifischen Pfad für Ihr Betriebssystem.

    • Öffnen Sie die Metadatendatei des App-Verbunds in einem beliebigen Text-Editor, um den Inhalt der Datei anzuzeigen. Kopieren Sie ihn in die Zwischenablage. Wählen Sie Input (Eingabe) aus, und fügen Sie den Inhalt aus der Zwischenablage in das Textfeld ein.

    • Führen Sie eine vollständig manuelle Konfiguration durch. Öffnen Sie das Zertifikat (Base64) des App-Verbunds in einem beliebigen Text-Editor, um den Inhalt der Datei anzuzeigen. Kopieren Sie ihn Datei in die Zwischenablage, und fügen Sie ihn anschließend in das Textfeld IdP Token Signing Certificates (IdP-Tokensignaturzertifikate) ein. Navigieren Sie dann zur Registerkarte General (Allgemein), und füllen Sie die Felder POST Binding URL (POST-Bindungs-URL) und Entity ID (Entitäts-ID) mit den entsprechenden Werten für Anmelde-URL und Microsoft Entra-Bezeichner aus, die Sie zuvor gespeichert haben.

  7. Wählen Sie unten auf der Seite Save (Speichern) aus. Daraufhin wird der Inhalt der Metadaten- oder Zertifikatsdatei analysiert und in die Konfigurationsfelder eingefügt. Die EasySSO for BitBucket-Konfiguration ist abgeschlossen.

  8. Navigieren Sie zum Testen der Konfiguration zur Registerkarte Look & Feel (Erscheinungsbild), und aktivieren Sie das Kontrollkästchen SAML Login Button (SAML-Anmeldeschaltfläche). Dadurch wird im BitBucket-Anmeldebildschirm eine separate Schaltfläche aktiviert, mit der Sie Ihre gesamte Microsoft Entra-SAML-Integration testen können. Sie können diese Schaltfläche aktiviert lassen und außerdem ihre Position, Farbe und Übersetzung für den Produktionsmodus konfigurieren.

    Screenshot of SAML page Look & Feel tab, with SAML Login Button highlighted

    Hinweis

    Sollten Probleme auftreten, wenden Sie sich an das EasySSO-Supportteam.

Erstellen eines EasySSO for BitBucket-Testbenutzers

In diesem Abschnitt wird in BitBucket ein Benutzer namens Britta Simon erstellt. Von EasySSO for BitBucket wird die Just-In-Time-Benutzerbereitstellung unterstützt. Diese ist jedoch standardmäßig deaktiviert. Um sie zu aktivieren, muss Create user on successful login (Benutzer bei erfolgreicher Anmeldung erstellen) im Abschnitt General (Allgemein) der EasySSO-Plug-In-Konfiguration explizit aktiviert werden. Ist noch kein Benutzer in BitBucket vorhanden, wird nach der Authentifizierung ein neuer Benutzer erstellt.

Falls Sie die automatische Benutzerbereitstellung bei erstmaliger Anmeldung eines Benutzers nicht aktivieren möchten, müssen Benutzer in Benutzerverzeichnissen vorhanden sein, die von der BitBucket-Instanz genutzt werden. Bei einem solchen Verzeichnis kann es sich beispielsweise um LDAP oder um Atlassian Crowd handeln.

Screenshot of the General section of EasySSO plug-in configuration, with Create user on successful login highlighted

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen.

SP-initiiert:

  • Klicken Sie auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL von EasySSO for BitBucket weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Rufen Sie direkt die EasySSO for BitBucket-Anmelde-URL auf, und initiieren Sie den Anmeldeflow.

IDP-initiiert:

  • Klicken Sie auf Diese Anwendung testen. Dadurch sollten Sie automatisch bei der EasySSO for BitBucket-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben

Sie können auch den Microsoft-Bereich „Meine Apps“ verwenden, um die Anwendung in einem beliebigen Modus zu testen. Beim Klicken auf die Kachel „EasySSO for BitBucket“ in „Meine Apps“ geschieht Folgendes: Wenn Sie die Anwendung im SP-Modus konfiguriert haben, werden Sie zum Initiieren des Anmeldeflows zur Anmeldeseite der Anwendung weitergeleitet. Wenn Sie die Anwendung im IDP-Modus konfiguriert haben, sollten Sie automatisch bei der EasySSO for BitBucket-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von EasySSO for BitBucket können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor der Exfiltration und Infiltration vertraulicher Unternehmensdaten schützt. Die Sitzungssteuerung basiert auf bedingtem Zugriff. Erfahren Sie, wie Sie die Sitzungssteuerung mit Microsoft Defender for Cloud Apps erzwingen.