Personas: admins de empresa, admins de equipo
Plataformas: Navegador, Escritorio
La integración de Box permite a los usuarios insertar archivos de Box en tableros de Miro. Esta guía cubre la implementación técnica de la integración, el modelo de seguridad y el manejo de datos para los admins que evalúan o configuran la integración.
Funciones principales
- Live Embed: Los usuarios pueden insertar contenido de Box en un tablero de Miro como un iframe en vivo.
- Secure: A cada visitante del tablero se le solicita iniciar sesión en el iframe antes de que pueda ver el contenido insertado.
- Display options: Los usuarios pueden elegir mostrar el contenido insertado como Live Embed o como un marcador.
- Focus mode: Los usuarios pueden ampliar un Live Embed o un marcador para verlo sin distracciones.
- Action shortcut: Los usuarios pueden agregar un atajo que abre un diálogo para insertar un enlace de Box.
Limitaciones
- El selector de activos no está disponible para esta integración.
Implementación técnica
Miro se integra con Box a través de la API REST de Box. Los usuarios autorizan el acceso con OAuth 2.0 y luego vinculan sus archivos de Box a un tablero de Miro.
Flujos de datos
- Un usuario que pertenece a un equipo u organización con esta función habilitada pega un enlace de Box en un tablero de Miro.
- Miro lee el enlace. Si el usuario aún no ha autorizado la integración, Miro inicia el flujo de OAuth y redirige al usuario a la página de autorización de Box.
- 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 Box y recuperar el contenido.
Qué datos de Box almacena Miro
Miro obtiene y almacena los siguientes datos de los enlaces de Box que se pegan:
- Títulos de documentos y archivos
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
Incrustar un enlace de Box en un tablero requiere que el usuario autorice la integración a través de la pantalla de consentimiento OAuth de Box. Según la configuración de Box del cliente, esto también puede requerir que un admin de Box apruebe la integración.
Alcances de autorización requeridos
La integración con Box requiere el siguiente alcance:
-
root_readonly— leer todos los archivos y carpetas almacenados en Box.
Qué 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 unfurling.
- Datos de autorización: Miro almacena el access token y el refresh token en su base de datos durante varios días. Mientras la autorización esté activa, Miro renueva automáticamente un access token vencido usando el refresh token, sin que el usuario tenga que volver a autorizar. Todos los datos almacenados para esta integración están cifrados en reposo con AES de 256 bits.
- Datos de unfurling: Miro almacena los títulos de los archivos como parte del tablero de Miro, y almacena títulos y referencias de imágenes cifrados en un servicio interno.
Revocar un token
Los usuarios pueden desconectar la integración de Box en cualquier momento desde la configuración de su cuenta de Box.
Configurar la integración de Box
NOTA: Solo los admin de equipo de Miro pueden instalar la aplicación. Si tu organización de Miro solo permite aplicaciones aprobadas y un usuario regular pega un enlace de Box, ese usuario verá en su lugar un cuadro de diálogo para solicitar la instalación de la aplicación.
Para instalar y empezar a usar la integración:
- Copia la URL del archivo de Box.
- Pega la URL en tu tablero de Miro.
-
Lo que sucede a continuación depende de quién pegó el enlace:
- Un admin de equipo de Miro pega el enlace: La app se autoriza e instala automáticamente y el enlace se despliega sin más acciones.
- Un usuario pega el enlace y la organización solo permite apps aprobadas: Se abre un cuadro de diálogo de solicitud de instalación de la app. Tras solicitar el permiso, los admins de empresa pueden seguir el Flujo de solicitud de la app para aprobar la solicitud.
Conectar una cuenta de Box
Después de que la integración esté instalada y autorizada:
- Haz clic en Conectar en el widget que se crea después de pegar la URL en el tablero. Serás redirigido a una página que te pedirá que concedas a Miro acceso a tu cuenta de Box.
- Introduce las credenciales de tu cuenta de Box y haz clic en Autorizar.
- Haz clic en Conceder acceso a Box para que Miro pueda acceder a tus archivos de Box.
Una vez establecida la conexión, tu archivo se inserta en el tablero con toda la funcionalidad de Box. Puedes comentar, anotar y revisar documentos directamente dentro del elemento insertado, y los cambios se reflejan en tiempo real para que tu equipo pueda colaborar sin salir del tablero.
CONSEJO: Abre la inserción en modo sin distracciones para ver e interactuar con el documento en una vista ampliada.
Preguntas frecuentes
¿Qué usuarios pueden insertar contenido de Box en Miro?
El usuario y el tablero de Miro deben cumplir ambos criterios:
- El usuario ha autorizado la integración Miro–Box.
- El usuario tiene acceso al contenido de Box que intenta insertar.
¿Qué usuarios pueden ver el contenido de Box insertado?
Cualquier persona que tenga acceso al tablero de Miro y permiso del propietario del contenido insertado —es decir, cualquiera con permisos de ver, comentar o editar en el tablero— puede verlo. Los visualizadores no necesitan autorizar la integración ni tener una licencia de Box para ver el contenido insertado en el tablero.
¿Deben los usuarios reautorizar la integración para pegar enlaces en otros tableros?
No, siempre que la autorización siga siendo válida (Miro considera que una autorización es válida durante un mes desde que se concede). Los usuarios pueden pegar enlaces de Box en cualquier tablero y el contenido se importa con normalidad.
Si el tablero pertenece a otro equipo u organización donde esta integración no está habilitada, el usuario no podrá usarla allí.
¿Puedo acceder en Miro a contenido de Box al que no tengo acceso directamente en Box?
No. Solo puedes insertar contenido de Box al que ya tengas acceso — no puedes usar la integración para ver algo que, de otro modo, no podrías abrir en Box. Dicho esto, si alguien con acceso ya insertó el contenido como imagen estática en un tablero que compartes con esa persona, puedes ver esa instantánea incluso sin acceso directo al archivo original. La integración no aplica políticas de acceso adicionales más allá de esto; utiliza la propia configuración de uso compartido del tablero de Miro para restringir quién puede colaborar. Ten en cuenta que una imagen estática no permite explorar los datos subyacentes, abrir el archivo original ni cambiar filtros.
¿Dónde puedo encontrar el Anexo de Procesamiento de Datos de Miro?
Consulta el Anexo de Procesamiento de Datos de Miro.
¿Qué está deshabilitado 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.
- Expansión directa de activos (activo en lugar de Live Embed) — compatible con la integración de Figma.