Configurar Glean para Miro (guía del admin)

Personas: admins de empresa
Planes: Business, Enterprise
Plataformas: Escritorio, navegador

Como admin de empresa, puedes instalar y configurar la integración de Glean para tu organización. Esto lleva las funcionalidades de búsqueda impulsadas por IA directamente a Miro, ayudando a tu equipo a encontrar información en más de 100 sistemas fuente para mejorar la productividad.

Requisitos previos

1. Eres un Admin de Org de Miro y un Admin de Glean.
2. En Glean, registra un ID de Cliente OAuth. Lee la documentación de Glean para más detalles.
3. Habilita la configuración de privacidad a nivel de usuario Permitir que el historial de chat se guarde hasta 30 días.

Instala la app de Glean

Para comenzar, instala la app de Glean desde el Marketplace de Miro para los equipos pertinentes de tu organización.

1. Ve a la configuración de la Empresa y haz clic en Apps e Integraciones.
2. Bajo la pestaña de Apps, haz clic en Agregar apps para abrir el Marketplace.
3. Busca "Glean". También puedes encontrarlo pegando su client ID en la barra de búsqueda: 1202342442818548396.
4. Desde el perfil de la app, selecciona dónde agregar la app: ya sea para Todos los equipos o selecciona Equipos específicos....
5. Revisa la página de permisos. La app Glean es desarrollada y mantenida por Miro y no requiere permisos específicos.
6. Selecciona Añadir para completar la instalación.

Configuración de inicio de sesión único (Okta)

Si tu organización utiliza Okta como su proveedor de inicio de sesión único (SSO), necesitas crear una aplicación web Okta OpenID Connect (OIDC) antes de proceder con las siguientes secciones.

1. Crea una nueva aplicación Okta usando los pasos mencionados en la documentación aquí.
   1. Selecciona OIDC - OpenID Connect como el método de inicio de sesión.
   2. Selecciona Aplicación web como el tipo de aplicación.
   3. Asegúrate de que el Token de actualización esté habilitado en la configuración de Tipo de concesión > Concesiones principales.
   4. Agrega https://integrations.miro.com/api/external-auth/oauth2/callback como las URIs de redirección de inicio de sesión.
   5. Selecciona Guardar.
2. Copia el ClientId y el Client Secret de la sección de Credenciales del cliente. Estos serán necesarios en las siguientes secciones para completar la configuración de la integración.

Configurar el inicio de sesión único (SSO)

Sigue estos pasos para configurar la aplicación:

1. Desde la página Aplicaciones & Integraciones, navega hasta Administrar aplicaciones.
2. Busca "Glean" en tu lista de aplicaciones instaladas y haz clic en sus Configuraciones. Si no ves la aplicación, búscala por el ID de cliente (1202342442818548396) y apruébala primero.
3. En la configuración, selecciona el proveedor de inicio de sesión único (SSO).
   1. Okta
   2. Azure
   3. Google
4. Introduce los detalles necesarios del SSO.
   1. Okta: URL de base de Glean, detalles de la app de Okta (URL del servidor de autenticación, URL del token de acceso, ID de cliente, Secreto de cliente).
   2. Azure: URL de base de Glean.
   3. Google: URL de base de Glean.
5. Haz clic en Guardar para aplicar la configuración.

✏️ Si estás utilizando Azure, asegúrate de que tu administrador de Microsoft Entra haya seleccionado "Consentir en nombre de tu organización" para la aplicación de Glean en el centro de administración de Microsoft Entra para permitir que los usuarios se autentiquen correctamente.

Configurar la consola de administración de Glean

Antes de usar Glean en Miro, necesitas configurar el acceso basado en token OAuth en tu consola de administración de Glean.

1. Abre tu consola de administración de Glean y navega a Configuración > Acceso de terceros (OAuth).
2. En la sección de OAuth configurado por IdP, habilita Habilitar OAuth de IdP para el acceso a API.
3. Haz clic en Administrar configuración, selecciona tu proveedor de SSO.
4. Completa los detalles del proveedor según tu proveedor de inicio de sesión único.
   • Okta
     • URL del servidor de autorización: https://<yourOktaDomain>/oauth2/v1/authorize
     • ID(s) de cliente permitido(s): ID de cliente de la aplicación Okta creada en la sección anterior.
     • El resto de los campos del formulario pueden quedar vacíos.
   • Azure
     • Subdominio del emisor: https://login.microsoftonline.com/<tenant-id>/v2.0
     • ID(s) de cliente permitido(s): a49fdb25-3b5f-4d3b-bedf-6da7be2b4bf4
   • GSuite
     • ID(s) de cliente permitido(s): 1062019541050-pf2ndc9f3o4lrmkupj3cj0fep5hkecns.apps.googleusercontent.com
5. Selecciona Guardar para aplicar la configuración.

⏰ Nota: Los cambios pueden tardar hasta 30 minutos en surtir efecto en el panel de administración de Glean.

Usar la app de Glean

Una vez que hayas instalado y configurado la app, los usuarios en los equipos designados pueden comenzar a usarla. La primera vez que un usuario abre la app de Glean en Miro, se le pedirá que se autentique.

1. Abre un tablero de Miro y haz clic en el ícono de Glean en la barra de herramientas para abrir el panel lateral.
2. Haz clic en Conectar Glean para iniciar la autorización.
3. Aparecerá un diálogo de autorización de inicio de sesión único.
4. Después de la autenticación exitosa, aparecerá la interfaz de usuario de Glean, lista para usarse.

Seguridad

Para obtener más información sobre datos y seguridad, consulta este documento de seguridad.