Tutorial: Integrieren von Appraisd mit Microsoft Entra ID
Artikel
In diesem Tutorial erfahren Sie, wie Sie Appraisd in Microsoft Entra ID integrieren. Wenn Sie Appraisd mit Microsoft Entra ID integrieren, können Sie Folgendes tun:
Sie können in Microsoft Entra ID steuern, wer Zugriff auf Appraisd hat.
Ermöglichen Sie es Ihren Benutzer*innen, sich mit ihren Microsoft Entra-Konten automatisch bei Appraisd anzumelden.
Verwalten Sie Ihre Konten an einem zentralen Ort.
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.
Appraisd-Abonnement, für das einmaliges Anmelden aktiviert ist
Beschreibung des Szenarios
In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.
Appraisd unterstützt SP- und IDP-initiiertes einmaliges Anmelden.
Das Hinzufügen von Appraisd aus dem Katalog
Zum Konfigurieren der Integration von Appraisd in Microsoft Entra ID müssen Sie Appraisd aus dem Katalog der Liste mit den verwalteten SaaS-Apps hinzufügen.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Appraisd in das Suchfeld ein.
Wählen Sie im Ergebnisbereich Appraisd 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 (SSO) von Microsoft Entra für Appraisd
Konfigurieren und testen Sie das einmalige Anmelden (SSO) von Microsoft Entra mit Appraisd mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in Appraisd eingerichtet werden.
Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra mit Appraisd die folgenden Schritte aus:
Erstellen eines Appraisd-Testbenutzers, um in Appraisd eine Entsprechung von B.Simon zu erhalten, die mit ihrer Benutzerdarstellung in Microsoft Entra verknüpft ist.
Navigieren Sie zur Anwendungsintegrationsseite unter Identität>Anwendungen>Unternehmensanwendungen>Appraisd und dann zum Abschnitt Verwalten, und wählen Sie Einmaliges Anmelden aus.
Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.
Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.
Im Abschnitt SAML-Basiskonfiguration ist die Anwendung vorkonfiguriert und die notwendigen URLs sind bereits mit Azure vorausgefüllt. Der Benutzer muss die Konfiguration speichern, indem er auf die Schaltfläche „Speichern“ klickt, und die folgenden Schritte ausführen:
a. Klicken Sie auf Zusätzliche URLs festlegen.
b. Geben Sie im Textfeld Vermittlungsstatus den Wert: <TENANTCODE> ein
c. Wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten, geben Sie im Textfeld Anmelde-URL eine URL unter Verwendung des folgenden Musters ein: https://app.appraisd.com/saml/<TENANTCODE>
Hinweis
Sie können die tatsächlichen Werte für „Anmelde-URL“ und „Relayzustand“ auf der SSO-Konfigurationsseite für Appraisd abrufen, was im weiteren Verlauf des Tutorials erläutert wird.
Appraisd 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, wobei nameidentifier hier user.userprincipalname zugeordnet wird. Die Appraisd-Anwendung erwartet, dass nameidentifier der Wert user.mail zugeordnet ist. Sie müssen die Attributzuordnung daher entsprechend ändern, indem Sie auf das Symbol Bearbeiten klicken.
Suchen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat den Eintrag Zertifikat (Base64) . Klicken Sie auf Herunterladen, um das Zertifikat herunterzuladen, und speichern Sie es auf Ihrem Computer.
Kopieren Sie im Abschnitt Appraisd einrichten die entsprechenden URLs gemäß Ihren Anforderungen.
Erstellen einer Microsoft Entra-Testbenutzerin
In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B. Simon.
Browsen Sie zu Identität>Anwendungen>Unternehmensanwendungen>Appraisd.
Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.
Wählen Sie Benutzer hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann am unteren Bildschirmrand auf die Schaltfläche Auswählen.
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.
Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.
Konfigurieren von einmaligem Anmelden für Appraisd
Melden Sie sich in einem anderen Webbrowserfenster als Administrator bei der Appraisd-Unternehmenswebsite an.
Klicken Sie oben rechts auf der Seite auf das Symbol Settings (Einstellungen), und navigieren Sie dann zu Configuration (Konfiguration).
Klicken Sie im linken Bereich des Menüs auf SAM Single Sign-On (Einmaliges Anmelden mit SAML).
Führen Sie auf der Konfigurationsseite für einmaliges Anmelden mit SAML 2.0 die folgenden Schritte aus:
a. Kopieren Sie den Wert für den Standardrelayzustand, und fügen Sie ihn in das Textfeld Relayzustand im Abschnitt Grundlegende SAML-Konfiguration im Azure-Portal ein.
b. Kopieren Sie den Wert für die Vom Dienst initiierte Anmelde-URL, und fügen Sie ihn in das Textfeld Anmelde-URL im Abschnitt Grundlegende SAML-Konfiguration im Azure-Portal ein.
Scrollen Sie auf derselben Seite nach unten, und führen Sie unter Benutzer werden identifiziert die folgenden Schritte aus:
a. Fügen Sie in das Textfeld Identity Provider Single Sign-On URL den Wert der Anmelde-URL ein, den Sie kopiert haben, und klicken Sie auf Save.
b. Fügen Sie in das Textfeld Identity Provider Issuer URL den Wert für Microsoft Entra-Bezeichner ein, den Sie kopiert haben, und klicken Sie auf Save.
c. Öffnen Sie in Editor das Base64-codierte Zertifikat, das Sie heruntergeladen haben, kopieren Sie den Inhalt, fügen Sie ihn anschließend in das Feld X.509 Certificate ein, und klicken Sie auf Save.
Erstellen eines Appraisd-Testbenutzers
Damit sich Microsoft Entra-Benutzer bei Appraisd anmelden können, müssen sie in Appraisd bereitgestellt werden. Im Fall von Appraisd muss die Bereitstellung manuell ausgeführt werden.
Führen Sie zum Bereitstellen eines Benutzerkontos die folgenden Schritte aus:
Melden Sie sich bei Appraisd als Sicherheitsadministrator an.
Klicken Sie oben rechts auf der Seite auf das Symbol Einstellungen und navigieren Sie dann zum Verwaltungscenter.
Klicken Sie auf der Symbolleiste am oberen Rand der Seite auf People (Personen), und navigieren Sie dann zu Add a new user (Neuen Benutzer hinzufügen).
Führen Sie auf der Seite Add a new user (Neuen Benutzer hinzufügen) die folgenden Schritte aus:
a. Geben Sie im Textfeld First name (Vorname) den Vornamen des Benutzers ein, z. B. Britta.
b. Geben Sie im Textfeld Last name (Nachname) den Nachnamen des Benutzers ein, z. B. Simon.
c. Geben Sie im Textfeld Email (E-Mail-Adresse) die E-Mail-Adresse des Benutzers ein, z.B. B. Simon@contoso.com.
d. Klicken Sie auf Benutzer hinzufügen.
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 Appraisd weitergeleitet, wo Sie den Anmeldeflow initiieren können.
Rufen Sie direkt die Anmelde-URL für Appraisd auf und initiieren Sie den Anmeldeablauf von dort aus.
IDP-initiiert:
Klicken Sie auf Diese Anwendung testen. Sie sollten automatisch bei der Appraisd-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 „Appraisd“ in „Meine Apps“ geschieht Folgendes: Wenn Sie die Anwendung im SP-Modus konfiguriert haben, werden Sie zum Initiieren des Anmeldeablaufs zur Anmeldeseite der Anwendung weitergeleitet. Wenn Sie die Anwendung im IDP-Modus konfiguriert haben, sollten Sie automatisch bei der Appraisd-Instanz angemeldet werden, für die Sie das einmalige Anmelden eingerichtet haben. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.
Deploying and monitoring enterprise applications to Azure solutions can ensure security. Explore how to deploy on-premises and cloud based apps to users.