Para facilitar el proceso de instalación de Power Embedded, creamos este tutorial para ayudar a nuestros clientes a realizar la instalación de Power Embedded.
Requisitos previos para realizar la instalación
Como Power Embedded es un sistema en formato SaaS, no será necesario contratar ni administrar ningún servidor, aplicación o base de datos; solo se utiliza el software como un servicio.
Para configurar Power Embedded en su empresa, es necesario que se cumplan los siguientes requisitos previos antes de agendar la instalación:
- Cuenta de un usuario de Azure con permiso para crear la capacidad Fabric o Embedded.
- Cuenta de un usuario de Azure con permiso para crear grupos y registros de aplicaciones en Azure AD.
- Cuenta de un usuario de Azure que posea el rol “Fabric administrator” para acceder al portal de administración de Power BI.
Durante la reunión de instalación del sistema, realizada en conjunto con el cliente, es necesario que se disponga de un usuario con los permisos indicados arriba o de una persona del equipo del cliente, con esos permisos, que pueda compartir la pantalla y ejecutar las acciones según se le indique.
Cómo crear la aplicación de Power Embedded en Azure AD
Para registrar la aplicación que utilizará Power Embedded, deberá acceder a este enlace.
En la pantalla siguiente, haga clic en el botón “New registration".
Ahora, deberá elegir un nombre para la aplicación que se creará en Azure AD. El nombre queda a su criterio.
Después, haga clic en el botón “Register”, al final de la página.
Después de la creación, se le redirigirá a la pantalla de información general de este usuario.
Copie el valor del campo “Application (client) ID” y guárdelo en un bloc de notas. Esta clave deberá pegarse en el campo “ID de cliente de Power BI”, disponible en la configuración de la organización de Power Embedded.
Ahora, haga clic en la opción “Certificates & secrets” y, a continuación, haga clic en el botón “New client secret"
En la nueva pantalla, escriba una descripción para este secreto (según su preferencia) y seleccione la validez de este secreto.
Se sugiere seleccionar el plazo de 24 meses, para que solo sea necesario preocuparse por el vencimiento después de dos años. Una vez finalizado el plazo definido, el secreto expirará y el sistema dejará de funcionar, por lo que será necesario generar un nuevo secreto y actualizarlo en Power Embedded.
Ahora haga clic en el botón “Add”, al final de la página
Copie el campo “Value” generado, haciendo clic en el botón de copiar junto a esta clave.
Anote y guarde bien esta clave, pues será la ÚNICA vez que podrá verla. Si pierde esta clave, no será posible recuperarla: será necesario generar un nuevo secreto y actualizarlo en el sistema.
El valor resaltado y copiado deberá pegarse en el campo “Clave de acceso del cliente de Power BI”, de la pantalla de configuración de Power Embedded.
Sincronizar usuarios y grupos de Azure AD (Entra ID)
Para integrar Power Embedded con Azure AD (Entra ID) e importar los usuarios y grupos.
En la misma pantalla de registro de aplicaciones, haga clic en “API permissions” y en “Add a Permission”.
.png)
En la siguiente pantalla seleccione la opción “Microsoft Graph” y, a continuación, seleccione la opción “Application permissions”.
.png)
En la pestaña siguiente, busque “Directory”, seleccione la primera opción “Directory.Read.All” y haga clic en “Add permissions”.
.png)
Si desea utilizar un permiso con menos privilegios, puede otorgar únicamente los permisos "User.Read.All" y "Group.Read.All".
.png)
Para finalizar, solo debe conceder el consentimiento del administrador haciendo clic en “Grant admin consent for”.
.png)
¡Listo! Cuando termine las siguientes etapas, ya podrá importar los usuarios y grupos de Azure AD (Entra ID) a Power Embedded.
Agregar el usuario de Power Embedded a un nuevo grupo de AD
Para conceder permisos en el Portal de administración de Power BI al Service Principal que acaba de crear, es obligatorio que forme parte de un grupo de seguridad de Azure AD (Entra ID).
Para ello, acceda a este enlace y haga clic en el botón “New group”
Seleccione la opción “Security” en el campo “Group type” y escriba el nombre de su preferencia para este grupo que se está creando.
Haga clic en el enlace “Owners” y agregue a las personas que serán responsables de Power Embedded.
Haga clic en el enlace “No members selected” de la categoría “Members”
En la pantalla que se abre, escriba el nombre del Service Principal que creó para filtrar. Seleccione el Service Principal en la lista y haga clic en el botón “Select”, al final de la página.
Ahora que seleccionó el miembro que se agregará a este nuevo grupo, haga clic en el botón “Create”, al final de la página.
Cómo liberar los permisos necesarios en el Portal de administración de Power BI
Utilizando un usuario con permiso de administrador de Power BI, acceda a este enlace.
Desplácese por la página hasta encontrar la sección “Configuración de desarrollador” (o busque “api” en la barra de búsqueda de la derecha
Marque la opción “Las entidades de servicio pueden usar las API de Fabric”.
Por razones de seguridad, marque la opción “Especificar grupos de seguridad” en la sección “Aplicar a:” y seleccione el grupo de seguridad que creamos al comienzo de este tema (en mi caso, “PowerEmbedded-Group”
Haga clic en el botón “Aplicar”.
Desplácese un poco más abajo en la página y repita el mismo proceso para el elemento “Las entidades de servicio pueden acceder a las API de administrador de solo lectura” y “Mejorar las respuestas de las API de administración con metadatos detallados”, en la sección “Configuración de la API de administración”
Actualice la página y ahora la opción “Mejorar las respuestas de las API de administración con las expresiones DAX y mashup” quedará disponible para marcarse. Repita el mismo proceso para este permiso.
Aún en la categoría “Configuración de desarrollador”, o buscando “insertar” en la barra de búsqueda, marque la opción “Insertar contenido en aplicaciones” y agregue el grupo de seguridad que creó en el filtro “Grupos de seguridad específicos”, en la opción “Aplicar a”.
Si esta configuración ya está activada y permitida para toda la organización, que es el estándar de Power BI, puede dejarla así, siempre que el cliente esté de acuerdo. Cambiarla puede causar problemas en otros procesos, en caso de que estén utilizando algo que requiera este permiso
Busque ahora la palabra "Exportar" en la barra de búsqueda ubicada en la parte superior derecha de la pantalla.
Encuentre la sección "Configuración de uso compartido y exportación" y verifique que Power BI permita las exportaciones siguientes:
- Exportar a Excel (Usado por el menú "Exportar datos" en el visual)
- Exportar a .csv (Usado por el menú "Exportar datos" en el visual)
- Exportar informe como presentaciones de PowerPoint o documentos PDF (Botón Exportar)
- Exportar los informes como archivos de imagen (Botón Exportar)
Y por último, en la sección “Configuración de integración”, realice el mismo proceso para la configuración “Permitir puntos de conexión XMLA y analizar en Excel con modelos semánticos locales”, que sirve para permitir el listado de los roles de RLS de forma automática.
Si esta configuración ya está activada y permitida para toda la organización, que es el estándar de Power BI, puede dejarla así, siempre que el cliente esté de acuerdo. Cambiarla puede causar problemas en otros procesos, en caso de que estén utilizando algo que requiera este permiso
¡Listo! Ahora el Portal tiene acceso a su entorno de Power BI.
Primer acceso al Portal administrativo
Acceda al área administrativa del Portal mediante este enlace, con sesión iniciada con un usuario con permiso de “Administrador global de Azure”.
Se autenticará en su cuenta Microsoft y, tan pronto como termine de iniciar sesión, verá una pantalla de solicitud de permiso en su Azure AD.
Marque la opción “Consent on behalf of your organization” y haga clic en el botón “Accept”
¿Olvidó marcar la opción “Consent on behalf of your organization” o realizó la instalación con una cuenta que no era administradora?
Haga clic aquí para ver cómo liberar este permiso manualmente
Si accedió al portal de administración utilizando un usuario sin los permisos necesarios, es posible que la pantalla anterior no se le muestre y, en su lugar, aparezca la pantalla siguiente cuando usted u otro usuario intente iniciar sesión en el área administrativa
Si esto ocurre, deberá autorizar la aplicación de Power Embedded (powerportal.cloud) en nombre de la organización, utilizando un usuario con permisos globales en Azure AD.
Para ello, haga clic en el enlace “Enterprise Applications” de Azure AD (Entra ID
Localice y haga clic en la aplicación “powerportal.cloud”
Haga clic en el menú “Permisos” en el panel izquierdo y luego haga clic en el botón “Conceder consentimiento de administrador para …” y autorice la aplicación.
Después de confirmar los permisos, se le redirigirá al sistema y deberá crear la nueva organización.
En esta pantalla, podrá definir las siguientes configuraciones:
- Nombre: Es el nombre de su empresa. El sistema recuperará el nombre registrado en el Tenant de Azure, pero usted podrá cambiarlo en esta pantalla o más adelante, desde la página de configuración del sistema.
- ID de cliente de Power BI: Es el ID del Service Principal que se creará para integrar Power Embedded con su Azure Active Directory (explicaremos más sobre esto a continuación).
- Clave de acceso del cliente de Power BI: Es el secreto generado para el Service Principal (explicaremos más sobre esto a continuación).
- Dominio personalizado: Es el dominio de su empresa (sin www ni https). Este campo se utilizará para crear una URL de acceso personalizada a los informes (ej.: relatorios.suaempresa.com.br)
Con el Client ID y el Secret Value obtenidos al inicio de la instalación y guardados en un bloc de notas, se utilizarán ahora en la pantalla de configuración de la organización de Power Embedded.
Haga clic en el botón “Crear organización” y podrá comenzar a usar el Portal.
¿Cómo integrar el Portal con el workspace de Power BI?
Para poder importar los informes de Power BI a Power Embedded, será necesario realizar dos acciones en el workspace:
- Activar el período de evaluación de Fabric (si aún no lo hizo).
- Cambiar la capacidad del workspace a capacidad Fabric.
- Agregar el Service Principal creado (usuario de Power Embedded) como administrador de los workspaces de los que desea importar informes (puede ser más de 1).
Para activar el período de evaluación de Fabric, haga clic en su foto en el menú de Power B
Cabe recordar que solo seis personas por organización pueden iniciar la evaluación (trial) de Fabric y, una vez que el trial es activado por un usuario, no es posible reasignar esa capacidad a otra persona.
Para cambiar la capacidad del workspace a capacidad Premium (Fabric), acceda al workspace, haga clic en los 3 puntos y seleccione la opción “Configuración del workspace".
En la pantalla que se abre, haga clic en el menú “Premium”, luego elija la licencia “Embedded” y, en el campo “Modo de licencia”, seleccione el recurso “Evaluación”.
Haga clic en el botón “Aplicar”, más abajo
A partir de este momento, el workspace queda asociado a la capacidad Premium de Fabric. Si este recurso se pausa, el workspace quedará inaccesible, incluso al utilizar una cuenta Pro y acceder a él directamente desde el portal.
El último paso ahora es agregar el usuario del Service Principal al workspace.
Para agregar el Service Principal creado como administrador de un workspace, acceda al workspace, haga clic en los 3 puntos y seleccione la opción “Administrar acceso".
Haga clic en el botón “+ Agregar personas o grupos”.
Busque el nombre de la aplicación que se creó anteriormente (PowerEmbedded-App) y recuerde cambiar el nivel de acceso a “Administrador”. Después, haga clic en el botón “Add”
¡Listo! Ahora Power Embedded ya tiene acceso a este workspace. Repita este proceso para todos los workspaces de los que desee importar informes.