Tutorial: Azure AD-SSO-Integration in Pega Systems

In diesem Tutorial erfahren Sie, wie Sie Pega Systems in Azure Active Directory (Azure AD) integrieren. Die Integration von Pega Systems in Azure AD ermöglicht Folgendes:

  • Steuern Sie in Azure AD, wer Zugriff auf Pega Systems hat.
  • Ermöglichen Sie es Ihren Benutzern, sich mit ihren Azure AD-Konten automatisch bei Pega Systems anzumelden.
  • Verwalten Sie Ihre Konten zentral im Azure-Portal.

Voraussetzungen

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

  • Ein Azure AD-Abonnement Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
  • Ein Pega Systems-Abonnement, für das einmaliges Anmelden aktiviert ist

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Azure AD in einer Testumgebung.

  • Pega Systems unterstützt SP- und IDP-initiiertes einmaliges Anmelden.

Um die Integration von Pega Systems in Azure AD zu konfigurieren, müssen Sie Pega Systems aus dem Katalog zu Ihrer Liste mit den verwalteten SaaS-Apps hinzufügen.

  1. Melden Sie sich mit einem Geschäfts-, Schul- oder Unikonto oder mit einem persönlichen Microsoft-Konto beim Azure-Portal an.
  2. Wählen Sie im linken Navigationsbereich den Dienst Azure Active Directory aus.
  3. Navigieren Sie zu Unternehmensanwendungen, und wählen Sie dann Alle Anwendungen aus.
  4. Wählen Sie zum Hinzufügen einer neuen Anwendung Neue Anwendung aus.
  5. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Pega Systems in das Suchfeld ein.
  6. Wählen Sie im Ergebnisbereich Pega Systems 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 Azure AD für Pega Systems

Konfigurieren und testen Sie das einmalige Anmelden von Azure AD mit Pega Systems mithilfe eines Testbenutzers namens B. Simon. Damit einmaliges Anmelden funktioniert, muss eine Linkbeziehung zwischen einem Azure AD-Benutzer und dem entsprechenden Benutzer in Pega Systems eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Azure AD mit Pega Systems die folgenden Schritte aus:

  1. Konfigurieren des einmaligen Anmeldens von Azure AD , um Ihren Benutzern die Verwendung dieses Features zu ermöglichen.
    1. Erstellen eines Azure AD-Testbenutzers , um das einmalige Anmelden von Azure AD mit dem Testbenutzer B. Simon zu testen.
    2. Zuweisen des Azure AD-Testbenutzers , um B. Simon die Verwendung des einmaligen Anmeldens von Azure AD zu ermöglichen.
  2. Konfigurieren des einmaligen Anmeldens für Pega Systems , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen eines Pega Systems-Testbenutzers , um ein Pendant von B. Simon in Pega Systems zu erhalten, das mit ihrer Darstellung in Azure AD verknüpft ist
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (Single Sign-On, SSO) von Azure AD

Gehen Sie wie folgt vor, um das einmalige Anmelden von Azure AD im Azure-Portal zu aktivieren.

  1. Navigieren Sie im Azure-Portal auf der Anwendungsintegrationsseite für Pega Systems zum Abschnitt Verwalten, und wählen Sie Einmaliges Anmelden aus.

  2. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

  3. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

    Bearbeiten der SAML-Basiskonfiguration

  4. Führen Sie im Dialogfeld Grundlegende SAML-Konfiguration die folgenden Schritte aus, wenn Sie die Anwendung im IdP-initiierten Modus konfigurieren möchten.

    1. Geben Sie im Feld Bezeichner eine URL im folgenden Format ein:

      https://<customername>.pegacloud.io:443/prweb/sp/<instanceID>

    2. Geben Sie im Feld Antwort-URL eine URL im folgenden Format ein:

      https://<customername>.pegacloud.io:443/prweb/PRRestService/WebSSO/SAML/AssertionConsumerService

  5. Wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten, klicken Sie auf Zusätzliche URLs festlegen, und führen Sie die folgenden Schritte aus.

    1. Geben Sie im Feld Anmelde-URL den Wert der Anmelde-URL ein.

    2. Geben Sie im Feld Relayzustand eine URL im folgenden Format ein: https://<customername>.pegacloud.io/prweb/sso

    Hinweis

    Die hier angegebenen Werte sind Platzhalter. Sie müssen die tatsächlichen Werte für Bezeichner, Antwort-URL, Anmelde-URL und Relayzustand-URL verwenden. Sie können die Werte für den Bezeichner und die Antwort-URL aus einer Pega-Anwendung abrufen, wie es weiter unten in diesem Tutorial beschrieben ist. Wenden Sie sich an das Supportteam von Pega Systems, um den Wert für den Relayzustand zu erhalten. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration im Azure-Portal ansehen.

  6. Für die Pega Systems-Anwendung müssen die SAML-Assertionen in einem bestimmten Format vorliegen. Um sie im richtigen Format zu erhalten, müssen Sie Ihrer Konfiguration der SAML-Tokenattribute benutzerdefinierte Attributzuordnungen hinzufügen. Der folgende Screenshot zeigt die Standardattribute. Wählen Sie das Symbol Bearbeiten aus, um das Dialogfeld Benutzerattribute zu öffnen:

    Benutzerattribute

  7. Zusätzlich zu den im vorherigen Screenshot gezeigten Attributen erfordert die Pega Systems-Anwendung einige weitere Attribute, die in der SAML-Antwort zurückgegeben werden müssen. Führen Sie im Dialogfeld Benutzerattribute im Abschnitt Benutzeransprüche die folgenden Schritte aus, um diese SAML-Tokenattribute hinzuzufügen:

    • uid
    • cn
    • mail
    • accessgroup
    • organization
    • orgdivision
    • orgunit
    • workgroup
    • Phone

    Hinweis

    Diese Werte sind spezifisch für Ihre Organisation. Geben Sie die entsprechenden Werte an.

    1. Wählen Sie Neuen Anspruch hinzufügen aus, um das Dialogfeld Benutzeransprüche verwalten zu öffnen:

    „Neuen Anspruch hinzufügen“ auswählen

    Dialogfeld „Benutzeransprüche verwalten“

    1. Geben Sie im Feld Name den für die Zeile angezeigten Attributnamen ein.

    2. Lassen Sie das Feld Namespace leer.

    3. Wählen Sie für Quelle die Option Attribut aus.

    4. Wählen Sie in der Liste Quellattribut den für diese Zeile angezeigten Attributwert aus.

    5. Klicken Sie auf OK.

    6. Wählen Sie Speichern aus.

  8. Wählen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat den Link Herunterladen neben Verbundmetadaten-XML gemäß Ihren Anforderungen aus, und speichern Sie das Zertifikat auf Ihrem Computer:

    Downloadlink für Zertifikat

  9. Kopieren Sie im Abschnitt Pega Systems einrichten die entsprechenden URLs gemäß Ihren Anforderungen.

    Kopieren der Konfiguration-URLs

