Tutorial: Konfigurieren von Miro für die automatische Benutzerbereitstellung
In diesem Tutorial werden die Schritte erläutert, die in Miro und Microsoft Entra ID ausgeführt werden müssen, um Microsoft Entra ID für die automatische Bereitstellung und die Aufhebung der Bereitstellung von Benutzer*innen und/oder Gruppen in Miro zu konfigurieren.
Hinweis
In diesem Tutorial wird ein Connector beschrieben, der auf dem Bereitstellungsdienst für Benutzer*innen für Microsoft Entra-Benutzer*innen basiert. 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.
Voraussetzungen
Das diesem Tutorial zu Grunde liegende Szenario setzt voraus, dass Sie bereits über die folgenden Voraussetzungen verfügen:
- Ein Microsoft Entra-Mandant
- Einen Miro-Mandanten
- Ein Benutzerkonto in Miro mit Administratorberechtigungen.
Zuweisen von Benutzern zu Miro
Microsoft Entra ID ermittelt anhand von Zuweisungen, welche Benutzer*innen Zugriff auf ausgewählte Apps erhalten sollen. Im Kontext der automatischen Bereitstellung von Benutzer*innen werden nur die Benutzer*innen und/oder Gruppen synchronisiert, die einer Anwendung in Microsoft Entra ID zugewiesen wurden.
Vor dem Konfigurieren und Aktivieren der automatischen Bereitstellung von Benutzen müssen Sie entscheiden, welche Benutzer und/oder Gruppen in Microsoft Entra ID Zugriff auf Miro benötigen. Anschließend können Sie diese Benutzer und/oder Gruppen Miro zuweisen, indem Sie die folgenden Anweisungen befolgen:
Wichtige Tipps zum Zuweisen von Benutzern zu Miro
Es wird empfohlen, Miro einzelne Microsoft Entra-Benutzen zuzuweisen, um die Konfiguration der automatischen Bereitstellung von Benutzern zu testen. Später können weitere Benutzer und/oder Gruppen zugewiesen werden.
Beim Zuweisen eines Benutzers zu Miro müssen Sie eine beliebige gültige anwendungsspezifische Rolle (sofern verfügbar) im Dialogfeld für die Zuweisung auswählen. Benutzer mit der Rolle Standardzugriff werden von der Bereitstellung ausgeschlossen.
Einrichten von Miro für die Bereitstellung
Um das benötigte geheime Token abzurufen, wenden Sie sich an das Supportteam von Miro. Dieser Wert wird auf der Registerkarte „Provisioning“ Ihrer Miro-Anwendung in das Feld „Secret Token“ eingegeben.
Hinzufügen von Miro aus dem Katalog
Bevor Sie Miro für die automatische Benutzerbereitstellung mit Microsoft Entra ID konfigurieren, müssen Sie Miro aus dem Microsoft Entra-Anwendungskatalog der Liste der verwalteten SaaS-Anwendungen hinzufügen.
Führen Sie zum Hinzufügen von Miro aus dem Microsoft Entra-Anwendungskatalog die folgenden Schritte aus:
- Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
- Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
- Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Miro in das Suchfeld ein.
- Wählen Sie im Ergebnisbereich Miro aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird.
Konfigurieren der automatischen Benutzerbereitstellung für Miro
In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern*innen bzw. Gruppen in Miro auf der Grundlage von Benutzer- oder Gruppenzuweisungen in Microsoft Entra ID erläutert.
Tipp
Sie können auch das SAML-basierte einmalige Anmelden für Miro aktivieren. Befolgen Sie hierzu die Anweisungen im Miro-Tutorial für einmaliges Anmelden. Einmaliges Anmelden kann unabhängig von der automatischen Benutzerbereitstellung konfiguriert werden, obwohl diese beiden Features einander ergänzen.
Hinweis
Weitere Informationen zum SCIM-Endpunkt von Miro finden Sie hier.
So konfigurieren Sie die automatische Benutzerbereitstellung für Miro in Microsoft Entra ID
Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen.
Wählen Sie in der Anwendungsliste die Option Miroaus.
Wählen Sie die Registerkarte Bereitstellung.
Legen Sie den Bereitstellungsmodus auf Automatisch fest.
Geben Sie im Abschnitt Administratoranmeldeinformationen im Feld Mandanten-URL die Zeichenfolge
https://miro.com/api/v1/scimein. Geben Sie den Wert des SCIM-Authentifizierungstokens ein, den Sie zuvor unter geheimes Token abgerufen haben. Klicken Sie auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Miro herstellen kann. Wenn die Verbindung nicht möglich ist, sollten Sie sicherstellen, dass Ihr Miro-Konto über Administratorberechtigungen verfügt, und den Vorgang wiederholen.
Geben Sie im Feld Benachrichtigungs-E-Mail die E-Mail-Adresse einer Person oder einer Gruppe ein, die Benachrichtigungen zu Bereitstellungsfehlern erhalten soll, und aktivieren Sie das Kontrollkästchen Bei Fehler E-Mail-Benachrichtigung senden.
Klicken Sie auf Speichern.
Wählen Sie im Abschnitt Zuordnungen die Option Microsoft Entra-Benutzer mit Miro synchronisieren aus.
Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit Miro synchronisiert werden. Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Benutzerkonten in Miro für Updatevorgänge verwendet werden. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.
Wählen Sie im Abschnitt Zuordnungen die Option Microsoft Entra-Gruppen mit Miro synchronisieren aus.
Überprüfen Sie im Abschnitt Attributzuordnung die Gruppenattribute, die von Microsoft Entra ID mit Miro synchronisiert werden. Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Gruppen in Miro für Updatevorgänge verwendet werden. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen. Deaktivieren Sie Erstellen und Löschen unter Zielobjektaktionen da die Miro SCIM-API das Erstellen und Löschen von Gruppen nicht unterstützt.
Wenn Sie Bereichsfilter konfigurieren möchten, lesen Sie die Anweisungen unter Attributbasierte Anwendungsbereitstellung mit Bereichsfiltern.
Ändern Sie im Abschnitt Einstellungen den Bereitstellungsstatus in Ein, um den Microsoft Entra-Bereitstellungsdienst für Miro zu aktivieren.
Definieren Sie die Benutzer und/oder Gruppen, die Sie für Miro bereitstellen möchten, indem Sie die gewünschten Werte in Bereich im Abschnitt Einstellungen auswählen.
Wenn Sie fertig sind, klicken Sie auf Speichern.
Dadurch wird die Erstsynchronisierung aller Benutzer und/oder Gruppen gestartet, die im Abschnitt Einstellungen unter Bereich definiert sind. Die Erstsynchronisierung dauert länger als nachfolgende Synchronisierungen, die ungefähr alle 40 Minuten erfolgen, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird. Im Abschnitt Synchronisierungsdetails können Sie den Fortschritt überwachen und Links zu Berichten zur Bereitstellungsaktivität aufrufen. Darin sind alle Aktionen aufgeführt, die vom Microsoft Entra-Bereitstellungsdienst in Miro ausgeführt werden.
Weitere Informationen zum Lesen der Microsoft Entra-Bereitstellungsprotokolle finden Sie unter Meldung zur automatischen Bereitstellung von Konten für Benutzer*innen.
Connector-Einschränkungen
- Der SCIM-Endpunkt von Miro ermöglicht keine Erstellen- und Löschen-Vorgänge für Gruppen. Er unterstützt nur den Aktualisieren-Vorgang für Gruppen.
Tipps zur Problembehandlung
Wenn Fehler bei der Gruppenerstellung auftreten, müssen Sie sie deaktivieren, indem Sie das Erstellen und Löschen unter Zielobjektaktionen deaktivieren, da die Miro SCIM-API das Erstellen und Löschen von Gruppen nicht unterstützt.
Zusätzliche Ressourcen
- Verwalten der Benutzerkontobereitstellung für Unternehmens-Apps
- Was ist Anwendungszugriff und einmaliges Anmelden mit Microsoft Entra ID?