Freigeben über


Anleitung: Konfigurieren von uniFLOW Online zur automatischen Benutzerbereitstellung

Dieses Tutorial beschreibt die Schritte, die Sie sowohl in uniFLOW Online als auch in 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 für uniFLOW Online bereit bzw. hebt die Bereitstellung auf. Wichtige Details zum Zweck und zur Funktionsweise dieses Diensts sowie häufig gestellte Fragen finden Sie unter Automatisieren der Bereitstellung und Bereitstellungsaufhebung von Benutzer*innen für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

  • Erstellen Sie Benutzer in uniFLOW Online.
  • Deaktivieren Sie Benutzer in uniFLOW Online.
  • Entfernen Sie Benutzer in uniFLOW Online, wenn sie keinen Zugriff mehr benötigen.
  • Benutzerattribute zwischen Microsoft Entra ID und uniFLOW Online synchronisieren.
  • Einmaliges Anmelden bei uniFLOW Online (empfohlen).

Voraussetzungen

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

Schritt 1: Planen der Bereitstellung

  1. Erfahren Sie, wie der Bereitstellungsdienst funktioniert.
  2. Bestimmen Sie, wer in den Bereitstellungsbereich einbezogen werden soll.
  3. Legen Sie fest, welche Daten zwischen Microsoft Entra ID und uniFLOW Online zugeordnet werden sollen.

Schritt 2: Konfigurieren von uniFLOW Online für die Unterstützung der Bereitstellung mit Microsoft Entra ID

  • Melden Sie sich in einem anderen Webbrowserfenster als Administrator bei der uniFLOW Online-Website an.
  • Wählen Sie die Registerkarte Erweiterungen > Identitätsanbieter > Identitätsanbieter konfigurieren aus.
  • Klicken Sie auf Identitätsanbieter hinzufügen. Führen Sie im Abschnitt IDENTITÄTSANBIETER HINZUFÜGEN die folgenden Schritte aus:
    • Geben Sie den Anzeigenamen ein.
    • Wählen Sie unter Anbietertyp im Dropdownmenü die Option WS-Verbund aus.
    • Wählen Sie für WS-Federation Typ die Option Microsoft Entra ID aus dem Dropdownmenü aus.
    • Klicken Sie auf Speichern.
  • Aktivieren Sie die erweiterte administrative Ansicht in Ihren Benutzerprofileinstellungen, indem Sie zu Profileinstellungen navigieren, > Administratoransicht, und legen Sie sie auf erweitertfest.
  • Die Registerkarte „Bereitstellung“ ist jetzt in der Identitätsanbieterkonfiguration verfügbar.
  • Klicken Sie auf Bereitstellung aktivieren, wenn Sie bereit sind, die Benutzerbereitstellung in der Microsoft Entra-ID Ihres Unternehmens einzurichten.
    • URL des Bereitstellungsmandanten (wird nur einmal angezeigt, nachdem Bereitstellung aktiviert wurde): Sie benötigen diese URL, wenn Sie die Bereitstellung in Ihrer Microsoft Entra-Anwendung einrichten.
    • Geheimes Bereitstellungstoken (wird nur einmal angezeigt, nachdem Bereitstellung aktiviert wurde): Sie benötigen dieses Token, wenn Sie die Bereitstellung in Ihrer Microsoft Entra-Anwendung einrichten.

Fügen Sie uniFLOW Online aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in uniFLOW Online zu beginnen. Wenn Sie zuvor uniFLOW Online für 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, welche Benutzer*innen in die Bereitstellung einbezogen werden

Mit dem Microsoft Entra-Bereitstellungsdienst können Sie anhand der Zuweisung zur Anwendung oder aufgrund von Attributen für Benutzer*innen festlegen, wer in die Bereitstellung einbezogen werden soll. Wenn Sie sich dafür entscheiden, anhand der Zuweisung festzulegen, wer für Ihre App bereitgestellt werden soll, können Sie der Anwendung mithilfe der folgenden Schritte Benutzer*innen zuweisen. Wenn Sie allein anhand der Attribute der Benutzer*innen oder der Gruppe auswählen möchten, wer bereitgestellt wird, können Sie einen hier beschriebenen Bereichsfilter verwenden.

  • Beginnen Sie klein. Testen Sie die Bereitstellung mit einer kleinen Gruppe von Benutzer*innen, bevor Sie sie für alle freigeben. Wenn der Bereich für die Bereitstellung auf zugewiesene Benutzer festgelegt ist, können Sie dies steuern, indem Sie der App einen oder zwei Benutzer zuweisen. Wenn der Bereich auf alle Benutzer*innen festgelegt ist, können Sie einen attributbasierten Bereichsfilter angeben.

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

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung für uniFLOW Online

