Teilen über

Microsoft Entra-SSO-Integration mit Docker

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie Docker in Microsoft Entra ID integrieren. Wenn Sie Docker in Microsoft Entra ID integrieren, können Sie Folgendes tun:

  • Steuern Sie in Microsoft Entra ID, wer Zugriff auf Docker hat.
  • Ermöglichen Sie es Ihren Benutzerinnen und Benutzern, sich mit ihren Microsoft Entra-Konten automatisch bei Docker anzumelden.
  • Verwalten Sie Ihre Konten an einem zentralen Ort.

Voraussetzungen

Um Microsoft Entra ID in Docker zu integrieren, benötigen Sie Folgendes:

  • Ein Microsoft Entra-Abonnement. Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
  • Ein Docker Business-Abonnement.

Beschreibung des Szenarios

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

  • Docker unterstützt nur das durch SP initiierte SSO.
  • Docker unterstützt die Just-in-Time-Benutzerbereitstellung.

Um die Integration von Docker in Microsoft Entra ID zu konfigurieren, müssen Sie Docker über den 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 Docker in das Suchfeld ein.
  4. Wählen Sie im Ergebnisbereich Docker aus, und fügen Sie dann 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. In diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer und Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen von Microsoft Entra-SSO für Docker

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit Docker mithilfe eines Testbenutzerkontos für B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzerkonto und dem entsprechenden Benutzerkonto in Docker eingerichtet werden.

