Compartir Dashboards

Esta guia muestra como compartir dashboards en la UI de Console, incluyendo:

• Enlace publico.
• Enlace restringido por correo.
• Embed para iframe.
• Modos de politica de filtro (open, locked, selectable, disabled) para filtros select y multi_select.

Tipos de Compartir

Tipo	Cuando usar
Enlace publico	Cualquier persona con URL puede acceder
Enlace con correo	Solo correos autorizados pueden acceder
Embed	El dashboard se renderiza dentro de otro producto

Flujo en la UI

1) Abrir dialogo de compartir

1. Abre un dashboard.
2. Haz clic en Compartir.
3. Completa el Nombre del compartir.

2) Definir acceso

• Si Acceso por correo esta vacio: compartir abierto/publico.
• Si agregas correos: el acceso requiere autenticacion externa por codigo.

3) Configurar politicas de filtros (opcional)

Para cada filtro candidato, elige un modo:

• open: el usuario puede elegir valores libremente.
• locked: valor fijo en este share.
• selectable: solo valores permitidos.
• disabled: el filtro no se puede usar en el share.

Opciones Dinamicas de multi_select

Cuando un filtro usa opciones dinamicas via SQL, las vistas compartidas/embed dependen de endpoints de opciones en runtime.

Si el filtro funciona en el dashboard interno pero falla en compartido/embed, verifica:

1. El tipo de filtro es select o multi_select.
2. La consulta dinamica del filtro ejecuta sin error.
3. La politica del share no bloquea el filtro.
4. En flujo portal por correo, context_id se envia correctamente.

Compartir por Correo

Cuando agregas correos en el dialogo:

1. Console crea/vincula un contexto de compartir.
2. El usuario externo recibe codigo de un solo uso por correo.
3. El portal compartido usa token share_access.

Quien Puede Compartir

Un usuario comun de Console no puede compartir dashboards solo por poder abrir el recurso. Necesita actions de share compatibles con lo que esta administrando:

Accion en UI/API	Permiso minimo
Abrir Compartir en un dashboard y crear/revocar enlaces	dashboards:share
Generar embed de dashboard	dashboards:share
Gestionar correos, miembros y share-contexts de dashboard	dashboards:share
Generar embed de visualizacion	visualizations:share
Gestionar contextos mixtos (dashboard + visualizacion)	dashboards:share y visualizations:share

Si falta el permiso, la UI no debe exponer el flujo y la API responde 403 FORBIDDEN.

Embed

En modo embed, configura:

• allowed_origins.
• hide_header.
• hide_controls.

Usa siempre la embed_url devuelta por la API.

Buenas Practicas

1. Define expiracion para shares sensibles.
2. Prefiere acceso por correo para datos confidenciales.
3. Usa selectable para limitar alcance de filtros.
4. En embed, define allowed_origins para reducir uso indebido.

Solucion de Problemas

Faltan opciones dinamicas del filtro

Prueba el endpoint de opciones segun el modo:

• Publico: /api/v1/public/shares/:token/filters/:filter_slug/options
• Portal/correo: /api/v1/share-portal/.../filters/:filter_slug/options?context_id=...
• Embed: /api/embed/d/:token/filters/:filter_slug/options

DB_QUERY_ERROR

La SQL del filtro dinamico fallo. Revisa SQL, conexion y parametros.

AUTH_REQUIRED

El enlace exige autenticacion externa. El usuario debe iniciar con correo/codigo antes de ejecutar.

FORBIDDEN

Al usuario interno le falta la action dashboards:share o visualizations:share requerida por el endpoint de compartir/embed.

Siguientes Pasos

• Guia de Integracion de Compartir (API)
• Guia de Integracion de Embed (API)
• Referencia de Compartir (API)