Erstellen eines Azure AD-Testbenutzers

In diesem Abschnitt erstellen Sie im Azure-Portal einen Testbenutzer mit dem Namen B. Simon.

  1. Wählen Sie im linken Bereich des Microsoft Azure-Portals Azure Active Directory > Benutzer > Alle Benutzer aus.
  2. Wählen Sie oben im Bildschirm die Option Neuer Benutzer aus.
  3. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
    1. Geben Sie im Feld Name die Zeichenfolge ein.
    2. Geben Sie im Feld Benutzername die Zeichenfolge ein. 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 Erstellen.

Zuweisen des Azure AD-Testbenutzers

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

  1. Wählen Sie im Azure-Portal Unternehmensanwendungen > Alle Anwendungen aus.
  2. Wählen Sie in der Anwendungsliste den Eintrag Pega Systems aus.
  3. Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.
  4. Wählen Sie Benutzer hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
  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 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.
  7. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren des einmaligen Anmeldens für Pega Systems

  1. Zum Konfigurieren des einmaligen Anmeldens auf Pega Systems-Seite melden Sie sich in einem anderen Browserfenster mit einem Administratorkonto beim Pega-Portal an.

  2. Wählen Sie Create (Erstellen)>SysAdmin (Systemadministrator)>Authentication Service (Authentifizierungsdienst) aus:

    Authentifizierungsdienst auswählen

  3. Führen Sie im Bildschirm Create Authentication Service (Authentifizierungsdienst erstellen) die folgenden Schritte aus.

    Bildschirm zum Erstellen des Authentifizierungsdiensts

    1. Wählen Sie in der Liste Type (Typ) den Eintrag SAML 2.0 aus.

    2. Geben Sie in das Feld Name den gewünschten Namen ein (z.B. Azure AD SSO).

    3. Geben Sie in das Feld Short description (Kurzbeschreibung) eine Beschreibung ein.

    4. Wählen Sie Create and open (Erstellen und öffnen) aus.

  4. Wählen Sie im Abschnitt Identity Provider (IdP) information (Informationen zum Identitätsanbieter) die Option Import IdP metadata (IDP-Metadaten importieren) aus, und navigieren Sie zu der Metadatendatei, die Sie aus dem Azure-Portal heruntergeladen haben. Klicken Sie auf Submit (Senden), um die Metadaten zu laden:

    Abschnitt mit Informationen zum Identitätsanbieter

    Durch den Importvorgang werden die IDP-Daten wie hier gezeigt eingetragen:

    Importierte IDP-Daten

  5. Führen Sie im Abschnitt Service Provider (SP) settings (Einstellungen für den Dienstanbieter) die folgenden Schritte aus.

    Einstellungen für den Dienstanbieter

    1. Kopieren Sie den Wert im Feld Entity Identification (Entitätsidentifizierung), und fügen Sie ihn im Azure-Portal im Abschnitt Grundlegende SAML-Konfiguration in das Feld Bezeichner ein.

    2. Kopieren Sie den Wert im Feld Assertion Consumer Service (ACS) location (ACS-Speicherort), und fügen Sie ihn im Azure-Portal im Abschnitt Grundlegende SAML-Konfiguration in das Feld Antwort-URL ein.

    3. Aktivieren Sie Disable request signing.

  6. Wählen Sie Speichern aus.

Erstellen eines Pega Systems-Testbenutzers

Als Nächstes müssen Sie in Pega Systems einen Benutzer mit dem Namen Britta Simon erstellen. Wenden Sie sich an das Supportteam von Pega Systems, um Benutzer zu erstellen.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Azure AD-Konfiguration für einmaliges Anmelden mit den folgenden Optionen:

SP-initiiert:

  • Klicken Sie im Azure-Portal auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL für Pega Systems weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Rufen Sie direkt die Pega Systems-Anmelde-URL auf, und initiieren Sie den Anmeldeflow.

IDP-initiiert:

  • Klicken Sie im Azure-Portal auf Diese Anwendung testen. Dadurch sollten Sie automatisch bei der Pega Systems-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 „Pega Systems“ in „Meine Apps“ geschieht Folgendes: Wenn Sie den SP-Modus konfiguriert haben, werden Sie zum Initiieren des Anmeldeflows zur Anmeldeseite der Anwendung weitergeleitet. Wenn Sie den IDP-Modus konfiguriert haben, sollten Sie automatisch bei der Pega Systems-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 Pega Systems können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor der Exfiltration 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.