Einrichtung von Glean für Miro (Admin-Leitfaden)

Personen: Unternehmens-Admins
Pläne: Business, Enterprise
Plattformen: Desktop, Browser

Als Unternehmens-Admin kannst du die Glean-Integration für deine Organisation installieren und konfigurieren. So kannst du die KI-gestützten Suchfunktionen von Glean direkt in Miro einbinden, damit dein Team Informationen aus über 100 verschiedenen Quellsystemen finden und so die Produktivität steigern kann.

Voraussetzungen

1. Du bist ein Miro Org Admin und ein Glean Admin.
2. Registriere in Glean eine OAuth-Client-ID. Lies die Glean-Dokumentation für weitere Details.
3. Aktiviere die nutzerbezogene Datenschutzeinstellung Chatverlauf bis zu 30 Tage speichern erlauben.

Installiere die Glean-App

Um zu beginnen, installiere die Glean-App aus dem Miro Marketplace für die relevanten Teams in deiner Organisation.

1. Gehe zu deinen Unternehmenseinstellungen und klicke auf Apps & Integrationen.
2. Klicke unter dem Apps-Tab auf Apps hinzufügen, um den Marketplace zu öffnen.
3. Suche nach „Glean“. Du kannst es auch finden, indem du seine Client-ID in die Suchleiste eingibst: 1202342442818548396.
4. Wähle im App-Profil aus, wo die App hinzugefügt werden soll: entweder für Alle Teams oder wähle Bestimmte Teams....
5. Überprüfe die Berechtigungsseite. Die Glean-App wird von Miro entwickelt und verwaltet und erfordert keine spezifischen Berechtigungen.
6. Wähle Hinzufügen aus, um die Installation abzuschließen.

Single Sign-On (SSO) Einrichtung (Okta)

Falls deine Organisation Okta als Single Sign-on (SSO) Anbieter nutzt, musst du eine Okta OpenID Connect (OIDC) Web-App erstellen, bevor du mit den nächsten Abschnitten fortfährst.

1. Erstelle eine neue Okta-App mithilfe der Schritte, die in der Dokumentation hier erwähnt werden.
   1. Wähle OIDC - OpenID Connect als Anmeldemethode aus.
   2. Wähle Web-App als Anwendungstyp aus.
   3. Stelle sicher, dass das Refresh Token in den Einstellungen für Grant type > Core grants aktiviert ist.
   4. Füge https://integrations.miro.com/api/external-auth/oauth2/callback als Anmelde-Redirect-URIs hinzu.
   5. Wähle Speichern aus.
2. Kopiere die ClientId und das Client Secret aus dem Abschnitt der Client-Anmeldedaten. Diese werden in den nächsten Abschnitten benötigt, um die Integrationseinstellung abzuschließen.

Single Sign-on konfigurieren

Führe diese Schritte aus, um die App zu konfigurieren:

1. Gehe auf der Apps & Integrations Seite zu Apps verwalten.
2. Finde „Glean“ in deiner Liste installierter Apps und klicke auf dessen Einstellungen. Wenn du die App nicht siehst, suche nach ihr anhand der Client-ID (1202342442818548396) und genehmige sie zuerst.
3. Wähle in den Konfigurationseinstellungen den SSO-Anbieter aus.
   1. Okta
   2. Azure
   3. Google
4. Gib die erforderlichen SSO-Details ein.
   1. Okta: Glean-Basis-URL, Okta-App-Details (Auth-Server-URL, Access Token URL, Client ID, Client Secret).
   2. Azure: Glean-Basis-URL.
   3. Google: Glean-Basis-URL.
5. Klicke auf Speichern, um die Konfiguration anzuwenden.

✏️ Wenn du Azure verwendest, stelle sicher, dass dein Microsoft Entra-Admin in der Microsoft Entra-Admin-Konsole "Zustimmung im Namen deiner Organisation" für die Glean-App ausgewählt hat, um es den Nutzern zu ermöglichen, sich korrekt zu authentifizieren.

Konfiguriere die Glean-Admin-Konsole

Bevor du Glean in Miro verwenden kannst, musst du den Zugang basierend auf OAuth-Token in deiner Glean-Admin-Konsole konfigurieren.

1. Öffne deine Glean Admin-Konsole und gehe zu Einstellungen > Drittanbieter-Zugriff (OAuth).
2. Aktiviere im Abschnitt IDP-Konfiguriertes OAuth die Option IDP OAuth für API-Zugriff aktivieren.
3. Klicke auf Einstellungen verwalten und wähle deinen SSO-Anbieter aus.
4. Gib die Anbieterdetails basierend auf deinem SSO-Anbieter ein.
   • Okta
     • Autorisierungsserver-URL: https://<yourOktaDomain>/oauth2/v1/authorize
     • Zugelassene Client-ID(s): Client-ID der in dem vorherigen Abschnitt erstellten Okta-App.
     • Die restlichen Formularfelder können leer bleiben.
   • Azure
     • Aussteller-Subdomain: https://login.microsoftonline.com/<tenant-id>/v2.0
     • Zulässige Client-ID(s): a49fdb25-3b5f-4d3b-bedf-6da7be2b4bf4
   • GSuite
     • Zulässige Client-ID(s): 1062019541050-pf2ndc9f3o4lrmkupj3cj0fep5hkecns.apps.googleusercontent.com
5. Wähle Speichern, um die Einstellungen zu übernehmen.

⏰ Hinweis: Es kann bis zu 30 Minuten dauern, bis die Änderungen in der Glean-Admin-Konsole wirksam werden.

Die Glean-App verwenden

Sobald du die App installiert und konfiguriert hast, können Nutzer in den vorgesehenen Teams damit beginnen, sie zu verwenden. Beim ersten Öffnen der Glean-App in Miro wird der Nutzer aufgefordert, sich zu authentifizieren.

1. Öffne ein Miro-Board und klicke auf das Glean-Symbol in der Symbolleiste, um das seitliche Feld zu öffnen.
2. Klicke auf Glean verbinden, um die Autorisierung zu starten.
3. Ein Dialogfeld für die Single Sign-on Autorisierung erscheint.
4. Nach erfolgreicher Authentifizierung erscheint die Glean-Benutzeroberfläche einsatzbereit.

Sicherheit

Weitere Informationen zu Daten und Sicherheit findest du in diesem Sicherheitsdokument.