Freigeben über

Integration des einmaligen Anmeldens (SSO) von Microsoft Entra in Onyxia

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie Onyxia mit Microsoft Entra ID integrieren. Die Integration von Onyxia mit Microsoft Entra ID ermöglicht Folgendes:

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

Voraussetzungen

Um Microsoft Entra ID mit Onyxia 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 Onyxia-Abonnement, für das das einmalige Anmelden (Single Sign-On, SSO) aktiviert ist

Beschreibung des Szenarios

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

  • Onyxia unterstützt SP- und IDP-initiiertes einmaliges Anmelden.
  • Onyxia unterstützt die Just-In-Time-Benutzerbereitstellung.

Hinweis

Der Bezeichner dieser Anwendung ist ein fester Zeichenfolgenwert, daher kann in einem Mandanten nur eine Instanz konfiguriert werden.

Zum Konfigurieren der Integration von Onyxia in Microsoft Entra ID müssen Sie Onyxia Ihrer Liste der verwalteten SaaS-Apps aus dem Katalog 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 Onyxia in das Suchfeld ein.
  4. Wählen Sie im Ergebnisbereich Onyxia 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 Onyxia

Konfigurieren und testen Sie Microsoft Entra-SSO mit Onyxia mithilfe einer Testbenutzerin namens B.Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen Microsoft Entra-Benutzern und den entsprechenden Benutzern in Onyxia eingerichtet werden.

Führen Sie zum Konfigurieren und Testen von Microsoft Entra-SSO mit Onyxia 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 Sie Onyxia-SSO, um die Einstellungen für das einmalige Anmelden auf Anwendungsseite zu konfigurieren.
    1. Erstellen einer Onyxia-Testbenutzerin, um eine Entsprechung von B. Simon in Onyxia zu erhalten, die mit ihrer Darstellung 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

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>Onyxia>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. Im Abschnitt Grundlegende SAML-Konfiguration ist die Anwendung vorkonfiguriert, und die erforderlichen URLs sind bereits mit Microsoft Entra ausgefüllt. Der Benutzer muss die Konfiguration speichern, indem er auf die Schaltfläche Speichern klickt.

  6. Wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten, führen Sie die folgenden Schritte aus:

    Geben Sie im Textfeld Anmelde-URL die URL ein: https://auth.onyxia.io/auth/saml/callback.

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

  8. Kopieren Sie im Abschnitt Onyxia einrichten die entsprechenden URLs 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 Onyxia gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Onyxia.
  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 Onyxia-SSO

  1. Melden Sie sich als Administrator bei der Onyxia-Unternehmenswebsite an.

  2. Navigieren Sie zu Settings (Einstellungen), und klicken Sie auf Account Settings (Kontoeinstellungen).

    Screenshot der Navigation zu den Einstellungen.

  3. Navigieren Sie zum Abschnitt SSO, und klicken Sie auf + Add New Connection (Neue Verbindung hinzufügen).

    Screenshot des Hinzufügens einer neuen Verbindung.

  4. Führen Sie im Abschnitt SSO Configuration die folgenden Schritte aus:

    Screenshot der Konfiguration.

    1. Geben Sie im Textfeld Domain Name (Domänenname) einen gültigen Domänennamen ein.

    2. Fügen Sie im Textfeld SSO URL die Anmelde-URL ein, die Sie aus dem Microsoft Entra Admin Center kopiert haben.

    3. Öffnen Sie das heruntergeladene Zertifikat (Base64) in Notepad und fügen Sie den Inhalt in das Textfeld Öffentliches Zertifikat ein.

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

    5. Kopieren Sie die Entitäts-ID des Dienstanbieters, und fügen Sie sie in das Textfeld ID (Entitäts-ID) im Abschnitt Grundlegende SAML-Konfiguration in Microsoft Entra Admin Center ein.

    6. Klicken Sie auf + Erstellen.

Onyxia-Testbenutzer erstellen

In diesem Abschnitt wird in Onyxia eine Benutzerin namens Britta Simon erstellt. Onyxia 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 Benutzer noch nicht in Onyxia vorhanden, wird nach der Authentifizierung ein neuer Benutzer erstellt.

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 im Microsoft Entra Admin Center auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL für Onyxia weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Navigieren Sie direkt zur Anmelde-URL für Onyxia, und initiieren Sie dort den Anmeldeflow.

IDP-initiiert:

  • Wählen Sie im Microsoft Entra Admin Center Diese Anwendung testen aus. Dadurch sollten Sie automatisch bei der Onyxia-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 „Onyxia“ unter „Meine Apps“ geschieht Folgendes: Wenn Sie die Anwendung im SP-Modus konfiguriert haben, werden Sie zum Einleiten des Anmeldeflows zur Anmeldeseite der Anwendung weitergeleitet. Wenn Sie die Anwendung im IDP-Modus konfiguriert haben, sollten Sie automatisch bei der Onyxia-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 Onyxia können Sie die Sitzungssteuerung erzwingen, die Ihre Organisation in Echtzeit vor der Exfiltration und Infiltration vertraulicher Daten schützt. Die Sitzungssteuerung basiert auf bedingtem Zugriff. Erfahren Sie, wie Sie die Sitzungssteuerung mit Microsoft Defender for Cloud Apps erzwingen.