Freigeben über


Konfigurieren der Ideagen Cloud für die automatische Benutzerbereitstellung mit Microsoft Entra-ID

In diesem Artikel werden die Schritte beschrieben, die Sie in Ideagen Cloud und Microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Nach Abschluss der Konfiguration stellt Microsoft Entra ID mithilfe des Microsoft Entra-Bereitstellungsdiensts automatisch Benutzer*innen und/oder Gruppen in Ideagen Cloud bereit bzw. hebt die Bereitstellung auf. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert, und Antworten auf häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -entfernung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

  • Erstellen von Benutzern in Ideagen Cloud.
  • Entfernen Sie Benutzer in der Ideagen Cloud, wenn sie keinen Zugriff mehr benötigen.
  • Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Ideagen Cloud.

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie bereits über die folgenden Voraussetzungen verfügen:

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

  1. Erfahren Sie, wie der Bereitstellungsdienst funktioniert.
  2. Definieren Sie den Geltungsbereich für die Bereitstellung.
  3. Legen Sie fest, welche Daten zwischen Microsoft Entra ID und Ideagen Cloud zugeordnet werden sollen.

Schritt 2: Konfigurieren von Ideagen Cloud zur Unterstützung der Bereitstellung mit Microsoft Entra ID

  1. Melden Sie sich bei Ideagen an. Wählen Sie das Verwaltungssymbol aus, um das linke Seitenmenü anzuzeigen.

    Screenshot: Verwaltungsmenü.

  2. Navigieren Sie zur Seite Authentication im Untermenü Manage tenant.

    Screenshot: Authentifizierungsseite.

  3. Aktivieren Sie die Schaltfläche "Bearbeiten", und aktivieren Sie unter der automatischen Bereitstellung das Kontrollkästchen "Aktiviert ".

    Der Screenshot der Registerkarte Bereitstellung.

  4. Wählen Sie die Schaltfläche " Speichern " aus, um die Änderungen zu speichern.

  5. Scrollen Sie auf der Authentifizierungsseite nach unten zum Abschnitt Clienttoken und wählen Sie Neu generieren aus.

    Screenshot: Tokengenerierung.

  6. Kopieren und speichern Sie den Bearer-Token. Dieser Wert wird in das Feld "Geheimes Token *" auf der Registerkarte "Bereitstellung" Ihrer Ideagen Cloud-Anwendung eingegeben.

    Screenshot vom Kopieren des Tokens.

  7. Suchen Sie die SCIM-URL, und bewahren Sie den Wert für die spätere Verwendung auf. Dieser Wert wird beim Konfigurieren der automatischen Benutzerbereitstellung im Azure-Portal als Mandanten-URL verwendet.

Fügen Sie Ideagen Cloud aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in Ideagen Cloud zu beginnen. Wenn Sie Ideagen Cloud zuvor für das einmalige Anmelden (Single Sign-On, SSO) eingerichtet haben, können Sie dieselbe Anwendung verwenden. Es wird jedoch empfohlen, beim anfänglichen Testen der Integration eine separate App zu erstellen. Erfahren Sie mehr über das Hinzufügen einer Anwendung aus der Galerie hier.

Schritt 4: Definieren, wer in die Bereitstellung einbezogen werden soll

Mit dem Microsoft Entra-Bereitstellungsdienst können Sie festlegen, wer basierend auf der Zuweisung zur Anwendung oder basierend auf Attributen des Benutzers oder der Gruppe bereitgestellt wird. Wenn Sie den Umfang festlegen, wer basierend auf der Zuweisung Zugriff auf Ihre App erhält, können Sie die Schritte nutzen, um Benutzer und Gruppen der Anwendungzuzuweisen. Wenn Sie allein anhand der Attribute von Benutzenden oder der Gruppe auswählen möchten, wer bereitgestellt wird, können Sie einen Bereichsfilter verwenden.

  • Beginnen Sie klein. Testen Sie mit einer kleinen Anzahl von Benutzern und Gruppen, bevor Sie es auf alle anwenden. Wenn der Bereich für die Bereitstellung auf zugewiesene Benutzer und Gruppen festgelegt ist, können Sie dies steuern, indem Sie der App einen oder zwei Benutzer oder Gruppen zuweisen. Wenn der Bereich auf alle Benutzer und Gruppen festgelegt ist, können Sie einen attributbasierten Bereichsdefinitionsfilterangeben.

  • Wenn Sie zusätzliche Rollen benötigen, können Sie das Anwendungsmanifest aktualisieren, um neue Rollen hinzuzufügen.

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung in Ideagen Cloud

