Actualización de token

Por qué expira el token

Cuando un usuario mantiene la pantalla abierta en un informe por más de 1 hora sin interactuar con él, este token de autenticación expira y, pasado ese tiempo, es posible que vea un mensaje de error "ClientError_TokenExpired".

Si el usuario ve este mensaje de error, la solución es muy simple: solo debe actualizar la página y el informe se cargará nuevamente.

El token de Power BI Embedded expira para mantener la seguridad y controlar quién puede acceder a los informes. Como permite un acceso temporal, la expiración evita que alguien siga usando el sistema si el token se comparte o se expone por accidente. Además, esta medida garantiza que, si hay cambios en los permisos o necesidad de bloquear un acceso, esto ocurra rápidamente, sin dejar brechas.

Por defecto, el token de la API de Power BI Embedded tiene una validez de 1 hora. Este tiempo está pensado para ser suficiente para una sesión de uso normal, pero lo bastante corto para evitar riesgos. Si es necesario seguir usando el sistema después de este período, la aplicación debe generar un nuevo token. Esto mantiene el acceso siempre actualizado y seguro.

Actualización automática de token

Power Embedded cuenta con una función que actualiza los tokens de acceso automáticamente cuando usted interactúa con el informe, como aplicar un filtro, cambiar de página del informe o hacer clic en un visual.

Sin embargo, si el usuario pasa más de 1 hora sin interactuar con el informe (ej.: informe en un televisor), el token puede expirar, mostrar el mensaje de error de token expirado y ser necesario actualizar la página.

Para resolver este problema, Power Embedded implementó la actualización de token temporizada.

Actualización de token temporizada

Para forzar la actualización temporizada del token de autenticación de Power Embedded, acceda a la página de Configuraciones.

En esta pantalla, tenemos la opción “Actualizar token cada” x minutos. Esta opción hará que Power Embedded fuerce la actualización del token en la cantidad de minutos seleccionada.

Si el usuario deja la pantalla abierta, sin interactuar con el informe, el token puede expirar. Configurar esta opción permite actualizar el token periódicamente, evitando desconexiones por expiración, incluso si el informe está inactivo.

Cómo configurar la actualización de token temporizada

1. Acceda al Portal de Administración.
2. Navegue a la página de Configuraciones.
3. Localice la opción “Actualizar token cada”.
4. Defina el intervalo de tiempo deseado y haga clic en Guardar.