Freigeben über


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

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in Zoho One als auch in der Microsoft Entra-ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Wenn konfiguriert, provisioniert und de-provisioniert Microsoft Entra ID Benutzer und Gruppen automatisch für Zoho One mithilfe des Microsoft Entra-Bereitstellungsdienstes. 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 Sie Benutzer in Zoho One.
  • Entfernen Sie Benutzer in Zoho One, wenn sie keinen Zugriff mehr benötigen.
  • Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Zoho One.
  • Bereitstellen von Gruppen und Gruppenmitgliedschaften in Zoho One
  • Einmaliges Anmelden bei Zoho One (empfohlen).

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. Identifizieren Sie, wer im Umfang der Bereitstellung enthalten ist.
  3. Bestimmen Sie, welche Daten zwischen Microsoft Entra ID und Zoho One zugeordnet werden sollen.

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

Wenden Sie sich an den Zoho One-Support, um Zoho One für die Unterstützung der Bereitstellung mit Microsoft Entra ID zu konfigurieren.

Fügen Sie Zoho One aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in Zoho One zu beginnen. Wenn Sie Zoho One bereits für SSO eingerichtet haben, können Sie diese 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 Ihrer App basierend auf der Zuweisung zugewiesen wird, können Sie die Schritte zur Zuweisung von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie festlegen möchten, wer ausschließlich auf der Grundlage von Attributen des Benutzers oder der Gruppe 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 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 in Zoho One

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

So konfigurieren Sie die automatische Benutzerbereitstellung für Zoho One 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 Fensters

  3. Wählen Sie in der Anwendungsliste Zoho One aus.

    Screenshot des Zoho One-Links in der Liste

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

    Screenshot der Registerkarte

  5. Legen Sie den Bereitstellungsmodus auf "Automatisch" fest.

    Screenshot der Registerkarte

  6. Geben Sie im Abschnitt "Administratoranmeldeinformationen " Ihre Zoho One-Mandanten-URL, den Autorisierungsendpunkt und den Tokenendpunkt ein. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Zoho One herstellen kann. Wenn die Verbindung nicht möglich ist, sollten Sie sicherstellen, dass Ihr Zoho One-Konto über Administratorberechtigungen verfügt, und den Vorgang wiederholen.

    Screenshot des Tokens.

    Hinweis

    • Die Mandanten-URL, der Autorisierungsendpunkt und der Tokenendpunkt von Zoho One sind alle regionsspezifisch. Achten Sie also bei der Eingabe darauf.
    • Der Autorisierungsendpunkt sollte beim Eingeben des Werts immer angefügt ?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorize werden (wenn die Region z. B. "USA" ist, sollte der zu eingebende Autorisierungsendpunkt eingegeben werden https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorize)
  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", wenn ein Fehler auftritt .

    Screenshot der Benachrichtigungs-E-Mail.

  8. Wählen Sie "Speichern" aus.

  9. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Benutzer mit Zoho One synchronisieren" aus.

  10. Überprüfen Sie die Benutzerattribute, die aus der Microsoft Entra-ID mit Zoho One synchronisiert werden, im Abschnitt "Attributzuordnung" . Die Attribute, die als Matching-Eigenschaften ausgewählt wurden, werden verwendet, um mit den Benutzerkonten in Zoho One für Aktualisierungen abzugleichen. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die Zoho One-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 für Zoho One
    Nutzername Schnur
    aktiv Boolescher Typ (Boolean)
    Anzeigename Schnur
    Titel Schnur
    E-Mails[Typ eq "Arbeit"].Wert Schnur
    bevorzugteSprache Schnur
    Name.Vorname Schnur
    Name.Familienname Schnur
    name.formatiert Schnur
    bevorzugteSprache Schnur
    addresses[type eq "Arbeit"].formatted Schnur
    addresses[typ eq "work"].strassenAdresse Schnur
    addresses[type == "work"].locality Schnur
    addresses[type eq "arbeit"].region Schnur
    addressen[typ eq "arbeit"].postleitzahl Schnur
    addresses[type eq "arbeit"].land Schnur
    phoneNumbers[typ ist gleich "mobil"].wert Schnur
    Phone Numbers [Typ entspricht "fax"]. Wert Schnur
    phoneNumbers[type eq "Arbeit"].value Schnur
    externalId Schnur
  11. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Gruppen mit Zoho One synchronisieren" aus.

  12. Überprüfen Sie die Gruppenattribute, die aus Microsoft Entra ID nach Zoho One synchronisiert werden, im Abschnitt Attributzuordnung. Die als Matching-Eigenschaften ausgewählten Attribute werden verwendet, um die Gruppen in Zoho One für Aktualisierungsvorgänge abzugleichen. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

    Merkmal Typ Unterstützung für das Filtern Erforderlich für Zoho One
    Anzeigename Schnur
    Mitglieder Referenz
    externalId Schnur
  13. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

  14. Um den Microsoft Entra-Bereitstellungsdienst für Zoho One zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt "Einstellungen" in "Ein".

    Screenshot des Bereitstellungsstatus, wenn aktiviert.

  15. Definieren Sie die Benutzer und/oder Gruppen, die Sie für Zoho One bereitstellen möchten, indem Sie die gewünschten Werte im Bereich im Abschnitt "Einstellungen" auswählen.

    Screenshot des Bereitstellungsbereichs.

  16. Wenn Sie bereit für die Bereitstellung sind, wählen Sie "Speichern" aus.

    Screenshot des Speicherns der Bereitstellungskonfiguration.

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller im Bereich definierten Benutzer und Gruppen im Abschnitt Einstellungen. 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 die Fortschrittsanzeige, um den Status des Bereitstellungszyklus zu sehen und wie nah dieser 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 zum Quarantänestatus bei der Bereitstellung von Anwendungen finden Sie im Artikel zum Anwendungsbereitstellungs-Quarantänestatus.

Weitere Ressourcen