Personas: admins de empresa
La integración de Looker permite a los usuarios insertar paneles y Explores de Looker en tableros de Miro. Esta guía cubre la configuración, la implementación técnica de la integración, el modelo de seguridad y el manejo de datos para los admins de empresa que evalúan o configuran la integración.
Funciones principales
- Inserción en vivo: Los usuarios pueden insertar un panel o un Explore de Looker en un tablero de Miro como un iframe en vivo.
- Seguridad: A cada visitante del tablero se le solicita que inicie sesión en el iframe antes de que pueda ver el contenido insertado.
- Opciones de visualización: Los usuarios pueden elegir mostrar el contenido insertado como Live Embed o como marcador.
- Modo sin distracciones: Los usuarios pueden ampliar un Live Embed o un marcador al modo sin distracciones para verlo sin interrupciones.
- Atajo de acción: Los usuarios pueden agregar un atajo de acción que abre un cuadro de diálogo para insertar un enlace de Looker.
- Selector de activos: Los usuarios pueden agregar como imagen estática en el tablero un gráfico o una tarjeta específicos, para que los colaboradores puedan ver y consultar ese contenido exacto sin necesitar acceso al archivo de origen.
- Controles de admin: Los admins pueden impedir que los usuarios usen el selector de activos para agregar contenido de Looker como imágenes estáticas.
Limitaciones
- Looker Studio no es compatible.
- Los Looker Looks no son compatibles.
- No se admite insertar consultas merge de Looker ni enlaces a tableros de Looker.
- Las imágenes añadidas con el selector de activos no se pueden actualizar.
Problemas conocidos
Los usuarios que ya hayan iniciado sesión en un navegador o en la aplicación de escritorio de Miro pueden tener problemas de autenticación al cambiar a otro navegador o a la aplicación de Miro. Esto puede interrumpir el flujo de autenticación y el acceso a Looker.
Configura la integración de Looker
Requisitos previos
- Un admin de la compañía ha aprobado Looker para tu organización en Miro.
- Tienes acceso de admin en Looker para registrar a Miro como una aplicación OAuth.
Registrar la aplicación OAuth en Looker
- En el Marketplace de Looker, busca y selecciona API Explorer extension, luego selecciona Install.
- Ve a Home > Applications > API Explorer.
- En el cuadro de búsqueda del API Explorer, escribe
oauth, luego selecciona Register OAuth App bajo Auth. - Selecciona Run It en la esquina superior derecha de la página.
-
En el formulario de solicitud, ingresa los siguientes valores:
-
client_guid:
15609152-a12a-4fa1-b364-337e7896d25d -
body:
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Integración de Miro con Looker", "enabled": true, "group_id": "" } - Deja fields vacíos.
Para opciones más avanzadas —por ejemplo, restringir la autorización a un grupo específico de Looker con
group_id— consulta la documentación de Looker para registrar una aplicación OAuth (externo). -
client_guid:
- Seleccionar Entiendo que este extremo de API modificará datos.
- Seleccionar Ejecutar. Una ejecución exitosa devuelve el cuerpo de la solicitud y una respuesta HTTP 200.
Si el cuerpo devuelto incluye"enabled": false, ejecutar Actualizar aplicación OAuth con los mismos valores para habilitar el cliente.
Instalar y autorizar la integración en Miro
NOTA: Solo los admins de equipo de Miro pueden instalar la app. Si la organización de Miro solo permite apps aprobadas y un usuario pega un enlace de Looker, ese usuario verá en su lugar un cuadro de diálogo para solicitar la instalación de la app.
- Copia la URL del panel o del Explore de Looker.
- Pega la URL en tu tablero de Miro.
- Lo que ocurre a continuación depende de quién pegó el enlace:
- Un admin de equipo de Miro pega el enlace: La aplicación se autoriza e instala automáticamente y el enlace se despliega sin necesidad de acciones adicionales.
-
Un usuario normal pega el enlace y la organización solo permite aplicaciones aprobadas: Se abre un cuadro de diálogo para solicitar la instalación de la aplicación. Después de que el usuario solicite permiso, los admin de empresa pueden seguir el artículo Flujo de solicitud de apps para aprobar la solicitud.
Conectar una cuenta de Looker
Después de que la integración esté instalada y autorizada:
- Haz clic en Conectar en el widget creado después de pegar la URL en el tablero. Serás redirigido a una página que te pedirá que otorgues a Miro acceso a tu cuenta de Looker.
- Confirma la autorización en Looker. El contenido de Looker se agrega a tu tablero como un iframe.
Implementación técnica
Miro se integra con Looker a través de la API REST de Looker. Los usuarios autorizan el acceso con OAuth 2.0 y luego vinculan sus paneles o Explores de Looker a un tablero de Miro.
Consideraciones de seguridad
El selector de elementos de la integración permite a los usuarios adjuntar un gráfico o tile de Looker al lienzo como imagen estática. Solo los usuarios autorizados pueden acceder al Live Embed, pero cualquier persona con acceso al tablero puede ver la imagen estática adjunta. En los tableros públicos, la opción de agregar elementos desde inserciones está deshabilitada por defecto.
Los admins de la compañía pueden deshabilitar el selector de elementos para todos los tableros:
- Ve a Configuración de la compañía > Aplicaciones e integraciones > Aplicaciones > Unfurl Looker (en la pestaña Gestionar aplicaciones).
- Activa o desactiva Evitar que los usuarios agreguen elementos desde inserciones al lienzo.
Flujos de datos
- Un usuario que pertenece a un equipo u organización con esta función habilitada pega un enlace de Looker en un tablero de Miro.
- Miro lee el enlace. Si el usuario aún no ha autorizado la integración, Miro inicia el flujo OAuth y redirige al usuario a la página de autorización de Looker.
- Después de que el usuario otorga la autorización, el servicio de integración de Miro usa el token de acceso del usuario para llamar a la API REST de Looker y recuperar el contenido.
Qué datos de Looker almacena Miro
Miro recupera y almacena los siguientes datos de los enlaces de Looker pegados:
- Títulos de paneles y Explores
- Imágenes creadas por el selector de activos
Retención de datos
Los datos incrustados se rigen por la política estándar de retención de datos de Miro para todos los datos de clientes.
Autenticación y autorización
Insertar un enlace de Looker en un tablero requiere que el usuario autorice la integración mediante la API OAuth de Looker. Esto también requiere que un admin de Looker registre a Miro como una aplicación OAuth — consulta Registrar la aplicación OAuth en Looker arriba.
Alcances de autorización requeridos
La integración de Looker requiere el siguiente alcance:
apiQué se almacena en Miro y cómo
Miro almacena dos categorías de datos para esta integración: datos de autorización y datos de vista previa.
Datos de autorización: Miro almacena el token de acceso y el token de actualización en su base de datos durante varios días. Mientras la autorización esté activa, Miro renueva automáticamente un token de acceso vencido usando el token de actualización, sin requerir que el usuario vuelva a autorizar. Todos los datos almacenados para esta integración están cifrados en reposo con AES de 256 bits.
Datos de vista previa: Miro guarda dos tipos de datos de vista previa: las imágenes capturadas por el selector de activos (almacenadas como parte del tablero) y los títulos y referencias de imágenes (almacenados cifrados en un servicio interno).
Revocar un token
Los admins de Looker pueden revocar el acceso de la integración desde la consola de administración de Looker:
- Ve a Administración > Usuarios.
- Selecciona al usuario.
- Desplázate hasta Claves API y selecciona Eliminar junto al token.
Preguntas frecuentes
¿Cómo desactivo la integración?
Elimina la aplicación OAuth de Miro de Looker. Esto no elimina los datos de Looker que ya están insertados en los tableros de Miro, pero evita que los usuarios inserten contenido nuevo o actualicen los activos existentes.
¿Qué usuarios pueden insertar contenido de Looker en Miro?
El usuario y el tablero de Miro deben cumplir ambos criterios:
- El usuario ha autorizado la integración de Miro con Looker.
- El usuario tiene acceso al contenido de Looker que intenta insertar.
¿Qué usuarios pueden ver el contenido de Looker insertado?
Cualquier persona con acceso al tablero de Miro y con permiso por parte del propietario del contenido insertado — es decir, cualquiera que tenga permisos para ver, comentar o editar el tablero. Los visualizadores no necesitan autorizar la integración ni tener una licencia de Looker para ver el contenido insertado en el tablero.
¿Deben los usuarios volver a autorizar la integración para pegar enlaces en otros tableros?
No, siempre que la autorización siga siendo válida (Miro considera válida una autorización durante un mes desde que se concede). Los usuarios pueden pegar enlaces de Looker en cualquier tablero y el contenido se importa con normalidad.
Si el tablero pertenece a un equipo u organización diferente donde esta integración no está habilitada, el usuario no podrá usarla allí.
¿Puedo acceder desde Miro a contenido de Looker al que no tengo acceso directamente en Looker?
No. Solo puedes insertar contenido de Looker al que ya tienes acceso — no puedes usar la integración para ver algo que no podrías abrir directamente en Looker. Dicho esto, si alguien con acceso ya insertó el contenido como una imagen estática en un tablero que compartes con esa persona, podrás ver esa instantánea incluso sin tener acceso directo al archivo original. La integración no aplica ninguna política de acceso adicional más allá de esto; usa la configuración de uso compartido del tablero en Miro para restringir quién puede colaborar. Ten en cuenta que una imagen estática (instantánea) no permite explorar los datos subyacentes, abrir el gráfico original ni cambiar los filtros.
¿Dónde puedo encontrar el Anexo de Procesamiento de Datos de Miro?
Consulta el Addendum de Procesamiento de Datos de Miro.
¿Qué no se permite en los tableros públicos de Miro?
Por razones de seguridad, los tableros públicos deshabilitan:
- Extracción de activos — compatible con las integraciones de Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel y Microsoft PowerPoint.
- Previsualización directa del activo (activo en lugar de Live Embed) — compatible con la integración de Figma.
¿Cómo puedo restringir el acceso al tablero a las mismas personas que tienen acceso al archivo de origen?
La integración solo gestiona el acceso a los archivos desde el sistema de origen (Looker), no desde Miro. De forma predeterminada, esto no se aplica — para mantener este nivel de seguridad, los administradores de la organización de Miro deben deshabilitar el selector de activos en la configuración de administración de la aplicación (ver Consideraciones de seguridad).
Deshabilitar el selector de activos impide que el contenido de Looker se guarde como imágenes estáticas en un tablero de Miro, donde más tarde podría ser visto por personas que no tienen acceso a ese contenido en Looker (por ejemplo, si el tablero se comparte públicamente o con personas que no tienen acceso en el sistema de origen).