# Instalación de Power Embedded ### Qué es el proceso de instalación El proceso de instalación de **Power Embedded** consiste en la preparación y configuración del entorno de la organización para permitir la integración segura del portal con **Microsoft Azure** y **Power BI/Fabric**. Durante la instalación, se realizan configuraciones en **Azure**, en el **Portal de administración** **de Power BI/Fabric** y en los propios portales de Power Embedded. Estas configuraciones establecen los permisos necesarios para que el portal pueda acceder a los recursos del entorno y administrarlos, como **capacidades, workspaces, informes y modelos semánticos.** Todo el proceso se realiza en conjunto durante la reunión de instalación, con el acompañamiento del equipo responsable de Power Embedded. Para que la instalación se realice correctamente, es necesario garantizar la participación de **usuarios con los permisos administrativos adecuados en los entornos involucrados.** ### Requisitos previos: Durante la instalación, será necesaria la participación de: 1. **Azure Global Administrator:** responsable de las configuraciones necesarias en Azure, incluida la creación y configuración de la aplicación y del grupo de seguridad. 2. **Fabric Administrator:** responsable de las configuraciones administrativas en Power BI/Fabric y de la preparación de los workspaces y de la capacidad. 3. **Administrador de Power Embedded:** responsable de la configuración inicial del portal y de la creación de los primeros usuarios administradores. {% hint style="info" icon="message" %} **Importante:** se recomienda que los usuarios con los permisos necesarios estén disponibles durante toda la reunión de instalación. La ausencia de uno de estos permisos puede impedir la finalización de determinadas etapas del proceso. {% endhint %} ### Configuraciones en Azure: Las primeras etapas de la instalación se realizan en el **Portal de Azure** y deben ser ejecutadas por un usuario con permiso de **Azure Global Administrator.** Durante esta etapa, se realizarán las siguientes configuraciones:
1. **Crear una aplicación en Azure AD:** acceder al área de Registros de aplicaciones y crear la aplicación que Power Embedded utilizará para realizar la integración con el entorno. 2. **Crear un grupo en Azure AD:** crear un grupo de seguridad que se utilizará para controlar los permisos necesarios para la integración 3. **Agregar la aplicación al grupo:** agregar el Service Principal de la aplicación recién creada al grupo de seguridad. 4. **Crear la capacidad:** crear el recurso Power BI Embedded o Microsoft Fabric en Azure 5. **Conceder el rol Contributor:** agregar el Service Principal al rol Contributor en la capacidad creada. 6. **Conceder el rol Power BI Capacity Administrator:** agregar el Service Principal como Power BI Capacity Administrator de la capacidad 7. **Autorizar la aplicación en el Portal de administración:** acceder al [Portal de administración de Power Embedded](https://admin.powerembedded.com.br/) y autorizar la aplicación en la organización. En el primer acceso, se mostrará una ventana que solicita el consentimiento. Después de la autorización, deben crearse los primeros usuarios con perfil de Administrador. 8. **Autorizar la aplicación en el Portal de visualización:** acceder al [Portal de visualización de Power Embedded](https://relatorios.powerembedded.com.br/) y realizar la autorización de la aplicación en la organización. Al igual que en el Portal de administración, se mostrará una ventana emergente en el primer acceso que solicita el consentimiento. ### Configuraciones en el Portal de administración de Power BI/Fabric Después de las configuraciones en Azure, es necesario realizar algunas definiciones en el Portal de administración de Power BI/Fabric. Estas configuraciones deben ser ejecutadas por un usuario con permiso de Fabric Administrator. #### Configuraciones de inquilino Es necesario habilitar las configuraciones siguientes y permitir que el grupo de Azure AD creado durante la instalación utilice estas funcionalidades: 1. Insertar contenido en aplicaciones; 2. Las entidades de servicio pueden usar las API de Fabric; 3. Las entidades de servicio pueden acceder a las API de administrador de solo lectura; 4. Mejorar las respuestas de las API de administración con metadatos detallados; 5. Permitir puntos de conexión XMLA y analizar en Excel con modelos semánticos locales. Estas configuraciones permiten que Power Embedded realice las integraciones necesarias con el entorno de Power BI/Fabric. #### Configuración de los workspaces También es necesario preparar los workspaces que utilizará el portal. **En esta etapa, es posible:** 1. Asociar los workspaces existentes a la capacidad contratada o a la capacidad de evaluación (Trial); o 2. Crear nuevos workspaces para realizar una migración en paralelo. Una vez definidos los workspaces, el grupo de Azure AD creado durante la instalación deberá agregarse como administrador de los workspaces. #### Permisos para la administración de la capacidad Power Embedded cuenta con recursos que permiten a los administradores del portal administrar la capacidad directamente desde la plataforma. Entre las posibilidades están encender, apagar y cambiar el SKU de la capacidad, ya sea manualmente, bajo demanda o mediante una programación. Para utilizar estos recursos, es necesario conceder al Service Principal los permisos adecuados en la capacidad, mediante el Portal de Azure. **Los permisos son:** 1. **Contributor:** agregar el Service Principal al rol Contributor de la capacidad. 2. **Power BI Capacity Administrator:** agregar el Service Principal como Power BI Capacity Administrator de la capacidad. Para acceder al paso a paso de la administración de permisos, consulte [Permisos Azure](../../portal-de-administracion/power-bi/capacidades/permisos-en-azure.md). {% hint style="info" icon="message" %} **Importante:** los permisos de Contributor y Power BI Capacity Administrator son necesarios solo cuando la organización desea permitir que Power Embedded administre la capacidad. Si la administración de la capacidad la realiza directamente el administrador en Azure, estos permisos no son necesarios. {% endhint %} > _**Observación:** estas configuraciones son opcionales cuando la organización esté utilizando el Trial de Microsoft Fabric, según el escenario de administración adoptado._ #### Visión general del proceso: De forma resumida, el proceso de instalación puede dividirse en cuatro etapas: **1. Azure:**\ Creación y configuración de la aplicación, del grupo de seguridad y, cuando corresponda, de la capacidad. **2. Power BI/Fabric:**\ Configuración de los permisos de inquilino, preparación de los workspaces y asociación a la capacidad. **3. Power Embedded:**\ Autorización de la aplicación en los portales y configuración inicial de los administradores. **4. Administración de la capacidad — opcional**\ Concesión de los permisos necesarios en caso de que la organización quiera permitir que Power Embedded realice la administración de la capacidad.