Freigeben über

Microsoft Entra Integration mit TOPdesk – Öffentlich

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie TOPdesk - Public mit Microsoft Entra ID integrieren. Die Integration von TOPdesk - Public mit Microsoft Entra ID ermöglicht Folgendes:

  • Sie können in Microsoft Entra ID steuern, wer Zugriff auf TOPdesk - Public hat.
  • Sie können Ihren Benutzer*innen ermöglichen, sich mit ihren Microsoft Entra-Konten automatisch bei TOPdesk - Public 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.
  • TOPdesk - Public-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.

  • TOPdesk - Public unterstützt SP-initiiertes einmaliges Anmelden.

Hinzufügen von TOPdesk - Public aus dem Katalog

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

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit TOPdesk - Public mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit einmaliges Anmelden funktioniert, muss eine Linkbeziehung zwischen Microsoft Entra-Benutzer*innen und den entsprechenden Benutzer*innen in TOPdesk - Public eingerichtet werden.

Führen Sie zum Konfigurieren des einmaligen Anmeldens von Microsoft Entra mit TOPdesk - Public 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 Testbenutzerkonto 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 TOPdesk - Public , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen einer TOPdesk - Public-Testbenutzerin, um eine Entsprechung von B. Simon in TOPdesk - Public 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>TOPdesk – Öffentliches>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.

    Bearbeiten der SAML-Basiskonfiguration

  5. Führen Sie im Abschnitt Grundlegende SAML-Konfiguration die folgenden Schritte aus, wenn Sie über eine Dienstanbieter-Metadatendatei verfügen:

    Hinweis

    Die Dienstanbieter-Metadatendatei rufen Sie später im Tutorial im Abschnitt Konfigurieren des einmaligen Anmeldens für TOPdesk - Public ab.

    a. Klicken Sie auf Metadatendatei hochladen.

    Metadatendatei hochladen

    b. Klicken Sie auf das Ordnerlogo, wählen Sie die Metadatendatei aus, und klicken Sie auf Hochladen.

    Metadatendatei auswählen

    c. Nach dem erfolgreichen Upload der Metadatendatei werden die Werte unter Bezeichner und Antwort-URL im Abschnitt „Grundlegende SAML-Konfiguration“ automatisch eingefügt.

    d. Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://<companyname>.topdesk.net

    e. Geben Sie im Textfeld Identifier URL (Bezeichner-URL) die TOPdesk-Metadaten-URL ein, die Sie aus der TOPdesk-Konfiguration abrufen können. Verwenden Sie das folgende Format: https://<companyname>.topdesk.net/saml-metadata/<identifier>.

    f. Geben Sie im Textfeld Antwort-URL eine URL nach folgendem Muster ein: https://<companyname>.topdesk.net/tas/public/login/verify

    Hinweis

    Werden die Werte für Bezeichner und Antwort-URL nicht automatisch aufgefüllt, müssen Sie sie manuell eingeben. Verwenden Sie für „Bezeichner“ das oben genannte Format. Den Wert für „Antwort-URL“ rufen Sie später im Tutorial im Abschnitt Konfigurieren des einmaligen Anmeldens für TOPdesk - Public ab. Der Wert für die Anmelde-URL entspricht nicht dem tatsächlichen Wert. Aktualisieren Sie den Wert mit der richtigen Anmelde-URL. Den Wert erhalten Sie vom Supportteam für den TOPdesk - Public-Client. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration ansehen.

  6. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat auf Herunterladen, um den Ihren Anforderungen entsprechenden Verbundmetadaten-XML-Code aus den verfügbaren Optionen herunterzuladen und auf Ihrem Computer zu speichern.

    Downloadlink für das Zertifikat

  7. Kopieren Sie im Abschnitt TOPdesk - Public einrichten die entsprechenden URLs gemäß Ihren Anforderungen.

    Kopieren der Konfiguration-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 B. Simon die Verwendung des einmaligen Anmeldens, indem Sie ihr Zugriff auf TOPdesk – Public gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>TOPdesk – Öffentliches.
  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 des einmaligen Anmeldens für TOPdesk - Public

  1. Melden Sie sich auf Ihrer TOPdesk - Public-Unternehmenswebsite als Administrator an.

  2. Klicken Sie im TOPdesk-Menü auf Einstellungen.

    Einstellungen

  3. Klicken Sie auf Anmeldeeinstellungen.

    Anmeldeeinstellungen

  4. Erweitern Sie das Menü Anmeldeeinstellungen, und klicken Sie dann auf Allgemein.

    Allgemeine Einstellungen

  5. Führen Sie im Abschnitt Öffentlich des Konfigurationsabschnitts SAML-Anmeldung die folgenden Schritte aus:

    Technische Einstellungen

    a. Klicken Sie auf Herunterladen, um die öffentliche Metadatendatei herunterzuladen, und speichern Sie sie dann lokal auf Ihrem Computer.

    b. Öffnen Sie die heruntergeladene Metadatendatei, und suchen Sie den Knoten AssertionConsumerService.

    BehauptungConsumerService

    c. Kopieren Sie den Wert AssertionConsumerService, und fügen Sie ihn im Abschnitt Basic SAML Configuration (Grundlegende SAML-Konfiguration) in das Textfeld Reply URL (Antwort-URL) ein.

  6. Zum Erstellen einer Zertifikatsdatei führen Sie die folgenden Schritte durch:

    Zertifikat

    a. Öffnen Sie die aus dem Azure-Portal heruntergeladene Metadatendatei.

    b. Erweitern Sie den Knoten RoleDescriptor, der einen xsi:type gleich fed:ApplicationServiceType aufweist.

    c. Kopieren Sie den Wert des Knotens X509Certificate.

    d. Speichern Sie den kopierten X509Certificate-Wert lokal auf Ihrem Computer in einer Datei.

  7. Klicken Sie im Abschnitt Öffentlich auf Hinzufügen.

    SAML-Anmeldung

  8. Führen Sie auf der Dialogseite SAML-Konfigurationsassistent die folgenden Schritte aus:

    SAML-Konfigurations-Assistent

    a. Klicken Sie zum Hochladen der aus dem Azure-Portal heruntergeladenen Metadatendatei unter Verbundmetadaten auf Durchsuchen.

    b. Zum Hochladen der Zertifikatsdatei klicken Sie unter Zertifikat (RSA) auf Durchsuchen.

    c. Wenn Sie die Logodatei hochladen möchten, die Sie vom TOPdesk-Supportteam erhalten haben, klicken Sie unter Logo-Symbol auf Durchsuchen.

    d. Geben Sie in das Textfeld http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress ein.

    e. Geben Sie in das Textfeld Anzeigename einen Namen für Ihre Konfiguration ein.

    f. Klicken Sie auf Speichern.