Führen Sie zum Konfigurieren und Testen von Microsoft Entra-SSO mit Docker die folgenden Schritte aus:

  1. Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
    1. Erstellen Sie einen Microsoft Entra-Testbenutzer, um Microsoft Entra-SSO mit dem Testbenutzer 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 Docker, um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren.
    1. Erstellen Sie ein Docker-Testbenutzerkonto als Pendant zu B. Simon in Docker, das mit ihrer Darstellung in Microsoft Entra ID verknüpft ist.
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Führen Sie die folgenden Schritte aus, um das einmalige Anmelden von Microsoft Entra im Microsoft Entra Admin Center zu aktivieren.

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

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Docker>Einmaliges Anmelden.

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

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

    Screenshot: Bearbeiten der grundlegenden SAML-Konfiguration

  5. Führen Sie im Abschnitt Grundlegende SAML-Konfiguration die folgenden Schritte aus:

    a. Geben Sie im Textfeld Bezeichner (Entitäts-ID) einen Wert im folgenden Format ein: urn:auth0:docker-prod:<Docker_SsoID>

    b. Geben Sie im Textfeld Antwort-URL eine URL im folgenden Format ein: https://login.docker.com/login/callback?connection=<Docker_SsoID>

    c. Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://hub.docker.com/auth/start?connection=<Docker_SsoID>.

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Ersetzen Sie diese Werte durch die tatsächlichen Werte für Bezeichner, Antwort-URL und Anmelde-URL. Sie erhalten diese Werte beim Konfigurieren von Docker SSO. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration im Microsoft Entra Admin Center ansehen.

  6. Die Docker-Anwendung erwartet eine eindeutige Benutzer-ID, die anstatt user.userprincipalname einer E-Mail-Adresse (user.mail) zugeordnet ist, und sie unterstützt auch Vorname und Nachname, um den vollständigen Namen der Benutzerin oder des Benutzers mit der Docker-Anwendung zu synchronisieren. Der folgende Screenshot zeigt die Liste der Standardattribute.

    Screenshot: Abbildung der Attribute.

    Hinweis

    Löschen Sie Namen und E-Mail-Adresse manuell aus den oben genannten Standardattributen im Entra-Portal gemäß den Anwendungsanforderungen.

  7. Darüber hinaus unterstützt die Docker-Anwendung optionale Attribute, die in der SAML-Antwort zurückgegeben werden können (siehe unten). Diese Attribute können hinzugefügt werden, um die Bereitstellung von Benutzerkonten in bestimmten Teams und deren Rollen innerhalb der Docker Organisation zu verwalten. Um mehr über alle Attribute zu erfahren, die Docker SSO unterstützt, lesen Sie die Docker SSO-Dokumentation.

    Anspruchsname Namespace Quellattribut
    dockerOrg <empty> Name der Docker-Organisation
    dockerTeam <empty> Name des Docker-Teams
    dockerRole <empty> Benutzerrolle in der Organisation. Zulässige Werte: „Besitzerin oder Besitzer“, „Bearbeiterin oder Bearbeiter“, „Mitglied“.

    Hinweis

    Wenn die Organisation Benutzerinnen und Benutzer in mehreren Teams verwalten muss, können Gruppenansprüche ebenfalls aktiviert werden. Wenn Sie mehr über die Docker SSO-Gruppenverwaltung erfahren möchten, klicken Sie hier.

  8. Navigieren Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat zum Eintrag Zertifikat (Base64) . Wählen Sie Herunterladen aus, um das Zertifikat herunterzuladen, und speichern Sie es auf Ihrem Computer.

    Der Screenshot zeigt den Downloadlink für das Zertifikat.

  9. Kopieren Sie im Abschnitt Docker einrichten die entsprechenden URL(s) gemäß Ihren Anforderungen.

    Screenshot: Kopieren einer der Konfiguration entsprechenden URL.

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie im Microsoft Entra Admin Center einen Testbenutzer namens 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 es B. Simon, das einmalige Anmelden von Microsoft Entra zu verwenden, indem Sie ihr Zugriff auf Docker gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Docker.
  3. Wählen Sie auf der Übersichtsseite der App Benutzer und Gruppen aus.
  4. Wählen Sie Benutzer/Gruppe hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
    1. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann unten auf dem Bildschirm auf die Schaltfläche Auswählen.
    2. 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.
    3. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren von Docker-SSO

  1. Melden Sie sich als Admin bei der Docker-Unternehmenswebsite an.

  2. Wählen Sie Ihre Organisation oder Ihr Unternehmen im linken Dropdownmenü aus, und wählen Sie SSO & SCIM aus.

  3. Wählen Sie in der Tabelle „SSO-Verbindungen“ Verbindung erstellen aus, und erstellen Sie einen Namen für die Verbindung.

    Hinweis

    Sie müssen mindestens eine Domäne überprüfen, bevor Sie die Verbindungen erstellen.

  4. Wählen Sie als Authentifizierungsmethode SAML aus und führen Sie die folgenden Schritte durch:

    Screenshot, der die Konfiguration zeigt.

    1. Kopieren Sie den Wert von Entitäts-ID, und fügen Sie diesen Wert im Microsoft Entra Admin Center in das Textfeld Bezeichner (Entitäts-ID) im Abschnitt Grundlegende SAML-Konfiguration ein.

    2. Kopieren Sie den Wert für ACS-URL, und fügen Sie diesen Wert im Microsoft Entra Admin Center in das Textfeld Antwort-URL im Abschnitt Grundlegende SAML-Konfiguration ein.

    3. Fügen Sie im Textfeld SAML Sign-On-URL die Anmelde-URL ein, die Sie aus dem Microsoft Entra Admin Center kopiert haben.

    4. Öffnen Sie das heruntergeladene Zertifikat (Base64) im Editor, und fügen Sie dessen Inhalt in das Textfeld Key x509 Certificate ein.

    5. Wählen Sie Weiter aus und dann Verbindung speichern.

Erstellen einer Docker-Testbenutzerin

In diesem Abschnitt wird in Docker eine Benutzerin namens Britta Simon erstellt. Docker unterstützt die Just-in-Time-Benutzerbereitstellung, die standardmäßig aktiviert ist. Für Sie steht in diesem Abschnitt kein Aktionselement zur Verfügung. Ist ein Benutzerkonto noch nicht in Docker vorhanden, wird nach der Authentifizierung ein neues Benutzerkonto erstellt.

Testen des einmaligen Anmeldens

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

  • Klicken Sie im Microsoft Entra Admin Center auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL für Docker weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Rufen Sie direkt die Docker-Anmelde-URL auf, und initiieren Sie den Anmeldeflow.

  • Sie können „Meine Apps“ von Microsoft verwenden. Wenn Sie unter „Meine Apps“ die Kachel „Docker“ auswählen, werden Sie zur Anmelde-URL für Docker weitergeleitet. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von Docker 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.