Tutorial: Integrieren von Miro mit Microsoft Entra ID

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie Miro in Microsoft Entra ID integrieren. Eine weitere Version dieses Tutorials finden Sie unter help.miro.com. Die Integration von Miro in Microsoft Entra ID ermöglicht Folgendes:

  • Steuern Sie in Microsoft Entra ID, wer Zugriff auf Miro hat.
  • Ermöglichen Sie es Ihren Benutzer*innen, sich mit ihren Microsoft Entra-Konten automatisch bei Miro anzumelden.
  • Verwalten Sie Ihre Konten an einem zentralen Ort.

Voraussetzungen

Für die ersten Schritte benötigen Sie Folgendes:

  • Ein Microsoft Entra-Abonnement. Falls Sie über kein Abonnement verfügen, können Sie ein kostenloses Azure-Konto verwenden.
  • Ein Miro-Abonnement, für das das einmalige Anmelden (Single Sign-On, SSO) aktiviert ist.

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.

Um die Integration von Miro in Microsoft Entra ID zu konfigurieren, müssen Sie Miro aus dem Katalog Ihrer Liste mit verwalteten SaaS-Apps hinzufügen.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
  3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Miro in das Suchfeld ein.
  4. 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.

Alternativ können Sie auch den Enterprise App Configuration Wizard verwenden. Mit diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer/Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra für Miro

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra (SSO) mit Miro mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in Miro eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit Miro die folgenden Schritte aus:

  1. Konfigurieren des einmaligen Anmeldens von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
    1. Erstellen Sie einen Microsoft Entra-Testbenutzer, um Microsoft Entra-SSO mit dem Testbenutzer B. Simon zu testen.
    2. Zuweisen der Microsoft Entra-Testbenutzerin, um B.Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
  2. Konfigurieren des einmaligen Anmeldens für Miro , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen eines Miro-Testbenutzers, um in Miro ein Pendant von B. Simon zu erhalten, das mit der Benutzerdarstellung in Microsoft Entra verknüpft ist.
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Gehen Sie wie folgt vor, um das einmalige Anmelden von Microsoft Entra zu aktivieren.

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

  2. Navigieren Sie zur Anwendungsintegrationsseite Identität>Anwendungen>Unternehmensanwendungen>Miro, Seite „Anwendungsintegration“, suchen Sie den Abschnitt Verwalten, und wählen Sie Einmaliges Anmelden aus.

  3. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

  4. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

    Edit Basic SAML Configuration

  5. Führen Sie im Abschnitt Grundlegende SAML-Konfiguration den folgenden Schritt aus:

    a. Geben Sie im Textfeld Bezeichner eine der folgenden URLs bzw. eins der folgenden Muster ein:

    Identifier
    https://miro.com/
    https://<SUBDOMAIN>.miro.com/<ORG_ID>/<SAMLSETTINGS_ID>
    https://miro.com/<ORG_ID>/<SAMLSETTINGS_ID>
    https://<SUBDOMAIN>.miro.com/<ORG_ID>

    b. Geben Sie im Textfeld Antwort-URL eine der folgenden URLs bzw. eins der folgenden Muster ein:

    Antwort-URL
    https://miro.com/sso/saml
    https://<SUBDOMAIN>.miro.com/sso/saml/<ORG_ID>
    https://miro.com/sso/saml/<ORG_ID>/<SAMLSETTINGS_ID>
    https://<SUBDOMAIN>.miro.com/sso/saml/<ORG_ID>/<SAMLSETTINGS_ID>

  6. Wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten, führen Sie die folgenden Schritte aus:

    Geben Sie im Textfeld Anmelde-URL die URL ein: https://miro.com/sso/login/.

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Aktualisieren Sie diese Werte mit dem eigentlichen Bezeichner und der Antwort-URL. Diese Werte erhalten Sie vom Miro-Supportteam. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration im Microsoft Entra Admin Center ansehen.

  7. Suchen Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat den Eintrag Zertifikat (Base64) . Klicken Sie auf Herunterladen, um das Zertifikat herunterzuladen, und speichern Sie es auf Ihrem Computer. Sie benötigen diese Angabe zum Konfigurieren von SSO auf der Seite von Miro.

    Screenshot shows the Certificate download link.

  8. Kopieren Sie im Abschnitt Miro einrichten die Anmelde-URL. Sie benötigen diese Angabe zum Konfigurieren von SSO auf der Seite von Miro.

    Screenshot shows to copy Login URL.

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B. Simon.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
  2. Browsen Sie zu Identität>Benutzer>Alle Benutzer.
  3. Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
  4. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
    1. Geben Sie im Feld Anzeigename den Namen B.Simon ein.
    2. Geben Sie im Feld Benutzerprinzipalname ein username@companydomain.extension. Beispiel: B.Simon@contoso.com.
    3. Aktivieren Sie das Kontrollkästchen Kennwort anzeigen, und notieren Sie sich den Wert aus dem Feld Kennwort.
    4. Klicken Sie auf Überprüfen + erstellen.
  5. Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie B.Simon die Verwendung des einmaligen Anmeldens, indem Sie dieser Person Zugriff auf Miro gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Miro.
  3. Wählen Sie auf der Übersichtsseite der App Benutzer und Gruppen aus.
  4. Wählen Sie Benutzer/Gruppe hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
    1. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann unten auf dem Bildschirm auf die Schaltfläche Auswählen.
    2. Wenn den Benutzern eine Rolle zugewiesen werden soll, können Sie sie im Dropdownmenü Rolle auswählen auswählen. Wurde für diese App keine Rolle eingerichtet, ist die Rolle „Standardzugriff“ ausgewählt.
    3. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.
  • Navigieren Sie alternativ zu den Eigenschaften der Anwendung, und deaktivieren Sie Benutzerzuweisung erforderlichDisable assignment requirement.

