# Migración

Para simplificar la configuración de Power Embedded, preparamos un script que automatiza el proceso de importación de usuarios, RLS e informes de Power BI a Power Embedded de forma simple y fácil.

## Requisitos

Para poder ejecutar el proceso de migración es importante tener habilitados los siguientes permisos:



<details>

<summary>Permiso de administrador del usuario de servicio</summary>

Este permiso debe estar habilitado en todos los workspaces que estarán disponibles en el portal.

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

<img src="https://docs.powerembedded.com.br/assets/app%201.png" alt="" data-size="original">

Haga clic en el botón “+ Agregar personas o grupos”

<img src="https://docs.powerembedded.com.br/assets/app%202.png" alt="" data-size="original">

Busque el nombre de la aplicación que se creó anteriormente (PowerEmbedded-App) y recuerde cambiar el nivel de acceso a “Administrador”. Después de eso, haga clic en el botón “Add”

<img src="https://docs.powerembedded.com.br/assets/app%203.png" alt="" data-size="original">



¡Listo! Ahora Power Embedded ya tiene acceso a este workspace. Repita esto para todos los Workspaces de los que desea importar informes.

</details>

<details>

<summary>Permisos de Lectura de API</summary>

Permisos para la importación de datos de Entra ID

Para poder importar datos de usuarios y grupos de Entra ID, es necesario asignar algunos permisos al Service Principal, creado en el Portal de Azure, que Power Embedded utiliza para comunicarse con su entorno.

En la pantalla de [Registro de aplicaciones](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps), busque el nombre de la aplicación creada (el nombre predeterminado es PowerEmbedded-App).

En la pantalla de la aplicación, haga clic en _API permissions_, en el menú lateral, y luego en _Add a Permission_.

<img src="https://docs.powerembedded.com.br/assets/sin%201%20small.png" alt="" data-size="original">

En la siguiente pantalla seleccione la opción de _Microsoft Graph_.

<img src="https://docs.powerembedded.com.br/assets/sinc%202%20small.png" alt="" data-size="original">



A continuación seleccione la opción de _Application permissions_.

<img src="https://docs.powerembedded.com.br/assets/sinc%20small%203.png" alt="" data-size="original">

En la siguiente pestaña, busque _Directory_ y seleccione la primera opción _Directory.Read.All_ y haga clic en _Add permissions_.

<img src="https://docs.powerembedded.com.br/assets/sinc%20small%204.png" alt="" data-size="original">

Para finalizar, basta con conceder el consentimiento del administrador haciendo clic en _Grant admin consent for_.

<img src="https://docs.powerembedded.com.br/assets/Screenshot%202024-10-29%20164709.png" alt="" data-size="original">

Listo, ahora podrá importar los usuarios y grupos de Azure AD (Entra ID) a Power Embedded.

</details>

## Instrucciones

Con los permisos debidamente habilitados, ahora solo debe seguir el paso a paso del proceso.

Vaya al portal de administración de Power Embedded, en el menú de migración, y siga estas etapas. En ese menú siga las instrucciones a continuación.

**Etapa 1:** Genere los tokens de acceso utilizando el botón a continuación y cópielos. El token generado será válido por solo 1 hora.

<figure><img src="https://docs.powerembedded.com.br/assets/image%20(382).png" alt=""><figcaption></figcaption></figure>

**Etapa 2:** Abra el script de PowerShell disponible en el enlace de esta página, cópielo y péguelo en la consola de PowerShell.

**Etapa 3**: Reemplace las variables del script por los respectivos valores

<figure><img src="https://docs.powerembedded.com.br/assets/image%20(383).png" alt=""><figcaption></figcaption></figure>

**ID de Cliente de Power BI**: Acceda al Portal de Administración de Power BI Embedded > Configuraciones > campo “ID de Cliente de Power BI”.

<figure><img src="https://docs.powerembedded.com.br/assets/image%20(384).png" alt=""><figcaption></figcaption></figure>

**Clave de API**: Acceda al Portal de Administración de Power BI Embedded > Configuraciones > campo “Clave de API” (haga clic en el ícono en rojo para generar la clave).

<figure><img src="https://docs.powerembedded.com.br/assets/image%20(385).png" alt=""><figcaption></figcaption></figure>

**Pbi Token:** Clave generada en el menú de migración

<figure><img src="https://docs.powerembedded.com.br/assets/pbi.png" alt=""><figcaption></figcaption></figure>

**Ad Token :** Clave generada en el menú de migración.

<figure><img src="https://docs.powerembedded.com.br/assets/ad.png" alt=""><figcaption></figcaption></figure>

Con los campos completados, ahora solo debe ejecutar el código en PowerShell.

<figure><img src="https://docs.powerembedded.com.br/assets/print%208.png" alt=""><figcaption></figcaption></figure>

Una vez finalizado el script, todos los informes, usuarios y RLS estarán importados en Power Embedded.