Freigeben über

Microsoft Entra SSO-Integration in PoliteMail SSO

  • Artikel

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

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

Voraussetzungen

Um Microsoft Entra ID in PoliteMail SSO 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.
  • PoliteMail SSO-Abonnement, das mit dem einmaligen Anmelden (Single Sign-On) verwendet werden kann.

Beschreibung des Szenarios

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

  • PoliteMail - SSO unterstützt IDP-initiiertes einmaliges Anmelden.
  • PoliteMail SSO unterstützt die Just-In-Time-Benutzerbereitstellung.

PoliteMail SSO aus dem Katalog hinzufügen

Zum Konfigurieren der Integration von PoliteMail SSO in Microsoft Entra ID müssen Sie PoliteMail SSO aus dem Katalog zur Liste der 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 PoliteMail SSO in das Suchfeld ein.
  4. Wählen Sie im Ergebnisbereich PoliteMail SSO aus, und fügen Sie 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 des einmaligen Anmeldens (SSO) von Microsoft Entra für PoliteMail

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

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit PoliteMail SSO 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 PoliteMail SSO, um die Single Sign-On-Einstellungen auf der Anwendungsseite zu konfigurieren.
    1. Erstellen Sie eine(n) PoliteMail SSO-Testbenutzer*in, um in PoliteMail SSO ein Gegenstück von B.Simon zu erhalten, das mit der Benutzerdarstellung 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>PoliteMail SSO>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 shows how to edit Basic SAML Configuration.

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

    a. Geben Sie im Textfeld Bezeichner (Entitäts-ID) eine URL im folgenden Format ein: https://<YOUR_POLITEMAIL_HOSTNAME>.

    b. Geben Sie im Textfeld Antwort-URL eine URL in einem der folgenden Formate ein:

    Antwort-URL
    https://<YOUR_POLITEMAIL_HOSTNAME>/api/Saml2/Acs
    https://<YOUR_POLITEMAIL_HOSTNAME>/ssv3/Saml2/Acs

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Aktualisieren Sie diese Werte mit dem eigentlichen Bezeichner und der Antwort-URL. Wenden Sie sich an PoliteMail SSO-Supportteam, um diese Werte zu erhalten. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration im Microsoft Entra Admin Center ansehen.

  6. Ihre PoliteMail SSO-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.

    Screenshot shows the image of attributes configuration.

  7. Darüber hinaus erwartet die PoliteMail SSO-Anwendung, 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
    Rolle (role) user.assignedroles

    Hinweis

    Bitte klicken Sie hier, um zu erfahren, wie Sie eine Rolle in Microsoft Entra ID konfigurieren.

  8. Klicken Sie im Abschnitt SAML-Signaturzertifikat auf die Schaltfläche Bearbeiten, um das Dialogfeld SAML-Signaturzertifikat zu öffnen.

    Screenshot shows to edit SAML Signing Certificate.

  9. Kopieren Sie im Abschnitt SAML-Signaturzertifikat unter Fingerabdruck den Fingerabdruckwert, und speichern Sie ihn auf Ihrem Computer.

    Screenshot shows to copy Thumbprint value

  10. Kopieren Sie im Abschnitt PoliteMail SSO einrichten die entsprechenden URLs gemäß Ihren Anforderungen.

    Screenshot shows to copy configuration URLs.

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 B. Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra, indem Sie Zugriff auf PoliteMail SSO gewähren.

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

Um einmaliges Anmelden auf der PoliteMail SSO-Seite zu konfigurieren, müssen Sie den Fingerabdruckwert und die entsprechenden kopierten URLs aus dem Microsoft Entra Admin Center an das PoliteMail SSO-Supportteam senden. Es führt die Einrichtung durch, damit die SAML-SSO-Verbindung auf beiden Seiten richtig festgelegt ist.

PoliteMail SSO-Testbenutzer erstellen

In diesem Abschnitt wird in PoliteMail eine Benutzerin namens B. Simon erstellt. PoliteMail SSO unterstützt die Just-In-Time-Bereitstellung, die standardmäßig aktiviert ist. Für Sie steht in diesem Abschnitt kein Aktionselement zur Verfügung. Wenn ein Benutzer noch nicht in PoliteMail SSO vorhanden ist, wird ein neuer erstellt, wenn Sie versuchen, auf PoliteMail SSO zuzugreifen.

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“, und Sie sollten automatisch bei der PoliteMail - SSO angemeldet werden, für die Sie das einmalige Anmelden eingerichtet hatten.

  • Sie können „Meine Apps“ von Microsoft verwenden. Wenn Sie unter „Meine Apps“ auf die Kachel „PoliteMail SSO“ klicken, sollten Sie automatisch bei der ChartDesk SSO-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet hatten. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von PoliteMail SSO können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor Ex- 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.