Freigeben über


Tutorial: Integration des einmaligen Anmeldens (SSO) von Microsoft Entra in Aventri

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

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

Weitere Informationen zur Integration von SaaS-Apps in Microsoft Entra ID finden Sie unter Was bedeuten Anwendungszugriff und einmaliges Anmelden mit Microsoft Entra ID?.

Voraussetzungen

Für die ersten Schritte benötigen Sie Folgendes:

  • Ein Microsoft Entra-Abonnement. Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
  • Aventri-Abonnement, für das einmaliges 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.

Zum Konfigurieren der Integration von Aventri mit Microsoft Entra ID müssen Sie Aventri aus dem Katalog Ihrer 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 Aventri in das Suchfeld ein.
  4. Wählen Sie im Ergebnisbereich die Option Aventri 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. 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 von Microsoft Entra für Aventri

Konfigurieren und testen Sie das einmalige Anmelden (SSO) von Microsoft Entra mit Aventri mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in Aventri eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit Aventri 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 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 Aventri , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen eines Aventri-Testbenutzers, um in Aventri eine Entsprechung von B. Simon 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

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 zu Identität>Anwendungen>Unternehmensanwendungen>Aventri>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 Bearbeitungs- bzw. Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

    Edit Basic SAML Configuration

  5. Geben Sie im Abschnitt Grundlegende SAML-Konfiguration die Werte für die folgenden Felder ein:

    a. Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://na-admin.eventscloud.com/saml/accounts/acs/<ACCOUNTID>.

    b. Geben Sie im Textfeld Bezeichner (Entitäts-ID) eine URL im folgenden Format ein: https://na-admin.eventscloud.com/saml/accounts/sso/<ACCOUNTID>.

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Sie ersetzen den Wert durch die tatsächliche Anmelde-URL und den tatsächlichen Bezeichner. Dies wird später in diesem Tutorial beschrieben.

  6. Die Aventri-Anwendung erwartet die SAML-Assertionen in einem bestimmten Format. Daher müssen Sie Ihrer Konfiguration der SAML-Tokenattribute benutzerdefinierte Attributzuordnungen hinzufügen. Der folgende Screenshot zeigt die Liste der Standardattribute.

    image

  7. Darüber hinaus wird von der Aventri-Anwendung erwartet, dass in der SAML-Antwort noch einige weitere Attribute zurückgegeben werden (siehe unten). Diese Attribute werden ebenfalls vorab aufgefüllt, Sie können sie jedoch nach Bedarf überprüfen.

    Name Quellattribut
    Email user.mail
  8. Navigieren Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat zu Verbundmetadaten-XML, und wählen Sie Herunterladen aus, um das Zertifikat herunterzuladen und auf Ihrem Computer zu speichern.

    The Certificate download link

  9. Kopieren Sie im Abschnitt Aventri einrichten die entsprechenden URLs basierend Ihren Anforderungen.

    Copy configuration URLs

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 es B.Simon, das einmalige Anmelden zu verwenden, indem Sie ihr Zugriff auf Aventri gewähren.

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

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Aventri.

  3. Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.

    The

  4. Wählen Sie Benutzer hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.

    The Add User link

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

  6. Wenn Sie einen beliebigen Rollenwert in der SAML-Assertion erwarten, wählen Sie im Dialogfeld Rolle auswählen die entsprechende Rolle für den Benutzer in der Liste aus, und klicken Sie dann im unteren Bildschirmbereich auf die Schaltfläche Auswählen.

  7. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren des einmaligen Anmeldens für Aventri

  1. Führen Sie zum Konfigurieren des einmaligen Anmeldens für Ihre Anwendung in der Aventri-Anwendung die folgenden Schritte aus:

    Aventri configuration

    a. Melden Sie sich mit Administratorrechten bei der Aventri-Anwendung an.

    b. Navigieren Sie zur SAML-Konfiguration.

    c. Öffnen Sie das aus dem Azure-Portal heruntergeladene Zertifikat in Editor, kopieren Sie den Inhalt, und fügen Sie ihn im Abschnitt General Settings (Allgemeine Einstellungen) in das Textfeld für die IDP-Metadaten ein.

    d. Klicken Sie auf die Schaltfläche Save & Stay (Speichern und bleiben).

    e. Klicken Sie im Abschnitt mit den SAML-Metadaten auf die Schaltfläche Update Metadata (Metadaten aktualisieren).

    f. Dadurch wird die Seite geöffnet und einmaliges Anmelden durchgeführt. Wenn das einmalige Anmelden funktioniert, können Sie den Benutzernamen einrichten.

    g. Wählen Sie im Feld „Username“ (Benutzername) wie unten dargestellt emailaddress (E-Mail-Adresse) aus.

    h. Kopieren Sie den Wert von SP-Entitäts-ID, und fügen Sie diesen in das Textfeld für Bezeichner im Abschnitt Grundlegende SAML-Konfiguration ein.

    i. Kopieren Sie den Wert von SSO-URL/ACS, und fügen Sie diesen in das Textfeld für Anmelde-URL im Abschnitt Grundlegende SAML-Konfiguration ein.

Erstellen eines Aventri-Testbenutzers

In diesem Abschnitt erstellen Sie in Aventri einen Benutzer namens B. Simon. Arbeiten Sie mit dem Supportteam für den Aventri-Client zusammen, um die Benutzer zur Aventri-Plattform hinzuzufügen.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie Ihre Konfiguration für das einmalige Anmelden von Microsoft Entra mithilfe des Zugriffsbereichs.

Wenn Sie im Zugriffsbereich auf die Kachel „Aventri“ klicken, sollten Sie automatisch bei der Aventri-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen zum Zugriffsbereich finden Sie unter Einführung in den Zugriffsbereich.

Zusätzliche Ressourcen