Erstellen eines TOPdesk - Public-Testbenutzers

Damit sich Microsoft Entra-Benutzer*innen bei TOPdesk - Public anmelden können, müssen sie in TOPdesk - Public bereitgestellt werden. Im Fall von TOPdesk - Public ist die Bereitstellung eine manuelle Aufgabe.

So konfigurieren Sie die Benutzerbereitstellung

  1. Melden Sie sich bei Ihrem TOPdesk - Public -Unternehmenswebsite als Administrator an.

  2. Klicken Sie im Menü oben auf TOPdesk > Neu > Support-Dateien > Person.

    Person

  3. Führen Sie im Dialogfeld „Neue Person“ die folgenden Schritte aus:

    Neue Person

    a. Klicken Sie auf die Registerkarte Allgemein.

    b. Geben Sie im Textfeld Nachname den Nachnamen des Benutzers ein, z.B. „Simon“.

    c. Wählen Sie eine Website für das Konto aus.

    d. Klicken Sie auf Speichern.

Hinweis

Sie können Microsoft Entra-Benutzerkonten auch mithilfe anderer Tools zum Erstellen von TOPdesk - Public-Benutzerkonten oder mithilfe der von TOPdesk - Public bereitgestellten APIs erstellen.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen.

  • Klicken Sie auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL von TOPdesk – Public weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Rufen Sie direkt die Anmelde-URL für TOPdesk - Public auf, und initiieren Sie den Anmeldeflow.

  • Sie können „Meine Apps“ von Microsoft verwenden. Wenn Sie in „Meine Apps“ auf die Kachel „TOPdesk - Public“ klicken, werden Sie zur Anmelde-URL für TOPdesk - Public weitergeleitet. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von TOPdesk - Public 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.