Tutorial: Integration von Microsoft Entra in Voyance

Artikel
03/25/2024

In diesem Tutorial erfahren Sie, wie Sie Voyance in Microsoft Entra ID integrieren. Die Integration von Voyance in Microsoft Entra ID bietet die folgenden Vorteile:

Sie können in Microsoft Entra ID steuern, wer Zugriff auf Voyance hat.
Sie können es Ihren Benutzer*innen ermöglichen, dass sie mit ihren Microsoft Entra-Konten automatisch bei Voyance angemeldet werden (einmaliges Anmelden).
Sie können Ihre Konten an einem zentralen Ort verwalten.

Weitere Informationen zur Integration von SaaS-Apps in Microsoft Entra ID finden Sie unter Was ist Anwendungszugriff und einmaliges Anmelden mit Microsoft Entra ID?. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Voraussetzungen

Zum Konfigurieren der Microsoft Entra-Integration mit Voyance benötigen Sie Folgendes:

Ein Microsoft Entra-Abonnement. Sollten Sie über keine Microsoft Entra-Umgebung verfügen, können Sie ein kostenloses Konto verwenden
Voyance-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.

Voyance unterstützt SP- und IDP-initiiertes einmaliges Anmelden.
Voyance unterstützt die Just-in-Time-Benutzerbereitstellung.

Hinzufügen von Voyance über den Katalog

Um die Integration von Voyance in Microsoft Entra ID zu konfigurieren, müssen Sie Voyance aus dem Katalog zu Ihrer Liste mit den verwalteten SaaS-Apps hinzufügen.

Führen Sie die folgenden Schritte aus, um Voyance über den Katalog hinzuzufügen:

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
Geben Sie im Suchfeld Voyance ein, wählen Sie im Ergebnisbereich Voyance aus, und klicken Sie dann auf die Schaltfläche Hinzufügen, um die Anwendung hinzuzufügen.

Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra

In diesem Abschnitt konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit Voyance mithilfe einer Testbenutzerin namens Britta Simon. Damit einmaliges Anmelden funktioniert, muss eine Linkbeziehung zwischen Microsoft Entra-Benutzer*innen und den entsprechenden Benutzer*innen in Voyance eingerichtet werden.

Zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit Voyance müssen Sie die folgenden Schritte ausführen:

Konfigurieren des einmaligen Anmeldens von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
Konfigurieren des einmaligen Anmeldens für Voyance, um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
Erstellen eines Microsoft Entra-Testbenutzers, um das einmalige Anmelden von Microsoft Entra mit der Testbenutzerin Britta Simon zu testen.
Zuweisen von Microsoft Entra-Testbenutzerin, um Britta Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
Erstellen eines Voyance-Testbenutzers, um ein Pendant von Britta Simon in Voyance zu erhalten, das mit ihrer Darstellung in Microsoft Entra verknüpft ist.
Testen der einmaligen Anmeldung , um zu überprüfen, ob die Konfiguration funktioniert.

Konfigurieren des einmaligen Anmeldens von Microsoft Entra

In diesem Abschnitt aktivieren Sie das einmalige Anmelden von Microsoft Entra.

Führen Sie die folgenden Schritte aus, um das einmalige Anmelden von Microsoft Entra mit Voyance zu konfigurieren:

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie über Identität>Anwendungen>Unternehmensanwendungen>Voyance zur Anwendungsintegrationsseite, und wählen Sie Einmaliges Anmelden aus.
Wählen Sie im Dialogfeld SSO-Methode auswählen den Modus SAML/WS-Fed aus, um einmaliges Anmelden zu aktivieren.
Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Symbol Bearbeiten, um das Dialogfeld Grundlegende SAML-Konfiguration zu öffnen.
Führen Sie im Abschnitt Grundlegende SAML-Konfiguration die folgenden Schritte aus, wenn Sie die Anwendung im IDP-initiierten Modus konfigurieren möchten:

a. Geben Sie im Textfeld Bezeichner eine URL im folgenden Format ein: https://<companyname>.nyansa.com

b. Geben Sie im Textfeld Antwort-URL eine URL im folgenden Format ein: https://<companyname>.nyansa.com/saml/create/
Klicken Sie auf Zusätzliche URLs festlegen, 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://<companyname>.nyansa.com/

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. Wenden Sie sich an das Supportteam für den Voyance-Client, um diese Werte zu erhalten. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration ansehen.
Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat auf Herunterladen, um das Ihrer Anforderung entsprechende Zertifikat (Base64) aus den angegebenen Optionen herunterzuladen und auf Ihrem Computer zu speichern.
Kopieren Sie im Abschnitt Voyance einrichten die entsprechenden URLs gemäß Ihren Anforderungen.

a. Anmelde-URL

b. Microsoft Entra-Bezeichner

c. Abmelde-URL

Konfigurieren des einmaligen Anmeldens für Voyance

Melden Sie sich in einem anderen Webbrowserfenster bei Ihrem Voyance-Mandanten als Administrator an.
Klicken Sie in der rechten oberen Ecke der Navigationsleiste auf Profile (Profil).
Klicken Sie auf Admin Settings (Administratoreinstellungen).
Klicken Sie auf die Registerkarte User Access (Benutzerzugriff).
Klicken Sie auf die Schaltfläche SSO is disabled (SSO ist deaktiviert), um Microsoft Entra ID als IdP mit SAML 2.0 zu konfigurieren.
Navigieren Sie zum Abschnitt SAML v2, und führen Sie folgende Schritte aus:

a. Wählen Sie Aktiviert.

b. Fügen Sie im Textfeld IdP Login URL (IdP-Anmelde-URL) die Anmelde-URL ein.

c. Öffnen Sie das heruntergeladene Base64-codierte Zertifikat in Editor, kopieren Sie den Inhalt des Zertifikats in die Zwischenablage, und fügen Sie ihn anschließend in das Textfeld IdP Cert ein.

d. Klicken Sie auf Speichern.

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie eine Testbenutzerin mit dem Namen Britta Simon.

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
Browsen Sie zu Identität>Benutzer>Alle Benutzer.
Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
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.
Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie Britta Simon die Verwendung des einmaligen Anmeldens von Azure, indem Sie ihr Zugriff auf Voyance gewähren.

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Voyance.
Wählen Sie in der Anwendungsliste die Option Voyance aus.
Wählen Sie auf der Übersichtsseite der App Benutzer und Gruppen aus.
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.

Erstellen eines Voyance-Testbenutzers

In diesem Abschnitt wird in Voyance ein Benutzer mit dem Namen Britta Simon erstellt. Voyance 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 Voyance vorhanden, wird nach der Authentifizierung ein neuer Benutzer erstellt.

Hinweis

Setzen Sie sich mit dem Supportteam von Voyance in Verbindung, wenn Sie einen Benutzer manuell erstellen müssen.

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 „Voyance“ klicken, sollten Sie automatisch bei der Voyance-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen zum Zugriffsbereich finden Sie unter Einführung in den Zugriffsbereich.

Freigeben über