Konfigurieren des einmaligen Anmeldens für Miro

Verwenden Sie zum Konfigurieren von SSO auf der Seite von Miro das zuvor heruntergeladene Zertifikat und die zuvor kopierte Anmelde-URL. Navigieren Sie in den Miro-Kontoeinstellungen zum Abschnitt Security (Sicherheit), und aktivieren Sie Enable SSO/SAML (SSO/SAML aktivieren).

  1. Fügen Sie die Anmelde-URL in das Feld SAML-Anmelde-URL ein.

  2. Öffnen Sie die Zertifikatdatei mit einem Text-Editor, und kopieren Sie die Zertifikatsequenz. Fügen Sie die Sequenz in das Feld Key x509 Certificate (Schlüssel x509-Zertifikat) ein. Miro settings

  3. Geben Sie im Feld Domains (Domänen) Ihre Domänenadresse ein, klicken Sie auf Add (Hinzufügen), und führen Sie das Überprüfungsverfahren aus. Wiederholen Sie diesen Vorgang für Ihre anderen Domänenadressen, sofern vorhanden. Das Miro-SSO-Feature funktioniert für Endbenutzer, deren Domänen in der Liste aufgeführt werden. Domain

  4. Entscheiden Sie, ob Sie Just-in-Time-Bereitstellung verwenden möchten (pullen Sie Ihre Benutzer während der Registrierung in Miro in Ihr Abonnement), und klicken Sie auf Save (Speichern), um die SSO-Konfiguration auf der Miro-Seite abzuschließen. Just in Time Provisioning

Erstellen eines Miro-Testbenutzers

In diesem Abschnitt wird in Miro ein Benutzer namens B. Simon erstellt. Miro unterstützt Just-In-Time-Benutzerbereitstellung (standardmäßig aktiviert). Für Sie steht in diesem Abschnitt kein Aktionselement zur Verfügung. Ist ein Benutzer noch nicht in Miro vorhanden, wird nach der Authentifizierung ein neuer Benutzer erstellt.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen mithilfe der Testbenutzerin B. Simon.

SP-initiiert:

  • Navigieren Sie direkt zur Anmelde-URL für Miro, und initiieren Sie den Anmeldeflow.

IDP-initiiert:

  • Klicken Sie im Azure-Portal auf Diese Anwendung testen, und melden Sie sich als B. Simon an. Sie sollten automatisch bei dem Miro-Abonnement angemeldet werden, für das Sie SSO eingerichtet haben.

Sie können auch den Microsoft-Bereich „Meine Apps“ verwenden, um die Anwendung in einem beliebigen Modus zu testen. Beim Klicken auf die Kachel „Miro“ in „Meine Apps“ geschieht Folgendes: Wenn Sie die Anwendung im SP-Modus konfiguriert haben, werden Sie zum Initiieren des Anmeldeflows zur Anmeldeseite der Anwendung weitergeleitet. Wenn Sie die Anwendung im IDP-Modus konfiguriert haben, sollten Sie automatisch bei der Miro-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.