Dieser Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern in TestApp basierend auf Benutzer- und/oder Gruppenzuweisungen in Microsoft Entra ID.

Gehen Sie wie folgt vor, um die automatische Benutzerbereitstellung für uniFLOW Online in Microsoft Entra ID zu konfigurieren:

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen

    Screenshot: Seite für Unternehmensanwendungen.

  3. Wählen Sie in der App-Liste uniFLOW Onlineaus.

    Screenshot des Links

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot: Registerkarte „Bereitstellung“.

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

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

  6. Geben Sie im Abschnitt Administratoranmeldeinformationen die Werte für die Mandanten-URL und das geheime Token für uniFLOW Online ein. Klicken Sie auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung zu uniFLOW Online herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr uniFLOW Online-Konto über Administratorberechtigungen verfügt, und versuchen Sie es erneut.

    Screenshot: Token.

  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 im Falle eines Fehlers.

    Screenshot der Benachrichtigungs-E-Mail.

  8. Wählen Sie Speichern aus.

  9. Wählen Sie im Abschnitt Zuordnungen die Option Synchronize Microsoft Entra-Benutzer mit uniFLOW Online synchronisieren aus.

  10. Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit uniFLOW Online synchronisiert werden. Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Benutzerkonten in uniFLOW Online für Updatevorgänge verwendet werden. Wenn Sie sich dafür entscheiden, das übereinstimmende Zielattribut zu ändern, müssen Sie sicherstellen, dass die uniFLOW Online-API das Filtern von Benutzer*innen anhand dieses Attributs unterstützt. Wählen Sie die Schaltfläche Speichern aus, um änderungen zu übernehmen.

    Attribute Typ Unterstützung für das Filtern Erforderlich von uniFLOW Online
    Nutzername Zeichenfolge
    externalId Zeichenfolge
    emails[type eq "work"].value Zeichenfolge
    aktiv Boolesch
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Zeichenfolge
    displayName Zeichenfolge
    title Zeichenfolge
    addresses[type eq "work"].streetAddress Zeichenfolge
    title Zeichenfolge
    phoneNumbers[type eq "work"].value Zeichenfolge
    urn:ietf:params:scim:schemas:extension:uniFLOWOnline:2.0:User:cardNumber Zeichenfolge
    urn:ietf:params:scim:schemas:extension:uniFLOWOnline:2.0:User:cardRegistrationCode Zeichenfolge
    urn:ietf:params:scim:schemas:extension:uniFLOWOnline:2.0:User:localUsername Zeichenfolge
    urn:ietf:params:scim:schemas:extension:uniFLOWOnline:2.0:User:pin Zeichenfolge
  11. Wenn Sie Bereichsfilter konfigurieren möchten, lesen Sie die Anweisungen unter Attributbasierte Anwendungsbereitstellung mit Bereichsfiltern.

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

    Screenshot: Bereitstellungsstatus aktiviert.

  13. Legen Sie ein*e Benutzer*in fest, die bzw. den Sie in uniFLOW Online bereitstellen möchten, indem Sie im Abschnitt Einstellungen unter Bereich die gewünschten Werte auswählen.

    Screenshot: Bereitstellungsbereich.

  14. Wenn Sie fertig sind, klicken Sie auf Speichern.

    Screenshot: Speichern der Bereitstellungskonfiguration.

Mit diesem Vorgang wird der erste Synchronisierungszyklus für alle Benutzer*innen gestartet, die im Abschnitt Einstellungen unter Bereich definiert wurden. 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:

  • Verwenden Sie die Bereitstellungsprotokolle, um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt wurden.
  • Anhand der Fortschrittsleiste können Sie den Status des Bereitstellungszyklus überprüfen und den Fortschritt der Bereitstellung verfolgen
  • Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zu den verschiedenen Quarantänestatus finden Sie hier.

Weitere Ressourcen

Nächste Schritte