In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzer*innen und/oder Gruppen in Ideagen Cloud auf der Grundlage von Benutzer- bzw. Gruppenzuweisungen in Microsoft Entra ID erläutert.

So konfigurieren Sie die automatische Benutzerbereitstellung für Ideagen Cloud in Microsoft Entra ID:

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Entra ID>Enterprise-Apps

    Screenshot: Bereich „Unternehmensanwendungen“

  3. Wählen Sie in der Anwendungsliste Ideagen Cloudaus.

    Screenshot: Ideagen Cloud-Link in der Anwendungsliste.

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot der Registerkarte Bereitstellung.

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

    Screenshot der Registerkarte „Bereitstellung“, Option „Automatisch“.

  6. Geben Sie im Abschnitt Admin-Anmeldeinformationen Ihre Mandanten-URL für Ideagen Cloud und das dazugehörige geheime Token ein. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass Microsoft Entra-ID eine Verbindung mit der Ideagen Cloud herstellen kann. Wenn die Verbindung nicht möglich ist, sollten Sie sicherstellen, dass Ihr Ideagen Cloud-Konto über Administratorberechtigungen verfügt, und den Vorgang wiederholen.

    Screenshot des Tokens.

  7. Geben Sie im Feld Benachrichtigungs-E-Mail- die E-Mail-Adresse einer Person oder Gruppe ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie das Kontrollkästchen E-Mail-Benachrichtigung senden bei einem Fehler.

    Screenshot der Benachrichtigungs-E-Mail.

  8. Wählen Sie Speichern aus.

  9. Wählen Sie im Abschnitt Zuordnungen die Option Microsoft Entra-Benutzer mit Ideagen Cloud synchronisieren aus.

  10. Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit Ideagen Cloud synchronisiert werden. Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Benutzerkonten in Ideagen Cloud für Updatevorgänge verwendet werden. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die Ideagen Cloud-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche Speichern aus, um änderungen zu übernehmen.

    Attribut Typ Unterstützt das Filtern Erforderlich für Ideagen Cloud
    Nutzername Schnur
    aktiv Boolescher Wert
    Anzeigename Schnur
    title Schnur
    emails[type eq "work"].value Schnur
    bevorzugteSprache Schnur
    name.givenName Schnur
    name.familyName Schnur
    externalId Schnur

    Hinweis

    Alle erforderlichen Felder (z. B. Vorname, Nachname und E-Mail-Adresse) müssen in Microsoft Entra ID ausgefüllt werden, damit die automatische Bereitstellung ohne Probleme funktioniert.

  11. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Artikel Bereichsfilter.

  12. Um den Microsoft Entra-Bereitstellungsdienst für Ideagen Cloud zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt Einstellungen zu Ein.

    Screenshot: Bereitstellungsstatus „Aktiviert“

  13. Legen Sie die Benutzer bzw. Gruppen fest, die in Ideagen Cloud bereitgestellt werden sollen. Wählen Sie dazu im Abschnitt Einstellungen unter Bereich die gewünschten Werte aus.

    Screenshot: Bereitstellungsbereich

  14. Wählen Sie Speichern aus, wenn die Bereitstellung erfolgen kann.

    Screenshot des Speicherns der Bereitstellungskonfiguration.

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer und Gruppen, die in Bereich im Abschnitt Einstellungen definiert sind. Der anfängliche Zyklus dauert länger als nachfolgende Zyklen, die ungefähr alle 40 Minuten auftreten, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird.

Schritt 6: Überwachen der Bereitstellung

Nachdem Sie die Bereitstellung konfiguriert haben, verwenden Sie die folgenden Ressourcen, um Ihre Bereitstellung zu überwachen:

  1. Verwenden Sie die Bereitstellungsprotokolle, um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt werden.
  2. Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus anzuzeigen und zu sehen, wie nah er am Abschluss ist.
  3. Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand befindet, wechselt die Anwendung in den Quarantänemodus. Weitere Informationen zum Quarantänestatus finden Sie im Artikel Anwendungsbereitstellung im Quarantänestatus.

Weitere Ressourcen