Konfigurieren von Kolloquial für die automatische Benutzerbereitstellung mit Microsoft Entra-ID

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in der Colloquial- als auch in der Microsoft Entra-ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Wenn konfiguriert, stellt die Microsoft Entra ID Benutzer automatisch bereit und entzieht ihnen den Zugang zu Colloquial mit dem Microsoft Entra-Bereitstellungsdienst. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert und die 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 Sie Benutzer in Colloquial.
  • Entfernen Sie Benutzer in Colloquial, wenn sie keinen Zugriff mehr benötigen.
  • Benutzerattribute zwischen Microsoft Entra ID und Colloquial synchronisieren.
  • Einmaliges Anmelden bei Colloquial (empfohlen).

Voraussetzungen

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

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

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

Wenden Sie sich an den Colloquial-Support, um Colloquial für die Bereitstellung mit Microsoft Entra ID zu konfigurieren.

Fügen Sie kolloquial aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit der Verwaltung der Bereitstellung in Colloquial zu beginnen. Wenn Sie zuvor das Colloquial 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. Weitere Informationen zum Hinzufügen einer Anwendung aus dem Katalog finden Sie 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 festlegen, wer basierend auf der Zuweisung für Ihre App bereitgestellt werden soll, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie festlegen möchten, wer basierend ausschließlich auf den Attributen des Benutzers oder der Gruppe versorgt 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 Bereichsdefinitionsfilter angeben.

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

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung für Colloquial

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

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

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

  2. Navigieren Sie zu Entra ID>Enterprise-Apps

    Screenshot des Blatts

  3. Wählen Sie in der Liste "Anwendungen" die Option "Kolloquial" aus.

    Screenshot des Colloquial-Links in der Liste

  4. Wählen Sie die Registerkarte "Bereitstellung" aus .

    Screenshot der Registerkarte

  5. Wählen Sie + Neue Konfiguration aus.

    Screenshot der Registerkarte

  6. Geben Sie im Feld "Mandanten-URL " Ihre kolloquiale Mandanten-URL und das geheime Token ein. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Colloquial herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr Kolloquialkonto über die erforderlichen Administratorberechtigungen verfügt, und versuchen Sie es erneut.

    Screenshot der Bereitstellungstestverbindung.

  7. Wählen Sie "Erstellen" aus, um Ihre Konfiguration zu erstellen.

  8. Wählen Sie auf der Seite "Übersicht" die Option "Eigenschaften" aus.

  9. Wählen Sie das Symbol "Bearbeiten" aus, um die Eigenschaften zu bearbeiten. Aktivieren Sie Benachrichtigungs-E-Mails, und stellen Sie eine E-Mail bereit, um Quarantänebenachrichtigungen zu erhalten. Aktivieren Sie die Verhinderung versehentlicher Löschungen. Um die Änderungen zu speichern, wählen Sie Übernehmen aus.

  10. Geben Sie im Feld " Benachrichtigungs-E-Mail " die E-Mail-Adresse einer Person ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie das Kontrollkästchen " E-Mail-Benachrichtigung senden", wenn ein Fehler auftritt .

    Screenshot der Bereitstellungseigenschaften.

  11. Wählen Sie im linken Bereich die Attributzuordnung aus, und wählen Sie Benutzer aus.

  12. Überprüfen Sie die Benutzerattribute, die aus der Microsoft Entra-ID mit Colloquial synchronisiert werden, im Abschnitt "Attributzuordnung" . Die als Übereinstimmenden Eigenschaften ausgewählten Attribute werden verwendet, um mit den Benutzerkonten in Colloquial für Aktualisierungsvorgänge übereinzugleichen. Wenn Sie das übereinstimmende Zielattribut ändern möchten, müssen Sie sicherstellen, dass die Colloquial-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

    Merkmal Typ Unterstützung für das Filtern Erforderlich von Kolloquial
    Nutzername Schnur
    aktiv Boolescher Typ (Boolean)
    E-Mails[Typ eq "Arbeit"].Wert Schnur
    bevorzugteSprache Schnur
    Name.Vorname Schnur
    Name.Familienname Schnur
    externalId Schnur
    Gebietsschema Schnur
    Zeitzone Schnur
  13. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den Anweisungen im Artikel "Bereichsfilter".

  14. Verwenden Sie die On-Demand-Bereitstellung , um die Synchronisierung mit einer kleinen Anzahl von Benutzern zu überprüfen, bevor Sie die Bereitstellung in Ihrer Organisation umfassender durchführen.

  15. Wenn Sie bereit für die Bereitstellung sind, wählen Sie auf der Seite "Übersicht" die Option "Bereitstellung starten" aus.

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 zu sehen und wie nah er an der Fertigstellung ist.
  3. Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zu Quarantänezuständen finden Sie im Artikel über den Anwendungsbereitstellungs-Quarantänestatus.

Weitere Ressourcen