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

In diesem Artikel werden die Schritte beschrieben, die Sie in RingCentral 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 und Gruppen in RingCentral bereit bzw. hebt die Bereitstellung auf. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert, und häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -abbereitstellung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

Voraussetzungen

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

• Ein Microsoft Entra-Mandant
• Ein Benutzerkonto in der Microsoft Entra-ID mit der Berechtigung zum Konfigurieren der Bereitstellung (z. B. Anwendungsadministrator, Cloudanwendungsadministrator oder Anwendungsbesitzer).
• Ein RingCentral-Mandant
• Ein Benutzerkonto in RingCentral mit Administratorrechten

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 RingCentral zugeordnet werden sollen.

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

Ein RingCentral-Administratorkonto muss im Abschnitt "Administratoranmeldeinformationen" in Schritt 5 autorisiert werden.

Legen Sie im RingCentral-Verwaltungsportal unter Kontoeinstellungen –> Verzeichnisintegrationen die Einstellung des Verzeichnisanbieters auf SCIM-Image fest.

Schritt 3: Hinzufügen von RingCentral aus dem Microsoft Entra Anwendungskatalog

Fügen Sie RingCentral aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in RingCentral zu beginnen. Wenn Sie RingCentral zuvor für das einmalige Anmelden (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 Aufgabe für Ihre App bereitgestellt wird, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. 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 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 RingCentral

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 RingCentral 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

   

3. Wählen Sie in der Anwendungsliste "RingCentral" aus.

   

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

   

5. Setze + Neue Konfiguration.

   

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

   

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 den Bleistift aus, um die Eigenschaften zu bearbeiten. Aktivieren Sie Benachrichtigungs-E-Mails, und stellen Sie eine E-Mail bereit, um Quarantäne-E-Mails zu empfangen. Aktivieren Sie die Verhinderung versehentlicher Löschungen. Um die Änderungen zu speichern, wählen Sie Übernehmen aus.

   

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

11. Überprüfen Sie die Benutzerattribute, die von Microsoft Entra ID mit RingCentral synchronisiert werden, im Abschnitt "Attributzuordnung" . Die als übereinstimmende Eigenschaften ausgewählten Attribute werden für den Abgleich der Benutzerkonten in RingCentral für Updatevorgänge verwendet. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die RingCentral-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
    Nutzername	Schnur
    externalId	Schnur
    active	Boolean
    title	Schnur
    emails[type eq "work"].value	Schnur
    addresses[type eq "work"].country	Schnur
    addresses[type eq "work"].region	Schnur
    addresses[type eq "work"].locality	Schnur
    addresses[type eq "work"].postalCode	Schnur
    addresses[type eq "work"].streetAddress	Schnur
    name.givenName	Schnur
    name.familyName	Schnur
    phoneNumbers[type eq "mobile"].value	Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	Schnur

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

13. 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.

14. 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 die Fortschrittsanzeige, um den Status des Bereitstellungszyklus zu sehen und wie nahe dieser 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 finden Sie im Artikel Anwendungsbereitstellung im Quarantänestatus.

Änderungsprotokoll

• 10.9.2020: Unterstützung für die Attribute „displayName“ und „manager“ wurde entfernt.
• 15.03.2021: Aktualisierung der Autorisierungsmethode von permanentem Bearer-Token zum OAuth-Code-Grant-Flow.
• 28.10.2021: Standardzuordnung zu mail-> emails[type eq “work”].value aktualisiert.
• 28.10.2021: Die Ratenbegrenzung wurde für Lesevorgänge auf 300/Minute und für Schreibvorgänge auf 1.000/Minute aktualisiert.

Weitere Ressourcen

• Verwalten der Bereitstellung von Benutzerkonten für Enterprise-Apps
• Was ist Anwendungszugriff und Single Sign-On mit Microsoft Entra ID?

Verwandte Inhalte

• Erfahren Sie, wie Sie Protokolle überprüfen und Berichte zu Bereitstellungsaktivitäten abrufen.